webnovel-write

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Chapter Writing Skill

网络小说章节撰写Skill

Project Root Guard（必须先确认）

项目根目录校验（必须先执行）

必须在项目根目录执行（需存在
```
.webnovel/state.json
```
）
若当前目录不存在该文件，先询问用户项目路径并
```
cd
```
进入
进入后设置变量：
```
$PROJECT_ROOT = (Resolve-Path ".").Path
```

必须在项目根目录执行（需存在
```
.webnovel/state.json
```
）
若当前目录不存在该文件，先询问用户项目路径并
```
cd
```
进入
进入后设置变量：
```
$PROJECT_ROOT = (Resolve-Path ".").Path
```

Default flow

默认流程

Context Agent → 创作任务书
写作 → 3000-5000字正文
审查 → 核心4个Checker
润色 → 修复问题
Data Agent → 提取数据
Git → 备份

Context Agent → 生成创作任务书
撰写 → 生成3000-5000字正文
审查 → 运行核心4个Checker
润色 → 修复问题
Data Agent → 提取数据
Git → 备份

Modes

运行模式

```
/webnovel-write
```
：标准流程（含核心4个Checker）
```
/webnovel-write --fast
```
：跳过 Step 2B，其余同标准
```
/webnovel-write --minimal
```
：跳过 Step 2B，仅运行 consistency + continuity + ooc（不产出追读力数据）

```
/webnovel-write
```
：标准流程（包含核心4个Checker）
```
/webnovel-write --fast
```
：跳过步骤2B，其余与标准流程一致
```
/webnovel-write --minimal
```
：跳过步骤2B，仅运行consistency、continuity和ooc检查（不生成追读力数据）

Step 1: Context Agent

步骤1：Context Agent

使用 Task 工具调用

context-agent

：

调用 context-agent，参数：
- chapter: {chapter_num}
- project_root: {PROJECT_ROOT}
- storage_path: .webnovel/
- state_file: .webnovel/state.json

缺失处理：大纲或 state.json 不存在时，提示用户先初始化。

要求：创作任务书必须包含“反派层级”（从大纲/章纲提取）。

使用 Task 工具调用

context-agent

：

调用 context-agent，参数：
- chapter: {chapter_num}
- project_root: {PROJECT_ROOT}
- storage_path: .webnovel/
- state_file: .webnovel/state.json

缺失情况处理：大纲或 state.json 不存在时，提示用户先初始化。

要求：创作任务书必须包含“反派层级”（从大纲/章纲提取）。

Step 1.5: Contract v2 Guidance 注入

步骤1.5：Contract v2 Guidance 注入

bash

python "${CLAUDE_PLUGIN_ROOT}/scripts/extract_chapter_context.py" --chapter {chapter_num} --project-root "{PROJECT_ROOT}" --format json

必须读取：
```
writing_guidance.guidance_items
```

推荐读取：

reader_signal

与

genre_profile.reference_hints

bash

python "${CLAUDE_PLUGIN_ROOT}/scripts/extract_chapter_context.py" --chapter {chapter_num} --project-root "{PROJECT_ROOT}" --format json

必须读取：
```
writing_guidance.guidance_items
```

推荐读取：

reader_signal

和

genre_profile.reference_hints

Step 2: 写作

步骤2：撰写

遵循三大原则：大纲即法律 / 设定即物理 / 新实体需记录。
输出纯正文到
```
正文/第{NNNN}章.md
```
。
章节内容需体现本章“反派层级”要求（无反派层级时标注“无”）。
开写前加载核心约束：

bash

cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/references/core-constraints.md"

场景写作与风格参考按需加载（见

references/workflow-details.md

）。

遵循三大原则：大纲即法律 / 设定即物理 / 新实体需记录。
输出纯正文到
```
正文/第{NNNN}章.md
```
。
章节内容需体现本章“反派层级”要求（无反派层级时标注“无”）。
开始撰写前加载核心约束：

bash

cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/references/core-constraints.md"

场景写作与风格参考按需加载（见

references/workflow-details.md

）。

Reference Loading Levels (strict, lazy)

参考内容加载级别（strict、lazy）

L0: 不加载额外参考，直到当前 step 明确。
L1: 仅加载本 step 的最小必需文件。
L2: 仅在触发条件满足时加载扩展参考。

L0: 不加载额外参考内容，直至当前步骤明确需要。
L1: 仅加载当前步骤所需的最小必要文件。
L2: 仅在满足触发条件时加载扩展参考内容。

L1 (minimum)

L1（最小加载）

Step 2 写作前：
```
references/core-constraints.md
```
Step 4 润色前：
```
references/polish-guide.md
```

步骤2开始撰写前：
```
references/core-constraints.md
```
步骤4润色前：
```
references/polish-guide.md
```

L2 (conditional)

L2（条件加载）

仅当 Step 1.5 需要风格/体裁细化时加载：

```
references/style-variants.md
```

.claude/references/reading-power-taxonomy.md

```
.claude/references/genre-profiles.md
```

references/writing/genre-hook-payoff-library.md

（电竞/直播文/克苏鲁优先）

仅当需要模板细节时加载：

```
references/workflow-details.md
```
```
references/writing/typesetting.md
```

仅当步骤1.5需要细化风格/体裁时加载：

```
references/style-variants.md
```

.claude/references/reading-power-taxonomy.md

```
.claude/references/genre-profiles.md
```

references/writing/genre-hook-payoff-library.md

（电竞/直播文/克苏鲁题材优先）

仅当需要模板细节时加载：

```
references/workflow-details.md
```
```
references/writing/typesetting.md
```

Step 3: 审查

步骤3：审查

默认核心4个 Checker：

```
consistency-checker
```
```
continuity-checker
```
```
ooc-checker
```
```
reader-pull-checker
```
（用于写入追读力数据）

关键章/卷末/用户明确要求：额外运行

```
high-point-checker
```
```
pacing-checker
```

审查汇总表格与审查指标 JSON 模板见

references/workflow-details.md

。

默认核心4个 Checker：

```
consistency-checker
```
```
continuity-checker
```
```
ooc-checker
```
```
reader-pull-checker
```
（用于写入追读力数据）

关键章节/卷末/用户明确要求时：额外运行

```
high-point-checker
```
```
pacing-checker
```

审查汇总表格与审查指标JSON模板请查看

references/workflow-details.md

。

Step 4: 润色

步骤4：润色

加载润色参考：

bash

cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/references/polish-guide.md"
cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/references/writing/typesetting.md"

先修复 critical/high，再处理 medium/low。

加载润色参考内容：

bash

cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/references/polish-guide.md"
cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/references/writing/typesetting.md"

优先修复critical（严重）和high（高优先级）问题，再处理medium（中等）和low（低优先级）问题。

Step 5: Data Agent

步骤5：Data Agent

使用 Task 工具调用

data-agent

：

调用 data-agent，参数：
- chapter: {chapter_num}
- chapter_file: "正文/第{NNNN}章.md"
- review_score: {overall_score from Step 3}
- project_root: {PROJECT_ROOT}
- storage_path: .webnovel/
- state_file: .webnovel/state.json

债务利息计算默认关闭，仅在开启债务追踪或用户明确要求时执行（见

references/workflow-details.md

）。

使用 Task 工具调用

data-agent

：

调用 data-agent，参数：
- chapter: {chapter_num}
- chapter_file: "正文/第{NNNN}章.md"
- review_score: {步骤3的整体评分}
- project_root: {PROJECT_ROOT}
- storage_path: .webnovel/
- state_file: .webnovel/state.json

债务利息计算默认关闭，仅在开启债务追踪功能或用户明确要求时执行（详情见

references/workflow-details.md

）。

Step 6: Git 备份

步骤6：Git 备份

bash

git add . && git commit -m "Ch{chapter_num}: {title}"

bash

git add . && git commit -m "Ch{chapter_num}: {title}"

详细流程与模板（按需加载）

需要以下内容时，读取：

```
references/workflow-details.md
```
- Step 1.5 章节设计（钩子/爽点/微兑现/差异化）
- 审查汇总表格 + 审查指标 JSON 模板
- 润色硬规则 + 检查清单
- 债务/Override 处理与利息开关

Step 1.5 需要时可直接加载（避免深层引用）：

```
references/style-variants.md
```

.claude/references/reading-power-taxonomy.md

```
.claude/references/genre-profiles.md
```

需要以下内容时，读取对应文件：

```
references/workflow-details.md
```
- 步骤1.5 章节设计（钩子/爽点/微兑现/差异化）
- 审查汇总表格 + 审查指标JSON模板
- 润色硬性规则 + 检查清单
- 债务/Override 处理与利息开关

步骤1.5需要时可直接加载以下文件（避免深层引用）：

```
references/style-variants.md
```

.claude/references/reading-power-taxonomy.md

```
.claude/references/genre-profiles.md
```