Chapter Writing Skill

Project Root Guard（必须先确认）

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

Default flow

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

Modes

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

Step 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 不存在时，提示用户先初始化。

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

Step 1.5: Contract v2 Guidance 注入

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: 写作

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

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

场景写作与风格参考按需加载（见 references/workflow-details.md）。

Reference Loading Levels (strict, lazy)

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

L1 (minimum)

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

L2 (conditional)

• 仅当 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

Step 3: 审查

默认核心4个 Checker：

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

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

• high-point-checker
• pacing-checker

审查汇总表格与审查指标 JSON 模板见 references/workflow-details.md。

Step 4: 润色

加载润色参考：

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

使用 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）。

Step 6: Git 备份

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