Novel — 小说创作工作流

和 AI 一起写小说。一次设定世界观/角色/写作风格 → 主线拆纲+卷纲展开 → 逐章写作循环（章纲→提示词→提示词验收→正文→正文验收→评审→归档→下一章）

范围 Scope

做什么

• 引导作者完成从设定到归档的完整写作流程
• 检测当前项目进度并自动路由到对应子技能
• 创建和维护项目文件结构（settings/、volumes/、chapters/、prompts/、archives/）
• 管理章生命周期（outline → draft → archived）
• 追踪角色状态和历史
• 管理伏笔/钩子的生命周期
• 检测 AI 味（疲劳词、句式违规）
• 旧版 2.x 项目的自动迁移

不做什么

• ❌ 不生成 git 操作（提交、推送、创建分支）
• ❌ 不执行非小说领域的代码（不建网站、不写 API、不做数据分析）
• ❌ 不修改项目目录外的文件
• ❌ 不安装新包或修改系统配置
• ❌ 不恢复已删除的文件
• ❌ 不处理版本冲突（假设工作目录干净）

边界条件

• 如果 story.md 不存在但 story.yaml 存在 → 分发到迁移子技能（非正常流程）
• 如果 init.py 不可用 → 手动创建目录结构 + 复制模板（等幂操作）
• 如果底层模型能力不足（如 DeepSeek TUI 显示质量问题）→ Phase 1-3 提示作者检查模型配置
• 如果检测到未提交的 git 变更 → 提示作者先提交/stash，不自动操作
• 如果 .agent/status.md 与文件系统状态不一致 → 以文件系统为准重新检测，更新 status.md
• 如果是全新项目（无任何文件）→ 分发到 novel-setup

项目目录结构

Agent 在用户当前目录下创建/编辑以下文件：

{project-name}/
├── story.md              # ★ 必有：项目索引（元信息/引用路径/主线拆纲）
├── settings/
│   ├── world-setting.md  # 世界观（core: geography/politics/rules, extended: ...）
│   ├── writing-style.md  # 写作风格
│   ├── genre-setting.md  # 题材设定（satisfaction_types / pacing_rules / anti_cliches）
│   └── character-setting/
│       └── <id>.md       # ★ 每角色一个文件（状态历史 + 情绪弧线 追加写入）
├── volumes/
│   └── volume-{N}.md     # 卷纲（chapters_summary 占位章纲）
├── chapters/
│   └── vol-{N}-ch-{M}.md # ★ 章纲唯一存放处（memo + emotional_design + status）
├── prompts/
│   └── vol-{N}-ch-{M}-prompt.md  # ★ 章提示词（自动生成，可覆盖）
└── archives/
    ├── vol-{N}-ch-{M}-{slug}.draft.md  # 草稿（写作中）
    └── vol-{N}-ch-{M}-{slug}.md        # ★ 定稿（归档后去掉 -draft）

关键文件与不变约束：

• chapters/vol-{N}-ch-{M}.md#status — ★ 进度标记。outline → draft → archived 驱动 Step 1 判断该做什么。归档时更新。
• settings/character-setting/<id>.md → 状态历史 — ★ 角色状态的唯一记录。归档时追加，状态历史条目数必须等于该角色已归档章节数。
• archives/vol-{N}-ch-{M}-{slug}.md — ★ 正文唯一存放处。文件名有 -draft = 未归档，没有 = 已归档。
• volume-{N}.md#chapters_summary — 卷纲占位章纲，逐章讨论时详情写入 chapter.md。

约定：

• chapters/ 只放章纲 md，不放正文
• prompts/ 只放提示词 md，纯生成产物——可覆盖，不手动维护
• archives/ 正文唯一存放处
• settings/character-setting/ 每角色独立 md，追加写入不覆盖
• volumes/ 卷纲 md，chapters_summary 只写占位章纲（逐章讨论时补充写入 chapter.md）

硬性自检协议（贯穿整个 Skill）

下面每个产出完成后，必须先自检 → 修复 → 再汇报/推进：

自检方式（推荐用独立助手完成）：

1. 独立检查助手（推荐） — 开一个专门的检查助手，告诉它"产出文件路径 + 对应清单 + 关键信息"，逐项核查后报告结论（哪几条 pass / 哪几条 fail + 证据 + 修改建议）
2. 辅助助手 — 没有独立助手条件时，用辅助助手走同样流程
3. 自己检查（兜底） — 上面两种都不行时，自己严格逐项核查——不允许目测一遍就放行

铁律： 拿到结论后先按不合格项把产出改完，再向用户汇报"做完了" + 自检结论 + 改了什么。直接拿原始结论汇报但不修复 = 违规。

各阶段文件读取指南

每个子步骤按"写什么文件 → 读什么参考 → 可选的参考阅读"来准备。读完一份，再看下一份。

条件分支指引（当 X 发生时读 Y）

正常流程走上面那张表。以下异常或边界场景需要额外读取：

错误恢复

本技能执行过程中如果某一步失败：

1. 自动重试（最多 3 次） — 每次换一种方式重试。例如 subagent 超时 → 减少并发数重试；文件写入冲突 → 换文件名重试
2. 重试耗尽 → 降级 — 跳过失败步骤，继续后续步骤，在最终汇报中标记失败项
3. 关键步骤失败（骨架创建、状态文件写入）→ 立即上报作者，描述失败现象 + 已尝试的方法 + 建议的手动修复方案

常见失败场景与恢复策略

工具契约

分发原则： 主 Agent 只负责状态检测 + dispatch。实际的项目文件操作（读设定、写章纲、生成提示词、写正文等）全部通过对应子 skill 执行。

主 Agent 禁止行为

主 Agent 在执行本技能时，禁止以下行为：

• 禁止自行判断"不需要 dispatch" — 检测到状态后必须按信号表分发到对应子 skill，不可跳过
• 禁止直接读写项目文件（status.md 除外） — 项目文件（settings/、chapters/、volumes/、archives/ 等）的读写必须通过子 skill 执行，不可主 Agent 直接操作

违反处理： 违反以上任意一条 → 立即上报作者，描述违反内容，不自行修复后再报告。

生命周期 Lifecycle

Start（开始时）

1. 读 .agent/status.md（如果存在）→ 确认当前进度和 migrated 标志
2. 读 story.md → 判断走哪个分支（迁移 / 正常流程 / 新项目）
3. 如是新项目 → 读 skills/setup/SKILL.md 开始初始化

End（结束时）

每个子技能执行完毕后，主 Agent 必须：

1. 写回状态 — 用 Write 把最新检测结果写入 .agent/status.md
2. 角色状态追加 — 如刚完成归档，必须用 Edit 在对应角色文件追加状态历史
3. 汇报路由 — 告诉用户"回到主流程，当前状态：X，下一步：Y"

跨会话恢复

用户说"继续写小说"或触发技能时：

1. 读 .agent/status.md → 获取 current_phase / current_volume / current_chapter
2. 读对应 chapter.md + volume.md → 恢复上下文
3. 从 Step 1 信号表继续路由

工作机制：状态驱动循环

主 SKILL.md 和子 skill 之间没有显式"调用"。整个系统是一个状态驱动循环：

Step 1（检测状态）→ 匹配路由 → Read 子 skill → 子 skill 改状态 → 回到 Step 1（重新检测）

通信方式： 不传递消息或参数。主 skill 写 chapter.md#status + .agent/status.md，子 skill 读这些文件来知道"当前在做什么阶段"。

• 主 skill Step 1 检测 chapters/ 下的状态 → 匹配到对应子 skill
• 主 skill Step 2.3 读子 skill 的 SKILL.md，Agent 直接执行里面的步骤
• 子 skill 修改 chapter.md#status 和产出文件，末尾写"回到主流程"
• Agent 读"回到主流程"后，重新从 Step 1 开始，检