| name | fiction-write |
| description | 正文写作 + 章节修改。写作支持 Normal（标准四步）和 Deep（完整六步+底本同步+data-agent）双模式；修改支持 Re-craft（大改，自动传播）和 Rewrite（重写，全链路刷新）两种内建模式。Polish 模式请走 fiction-polish。
系统自动检测模式并提示用户确认。每章写完自动检测里程碑节点弹出建议。
写作前自动检查章纲是否存在，不存在则阻断。
触发方式：/fiction-write {章号}、「写第X章」「续写」「继续写」「日更」「下一章」「接着写」「开始写」。
|
fiction-write：正文写作
每章产出一节可发布的正文，写入 正文/第{章号}章-{标题}.md。
默认字数目标依据题材和细纲确定（番茄平台建议 2000-3000 字/章）。
双模式设计
| 模式 | 适用场景 | 耗时 |
|---|
| Normal | 常规推进章 | ~30-40 分钟/章 |
| Deep | 第 1 章/卷首/卷末/高潮章/里程碑章 | ~60-90 分钟/章 |
自动模式检测
写每章前系统自动判断：
| 条件 | 推荐模式 |
|---|
| 本章是第 1 章 | Deep |
| 本章是某卷的第 1 章 | Deep |
| 本章是某卷的最后 2 章 | Deep |
| 本章是第 10/20/30... 章（里程碑） | Deep |
章纲标记了 climax: true / is_reversal: true | Deep |
章纲标记了 mode: deep | Deep |
| 以上都不是的常规章 | Normal |
交互示例：
📌 检测到本章是开篇第一章。
建议使用 Deep 深度模式，以确保：
· 留下完整的底本基线
· 审查报告与 metrics 落库
· 提取初始事实供后续查询（LLM 直接执行）
本次使用 Deep 模式？[Y/n]
用户可拒绝（n 切换到 Normal）或确认。
前置检查
export PROJECT_ROOT="$(python -X utf8 "${SCRIPTS_DIR}/fiction.py" --project-root "${CODEX_PROJECT_DIR:-${CLAUDE_PROJECT_DIR:-$PWD}}" where)"
检查一：是否已开书
检查 state.json.progress.writing_started。未开书则阻断：
⚠️ 还没正式开书，不能写正文。
先运行 fiction-start 完成开书流程。
检查二：本章细纲是否存在
检查 大纲/第{卷号}卷/详细大纲.md 中是否包含本章章节。
不存在则阻断：
⚠️ 第 X 卷的细纲还没做到第 N 章。
先规划：fiction-plan {卷号}
检查三：本章是否已有正文
检查 正文/第{章号}章-*.md 是否存在。
存在则提示：本章已有正文，是否覆盖？[Y/n]
Normal 模式流程
Step 1: 加载上下文
│ 读取章纲目标（核心事件/情绪目标/爽点/禁区）
│ 读取最近 3 章摘要
│ 读取活跃伏笔
│ 加载本回涉及的设定卡
│ 确认情绪目标 ❮一句话❯
│
Step 2: 起草正文
│ 自动加载对应题材的写作公式（内置参考或引用 story 系列的 references）
│ 如有拆文结果，自动引用最相关段落作为参考
│ agent 起草 + 字数验证（番茄平台建议 2000-3000 字）
│
Step 3: reviewer 审查
│ 返回结构化 JSON:
│ blocking: [] # 阻断问题，必须修复
│ suggestions: [] # 非阻断建议
│ blocking 定点修复，用户裁决无法修复的项
│
Step 4: 去 AI 味 + 格式规范 + 提交
│ 4a: banned-words 扫描（一级词替换/二级词按语境判断）
│ 4b: AI 腔模式检测（对称句/判断句/过度副词）
│ 4c: 人工化改写（拆长句/抽象替换/对话潜台词化/标点去模板化）
│ 4d: 格式规范化（引号统一、断句、标点）
│ 4e: precommit gate
│ 4f: chapter-commit
│ 4g: 静默写回追踪文件
│ ├─ 追踪/上下文.md 更新
│ ├─ 追踪/伏笔.md 追加/闭合
│ ├─ 追踪/时间线.md 追加
│ ├─ 追踪/角色状态.md 更新
│ └─ 设定集/配角卡 增量/新建
│ 4h: 生成章节摘要（静默，一句话级别，供变更传播使用）
│ 写入 .novel/summaries/ch{N}.md
│ 4i: git backup
│
Step 5: 里程碑检查（自动，无交互）
│ 检查当前章节号触发哪个里程碑
│ 触发时在完成报告中展示建议
Deep 模式增量
在 Normal 流程基础上增加（以下"agent"指由主线 LLM 直接扮演的角色，非独立进程）：
Step 1 → context-agent（LLM 扮演）生成完整写作任务书
（含全部活跃伏笔、底本约束、文风指引）
Step 3 → 审查报告写入 审查报告/第{章号}章审查报告.md
→ review metrics 写入 index.db
Step 4 → data-agent（LLM 扮演）提取三份 artifact:
fulfillment_result.json（目标完成度）
disambiguation_result.json（消歧义）
extraction_result.json（本章新事物）
→ chapter-commit（含 data-artifacts）
→ projection 五层刷新（state/index/summary/memory/vector，由 LLM 直接更新对应文件）
→ postcommit gate 校验（LLM 检查一致性）
Step 5 → 三段式 user-report 最终总结
实现说明：本 skill 描述的 context-agent / data-agent / reviewer / projection / postcommit gate 均由主线 LLM 直接执行，scripts/fiction.py 仅提供 chapter-commit（持久化 commit 文件）和 review-pipeline（写审查报告）的辅助脚本支持。
里程碑提示（写完每章后自动触发）
当前章节号触发对应提示，展示在完成报告中：
| 位置 | 提示内容 |
|---|
| 第 1 章 | "第 1 章已完成。建议立即做一次深度审查：fiction-review 1（deep 模式）。这章是全书的脸面。" |
| 第 5 章 | "连续写了 5 章。建议：fiction-review 1-5 批量审查；检查追踪/伏笔.md；回看第 1 章风格一致性。" |
| 第 10 章 | "第 10 章完成。建议完整 review-pipeline：fiction-review 1-10；运行一致性检查；查看 dashboard 伏笔密度。" |
| 卷最后一章 | "「{卷名}」全部写完。建议：卷末深度审查；卷摘要归档；规划下一卷：fiction-plan {下一卷号}" |
| 距上次审查 ≥5 章 | "距上次审查过了 5 章。建议：fiction-review {上次+1}-{当前}" |
压制规则：
- 同一类型 24 小时内不重复
- 用户刚主动审查过 → 跳过对应提示
- 批量写多章时只在最后写完那章触发
- "每 5 章"基准点是上次审查位置
关于写回（全部静默执行，不弹提示）
每章完成后自动写回以下内容（用户不需要知道也不需要确认）：
- 追踪/上下文.md：更新进度、关键决策
- 追踪/伏笔.md：追加新伏笔/标记已回收
- 追踪/时间线.md：追加事件时间锚点
- 追踪/角色状态.md：更新属性/境界/关系变化
- 设定集/配角卡：首次出现且后续复用 → 自动建卡；已有 → 增量补充
- 大纲/第X卷/详细大纲.md：如果实际写作和章纲有出入 → 自动修正章纲（以正文事实为准）
例外：如果文件在上次 git commit 后有用户手动编辑，先问用户是否保留手动版本。
参考
写作技法参考库（从 story-* 系列继承）：
- genre-writing-formulas.md：各题材创作公式
- hooks-chapter.md / hooks-paragraph.md / hooks-suspense.md：钩子设计
- reversal-toolkit.md：反转设计
- emotional-methods.md / emotional-arc-design.md：情绪设计
- anti-ai-writing.md：去 AI 味核心规则
- banned-words.md：禁用词表
- dialogue-mastery.md：对话技法
- writing-craft.md：通用写作技法
以上参考按需加载，不一次性全部读入。
python -X utf8 "${SCRIPTS_DIR}/reference_search.py" \
--skill write --table genre-writing-formulas \
--query "{当前题材}" --genre "{当前题材}"
失败恢复
每步独立，失败补跑不后退。
- 审查缺失 → 重跑 Step 3
- 写回失败 → 只重跑写回步骤
- chapter-commit 未生成 → 重跑 commit
- projection 失败 → 重跑 projection
延申阅读
- 修改已写章节（大改/重写）→ 本 skill 内建修改模式
- 单纯润色 → fiction-polish
- 单独审查 → fiction-review
- 单独润色/去 AI 味 → fiction-polish
- 批量更新细纲 → fiction-plan
- 查询章节/设定状态 → fiction-query
- 可视化面板 → fiction-dashboard
- 项目体检 → fiction-doctor
- 提取写作模式 → fiction-learn
- 多书切换 → fiction-switch
- 导出/完本 → fiction-export
- 封面生成 → fiction-cover
附录：情绪确认交互示例
Normal 模式下 Step 1 的情绪确认部分：
📖 第 7 章写作准备
章纲目标：
· 核心事件：主角发现李四的账本
· 情绪目标：紧张 + 期待
· 本章爽点：李四吃瘪
· 细纲节点：CBN(发现) → CPN(对峙) → CPN(反转) → CEN(悬念)
最近 3 章摘要：[...]
活跃伏笔：[...]
相关设定：[...]
本章交付什么情绪？（一句话确认）
→ "紧张+期待，李四吃瘪时的畅快感"
附录：去 AI 味交互示例
Step 4 去 AI 味处理输出：
Step 4: 去 AI 味处理
────────────────────
banned-words 扫描：
🟢 一级词命中 3 处 → 已替换
🟢 二级词命中 7 处 → 已替换（2 处保留，语境合理）
AI 腔模式识别：
🟢 对称句密度正常
🟢 判断式语句 2 处 → 已改写
⚠️ 副词修饰偏多（可选处理）
────────────────────
去 AI 味验证：通过 ✓
附录：完成报告示例
Normal 模式完成后的报告：
═══════════════════════════════════════
第 7 章 完成
已生成：
· 正文/第07章-账本.md
· 审查结果（非阻断信息已标注）
· 追踪/伏笔.md 已更新（李四的会计 → 已回收）
· 追踪/时间线.md 已更新
· git backup ✓
下一章建议：
→ fiction-write 8
═══════════════════════════════════════
附录：写回清单（底本，静默执行）
每章完成后系统自动写回以下内容。用户不需要知道也不需要确认。
必写回：
- 追踪/上下文.md → 更新当前进度、本章关键决策
- 追踪/伏笔.md → 追加新埋伏笔、标记已回收伏笔为 closed
- 追踪/时间线.md → 追加本章事件的时间锚点
- 追踪/角色状态.md → 更新属性/境界/关系的变化
条件写回：
- 设定集/配角卡 → 首次出现的具名角色且后续会复用：自动建卡；已有卡：增量补充
- 大纲/第X卷/详细大纲.md → 如果实际写作和章纲有出入，以正文事实为准自动修正章纲（回填）
- 设定集/文风档案.md → Deep 模式下检查文风一致性并追加记录
仅在 Deep 模式下写回：
- 审查报告/第N章审查报告.md
- .story-system/chapters/chapter_N.json 刷新
- .story-system/commits/chapter_N.commit.json
写回遵循原则：
- 追踪文件有变动就更新，无变动不写入
- 不弹窗问用户确认
- 唯一例外：文件在上次 git commit 后有用户手动编辑，先问"是否保留你的版本？"
- 跨卷写回需要用户确认（token 消耗大）
章节修改模式（内建）
本 skill 同时承担章节修改职责（原 fiction-revise 已合并进来）。一次修订 = 定位变更点 → 执行修订 → 探测影响范围 → 传播变更 → 校验一致性。
不能改完一章就完事，系统必须自动回答：这章改了什么，哪些地方也需改？
修改模式速查
| 模式 | 场景 | 传播 | 耗时 | 路由 |
|---|
| Polish（润色） | 改表达，不改事实 | 不传播 | 5-10 分钟 | 转交 fiction-polish |
| Re-craft（大改） | 改了事实（人名/情节/细节），主干不变 | 自动传播 | 20-40 分钟 | 本 skill 内建 |
| Rewrite（重写） | 整章推翻重来，情节走向变了 | 全链路刷新 | 60-90 分钟 | 本 skill 内建 |
自动检测推荐
| 检测条件 | 推荐模式 |
|---|
| 用户说"改一下这句""润色""太啰嗦" | Polish → 转交 fiction-polish |
| 用户说"把 XXX 改成 YYY""设定不对" | Re-craft |
| 用户说"这章重写""推倒重来""重来一遍" | Rewrite |
| 修改范围超过一章（"第 5-8 章都要改"） | Rewrite |
| 修改波及设定集（"世界观改了""主角能力改"） | Rewrite（广播） |
详细流程
Re-craft 六步流程、Rewrite 六步流程、写回规则、撤销/回滚、修改模式参考详见：
→ references/revise-modes.md
进入修改模式时加载该文件获取完整步骤。
致谢
本 skill 的开发参考了以下开源项目的思路与实现：
感谢原作者的开源贡献。
