// Writes webnovel chapters (3000-5000 words) using v5.1 dual-agent architecture. Context Agent gathers context, writer produces pure text (no XML tags), review agents report issues, polish fixes problems, Data Agent extracts entities with AI.
| name | webnovel-write |
| description | Writes webnovel chapters (3000-5000 words) using v5.1 dual-agent architecture. Context Agent gathers context, writer produces pure text (no XML tags), review agents report issues, polish fixes problems, Data Agent extracts entities with AI. |
| allowed-tools | Read Write Edit Grep Bash Task |
⚠️ 强制要求: 开始写作前，必须复制以下清单到回复中并逐项勾选。跳过任何步骤视为工作流不完整。
章节创作进度 (v5.1)：
- [ ] Step 1: Context Agent 搜集上下文
- [ ] Step 2: 生成章节内容 (纯正文，3000-5000字)
- [ ] Step 3: 审查 (7个Agent并行，输出汇总表格)
- [ ] Step 3.5: 自动修复循环 (仅当 critical/high > 0 时触发)
- [ ] Step 4: 最终润色 (AI痕迹检测 + 自然化 + 排版)
- [ ] Step 5: Data Agent 处理数据链
- [ ] Step 6: Git 备份
工作流规则:
调用 Context Agent:
使用 Task 工具调用 context-agent subagent：
调用 context-agent，参数：
- chapter: {chapter_num}
- project_root: {PROJECT_ROOT}
- storage_path: .webnovel/
- state_file: .webnovel/state.json
Agent 自动完成:
输出：上下文包 JSON，包含：
core: 大纲、主角快照、最近摘要scene: 地点上下文、出场角色、紧急伏笔global: 世界观骨架、力量体系、风格样本rag: 语义检索召回的相关场景alerts: 关键风险提示（如消歧警告/待确认项）失败处理：
字数: 3000-5000 字
核心原则:
加载核心约束:
cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/references/core-constraints.md"
按需加载场景参考:
| 场景类型 | 判断条件 | 执行命令 |
|---|---|---|
| 战斗戏 | 大纲含打斗/对决/追逐 | cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/references/writing/combat-scenes.md" |
| 情感戏 | 大纲含告白/冲突/羁绊 | cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/references/writing/emotion-psychology.md" |
| 对话密集 | 预估对话 >50% | cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/references/writing/dialogue-writing.md" |
| 复杂场景 | 新地点/大场面描写 | cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/references/writing/scene-description.md" |
| 欲念描写 | 大纲含暧昧/亲密/情欲场景 | cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/references/writing/desire-description.md" |
强制加载题材风格 prompt（根据 state.json 中的 genre 字段自动选择）:
# ⚠️ 必须加载！题材风格 prompt 是防止氛围跑偏的核心锚定
# 从 state.json 读取 genre 字段，加载对应题材的 writer.md
cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/prompts/genres/{genre}/writer.md"
# 如果有子风格(substyle)，同时加载子风格 prompt
# cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/prompts/genres/{genre}/substyles/{substyle}.md"
可用题材: xuanhuan(玄幻)、dog-blood-romance(狗血言情)、period-drama(古言)、realistic(都市现实)、zhihu-short(知乎短篇)、rules-mystery(规则怪谈)、dark(黑暗题材)
⚠️ 如果未加载题材风格 prompt，写作步骤视为无效。 题材 prompt 包含该题材的氛围基调、对话风格、禁词表等关键约束，缺失会导致风格跑偏。
输出格式:
正文/第{NNNN}章.md⚠️ 强制要求: 必须在同一条消息中并行调用全部 7 个 Agent。缺少任何一个视为步骤未完成，禁止进入 Step 4。
执行命令（不可修改）:
在一条消息中发送 7 个 Task 工具调用，每个调用需传入以下公共参数：
| # | subagent_type | 必须 | 说明 |
|---|---|---|---|
| 1 | high-point-checker | ✅ | 爽点密度检查 |
| 2 | consistency-checker | ✅ | 设定一致性检查 |
| 3 | pacing-checker | ✅ | Strand 节奏检查 |
| 4 | ooc-checker | ✅ | 人物 OOC 检查（强化版） |
| 5 | continuity-checker | ✅ | 连贯性检查 |
| 6 | anti-ai-detector | ✅ | AI痕迹检测 |
| 7 | dialogue-reality-enforcer | ✅ | 对话真实性强制检查 |
验证: 收到全部 7 份报告后，必须输出以下汇总表格：
┌─────────────────────────────────────────────────┐
│ 审查汇总 - 第 {chapter_num} 章 │
├─────────────────────┬───────────┬───────────────┤
│ Agent │ 结果 │ 关键问题数 │
├─────────────────────┼───────────┼───────────────┤
│ high-point-checker │ PASS/FAIL │ {N} │
│ consistency-checker │ PASS/FAIL │ {N} │
│ pacing-checker │ PASS/FAIL │ {N} │
│ ooc-checker │ PASS/FAIL │ {N} │
│ continuity-checker │ PASS/FAIL │ {N} │
│ anti-ai-detector │ PASS/FAIL │ {N} │
│ dialogue-reality-enforcer │ PASS/FAIL │ {N} │
├─────────────────────┴───────────┴───────────────┤
│ critical issues: {N} | high issues: {N} │
│ 是否可进入润色: {是/否} │
└─────────────────────────────────────────────────┘
审查后处理规则:
根据汇总表格中的 critical/high issues 数量，决定下一步：
| 情况 | 下一步 |
|---|---|
| critical = 0 且 high = 0 | → 直接进入 Step 4 最终润色 |
| critical > 0 或 high > 0 | → 进入 Step 3.5 自动修复循环 |
medium/low 问题不触发修复循环，留到 Step 4 润色时顺带处理。
⚠️ 核心原则: 主要问题（high）和严重问题（critical）必须修好才能继续。修不好就重写。
Phase A: 针对性修订（最多 2 轮）
└→ 针对具体问题段落修改，不重写整章
└→ 每轮修订后，重新调用 FAIL 的 Agent 验证
└→ critical/high 清零 → 跳到 Step 4
Phase B: 深度润色重写（最多 2 轮）
└→ 加载 polish-guide.md，对问题区域深度改写
└→ 每轮润色后，重新调用 FAIL 的 Agent 验证
└→ critical/high 清零 → 跳到 Step 4（跳过 4.1，直接从 4.2 开始）
Phase C: 整章重新生成（最多 1 次）
└→ 保留 Step 1 的上下文包，回到 Step 2 重新写
└→ 重新走完整 Step 3 审查（7个Agent全跑）
└→ 如果仍有 critical/high → 记录 deviation，强制进入 Step 4
每轮执行:
┌─────────────────────────────────────────────────┐
│ 修订轮次 A-{round} - 第 {chapter_num} 章 │
├─────────────────────────────────────────────────┤
│ 修改内容: {简述修改了哪些段落/问题} │
│ 重新审查 Agent: {列出重跑的Agent名} │
│ 剩余 critical: {N} | 剩余 high: {N} │
│ 结果: {已解决/升级到Phase B} │
└─────────────────────────────────────────────────┘
每轮执行:
cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/references/polish-guide.md"
┌─────────────────────────────────────────────────┐
│ 润色轮次 B-{round} - 第 {chapter_num} 章 │
├─────────────────────────────────────────────────┤
│ 改写范围: {简述改写了哪些场景/段落} │
│ 重新审查 Agent: {列出重跑的Agent名} │
│ 剩余 critical: {N} | 剩余 high: {N} │
│ 结果: {已解决/升级到Phase C} │
└─────────────────────────────────────────────────┘
⚠️ 经过 2 轮修订 + 2 轮润色仍有 critical/high 问题未解决
→ 决定：保留上下文包，回到 Step 2 重新生成整章
→ 未解决问题: {列出}
┌─────────────────────────────────────────────────┐
│ 重新生成结果 - 第 {chapter_num} 章 │
├─────────────────────────────────────────────────┤
│ 剩余 critical: {N} | 剩余 high: {N} │
│ 结果: {已解决/记录deviation强制继续} │
└─────────────────────────────────────────────────┘
| 阶段 | 最大轮次 | 累计审查次数 |
|---|---|---|
| Phase A 修订 | 2 轮 | 2 |
| Phase B 润色 | 2 轮 | 2 |
| Phase C 重写 | 1 次 | 1 |
| 合计 | 最多 5 次额外审查 |
超过上限后强制记录 deviation 继续，绝不死循环。
⚠️ 强制要求: 必须按以下顺序执行全部子步骤（4.0-4.5），不可跳过。
执行命令（不可跳过）:
cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/references/polish-guide.md"
cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/references/writing/typesetting.md"
如果未执行以上命令，视为润色步骤无效。
如果经过 Step 3.5 Phase B 深度润色已解决所有 critical/high 问题，直接从 4.2 开始。
根据 Step 3 汇总表格中的 issues 列表针对性修改：
| 严重度 | 处理方式 |
|---|---|
| critical | 必须修复，否则记录 deviation |
| high | 优先修复 |
| medium | 建议修复 |
| low | 可选修复 |
| 问题类型 | 修复方式 |
|---|---|
| OOC | 调整角色言行，符合人设 |
| POWER_CONFLICT | 修改能力描述，符合当前境界 |
| TIMELINE_ISSUE | 调整时间线描述 |
| PACING_IMBALANCE | 调整 Strand 比例 |
| LOW_COOL_POINTS | 增加爽点密度 |
使用 Grep 工具检测以下关键词:
| 类型 | 关键词模式 | 警戒线 | 目标值 |
|---|---|---|---|
| 总结词 | 综合|总之|由此可见|总而言之 | > 1次/1000字 | 0次 |
| 列举结构 | 首先|其次|最后|第一|第二|第三 | > 0.5次/1000字 | 0次 |
| 学术词 | 而言|某种程度上|本质上 | > 3次/1000字 | < 1次 |
| 因果连词 | 因为|所以|由于|因此 | > 5次/1000字 | < 3次 |
如超标，必须修改后重新检测。
| 指标 | 不达标 | 达标 |
|---|---|---|
| 停顿词 | < 0.5次/500字 | 1-2次/500字 |
| 不确定表达 | 0次 | ≥ 2次/章 |
| 短句占比 | < 20% | 30-50% |
| 口语词 | 0次/1000字 | ≥ 2次/1000字 |
自然化检测（必须执行）：
嗯\|这个\|那什么\|怎么说呢大概\|应该\|似乎\|好像咋回事\|得了\|行吧\|算了。！？ 分句），≤25 字视为短句，目标 30-50%排版检查（必须执行）（见 typesetting.md）：
润色完成后，必须输出以下检查清单：
┌─────────────────────────────────────────────────┐
│ 润色检查清单 - 第 {chapter_num} 章 │
├─────────────────────────────────────────────────┤
│ [x] polish-guide.md 已加载 │
│ [x] typesetting.md 已加载 │
│ [x] critical issues 已修复: {是/否/无} │
│ [x] high issues 已修复: {是/否/无} │
├─────────────────────────────────────────────────┤
│ AI痕迹检测: │
│ - 总结词: {N}次 {达标/超标} │
│ - 列举结构: {N}次 {达标/超标} │
│ - 学术词: {N}次 {达标/超标} │
│ - 因果连词: {N}次 {达标/超标} │
├─────────────────────────────────────────────────┤
│ 自然化检测: │
│ - 停顿词: {N}次 {达标/偏少/偏多} │
│ - 不确定表达: {N}次 {达标/偏少} │
│ - 口语词: {N}次 {达标/偏少} │
│ - 短句占比: {X}% {达标/偏低/偏高} │
├─────────────────────────────────────────────────┤
│ [x] 未违反润色红线 │
│ 是否可进入 Data Agent: {是/否} │
└─────────────────────────────────────────────────┘
Only proceed to Step 5 when:
输出: 润色后的章节文件（覆盖原文件）
调用 Data Agent:
使用 Task 工具调用 data-agent subagent：
调用 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
Agent 自动完成:
AI 实体提取（Agent 内置，无需外部 LLM）
实体消歧
写入存储
AI 场景切片
向量嵌入
风格样本评估
输出:
{
"entities_appeared": 5,
"entities_new": 1,
"state_changes": 2,
"scenes_chunked": 4,
"uncertain": [...],
"warnings": [...]
}
git add . && git commit -m "Ch{chapter_num}: {title}"
章节末尾追加：
---
## 本章摘要
**剧情**: {主要事件}
**人物**: {角色互动}
**状态变化**: {实力/位置/关系}
**伏笔**: [埋设] / [回收]
**承接点**: {下章衔接}
**压扬比例**: 压{X}扬{Y} ({genre}类型标准)
⚠️ 上下文包生成失败
→ 检查大纲是否存在
→ 检查 state.json 是否初始化
→ 手动加载必要上下文后继续
⚠️ 审查发现 critical/high 级别问题
→ 自动进入 Step 3.5 修复循环
→ Phase A 修订(2轮) → Phase B 润色(2轮) → Phase C 重写(1次)
→ 超过上限仍未解决 → 记录 deviation，强制继续
⚠️ AI 提取失败
→ 记录 warning
→ 可选：手动添加关键实体
→ Git 备份仍然执行
章节完成后，必须输出最终验证报告：
┌─────────────────────────────────────────────────┐
│ 章节完成验证 - 第 {chapter_num} 章 │
├─────────────────────────────────────────────────┤
│ 1. [x] 字数: {N}字 (3000-5000) │
│ 2. [x] 大纲执行: 100% │
│ 3. [x] 审查Agent: 5/5 已调用 │
│ 4. [x] 审查汇总表格: 已输出 │
│ 5. [x] polish-guide.md: 已加载 │
│ 6. [x] AI痕迹检测: 已执行 │
│ 7. [x] 润色检查清单: 已输出 │
│ 8. [x] Data Agent: 成功提取 {N} 个实体 │
│ 9. [x] Git: 已提交 ({commit_hash}) │
├─────────────────────────────────────────────────┤
│ 最终状态: {成功/有deviation} │
└─────────────────────────────────────────────────┘
验证失败处理:
Initializes webnovel projects with settings, outline framework, and state.json. Supports quick/standard/deep modes. Activates when user wants to start a new novel or /webnovel-init.
Plans detailed volume outlines with chapter-by-chapter breakdown, cool-point distribution, and Strand Weave pacing. Activates when user requests outline planning or /webnovel-plan.
Queries project settings for characters, powers, factions, items, and foreshadowing. Supports urgency analysis and golden finger status. Activates when user asks about story elements or /webnovel-query.
Recovers interrupted webnovel tasks with precise workflow state tracking. Detects interruption point and provides safe recovery options. Activates when user wants to resume or /webnovel-resume.
Reviews chapter quality using 5 specialized checkers and generates comprehensive reports. Activates when user requests chapter review or /webnovel-review.