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。

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；不产出追读力数据

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

L0：不提前加载参考。
L1：只加载当前步骤的最小必需文件。
L2：仅在触发条件满足时加载扩展参考。

L1 最小集合

Step 2A 前：references/core-constraints.md
Step 4 前：references/polish-guide.md

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

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}/skills/webnovel-write/references/core-constraints.md"

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

仅做风格转译，不改剧情事实。
细则见：references/workflow-details.md、references/style-adapter.md。

Step 3：审查

调用约束：

必须使用 Task 工具调用各审查 subagent，禁止主流程直接内联“自审”替代。
可并行发起审查 Task，全部返回后统一汇总 issues/severity/overall_score。

默认核心 4 审查器：

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

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

high-point-checker
pacing-checker

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

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；若最小模式未产出则传 0 并在 notes 标注 minimal mode。
债务利息默认关闭，仅在用户明确要求或开启追踪时执行（详见 references/workflow-details.md）。

Step 6：Git 备份

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

4. 最小交付检查

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

5. 参考入口

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

SKILL.md 4.7 KB تاريخچه خام