name: webnovel-write description: Writes webnovel chapters (3000-5000 words). Use when the user asks to write a chapter or runs /webnovel-write. Runs context, drafting, review, polish, and data extraction.

allowed-tools: Read Write Edit Grep Bash Task

Chapter Writing Skill

0. 项目根校验（必须）

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

0.5 工作流断点（best-effort，不得阻断主流程）

目标：让 /webnovel-resume 能基于真实断点恢复。即使 workflow_manager 出错，也只记录警告，写作继续。

1. 模式定义

模式	启用步骤	说明
`/webnovel-write`	Step 1 → 1.5 → 2A → 2B → 3 → 4 → 5 → 6	标准流程
`/webnovel-write --fast`	Step 1 → 1.5 → 2A → 3 → 4 → 5 → 6	跳过 Step 2B
`/webnovel-write --minimal`	Step 1 → 1.5 → 2A → 3(仅3个基础审查) → 4 → 5 → 6	跳过 Step 2B；不产出追读力数据

References（按步骤导航）

Step 2A（必读，写作硬约束）：core-constraints.md
Step 4（必读，润色规则）：polish-guide.md
Step 4（必读，排版规范）：typesetting.md
Step 1.5（可选，题材/风格/钩子细化）：style-variants.md
Step 1.5（可选，题材/风格/钩子细化）：reading-power-taxonomy.md
Step 1.5（可选，题材/风格/钩子细化）：genre-profiles.md
Step 1.5（可选，电竞/直播文/克苏鲁钩子库）：genre-hook-payoff-library.md
Step 2B（可选，风格适配细则）：style-adapter.md
Step 3（可选，审查指标 JSON 结构/流程细则）：workflow-details.md

2. 引用加载策略（严格按需）

L0：不提前加载参考。
L1：执行某个 Step 前，只加载 References 区该 Step 的“必读”条目。
L2：仅在触发条件满足时加载 References 区该 Step 的“可选”条目。

3. 执行步骤

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 缺失时，明确提示先初始化。
任务书必须包含“反派层级”（无则标注“无”）。

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 2A：正文起草

遵循三原则：大纲即法律 / 设定即物理 / 发明需识别。
输出纯正文：正文/第{NNNN}章.md

开写前加载：

cat "${CLAUDE_PLUGIN_ROOT}/references/shared/core-constraints.md"

Step 2B：风格适配（`--fast` / `--minimal` 跳过）

仅做风格转译，不改剧情事实。
执行前加载（按需，若本章需要强网文化/去AI化处理则必读）：
```
cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/references/style-adapter.md"
```

Step 3：审查

调用约束：

必须使用 Task 工具调用各审查 subagent，禁止主流程直接内联“自审”替代。
可并行发起审查 Task，全部返回后统一汇总 issues/severity/overall_score。
审查汇总后必须将审查指标写入 index.db.review_metrics（包括 --minimal 模式）。

默认核心 4 审查器：

consistency-checker
continuity-checker
ooc-checker
reader-pull-checker

关键章/卷末/用户明确要求时追加：

high-point-checker
pacing-checker

--minimal 模式仅运行前三个基础审查器，不产出追读力数据。

审查指标落库（必做）：

python -m data_modules.index_manager save-review-metrics --data '{...}' --project-root "${PROJECT_ROOT}"

说明：--minimal 可只包含 3 维 dimension_scores（设定一致性/人物塑造/连贯性），但必须给出 overall_score。JSON 结构见 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。
这里执行去AI化与毒点规避规则（见 polish-guide.md）。

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

review_score 必须使用 Step 3 汇总后的 overall_score（--minimal 也必须产出）。
债务利息默认关闭，仅在用户明确要求或开启追踪时执行（详见 workflow-details.md）。

Step 6：Git 备份

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

4. 最小交付检查

正文文件已生成（章节编号正确）。
审查已执行（模式对应的最小集合）。
润色已处理 critical/high。
data-agent 已回写状态与索引。
Git 备份成功或已说明失败原因。

5. 参考入口

执行模板与细节统一以 workflow-details.md 为准。
写作硬约束以 ${CLAUDE_PLUGIN_ROOT}/references/shared/core-constraints.md 为准。
润色规则以 polish-guide.md 为准。

SKILL.md 6.8 KB История Исходник