Novel Architect — 商业连载网文创作 Skill

版本 3.0.0。目标是让 Agent 以“脚本状态守卫 + 模型文学判断”的混合方式，稳定完成中文商业连载网文的开书、续写、审校、修稿和长线维护。

0. 总原则

把本 skill 当成可自主执行的工作流，不要把 CLI 命令清单转交给用户。

用户负责提供高层创作目标、题材、平台、偏好、限制和重大方向选择。
Agent 负责读取本 SKILL.md，必要时读取 references/，自行调用 novel_architect CLI，自行读取产物，自行生成 JSON/正文/修稿，并推进到有效停止点。
Python CLI 是确定性工具层，负责项目状态、索引、账本、门禁、信号、hash 和文件落盘；它不是给用户手动执行的说明书。
模型负责文学判断和创作输出：market pack、beat 选择、正文写作、model signal、修稿、反馈诊断。
只有在缺少 shell/文件工具、项目路径不明且无法推断、或需要真正的创作方向取舍时，才询问用户。

有效停止点只有这些：章节 gate.passed=true 并已 commit；前三章审校失败需要重写开头或重做 market pack；缺少必要输入导致无法继续；工具权限不足；需要用户在多个重大创作方向中选择。

1. 运行命令约定

在能导入 novel_architect 的工作区执行命令。优先使用项目仓库根目录下的：

uv run python -m novel_architect <command> ...

如果当前环境没有 uv 但包已安装，使用：

python -m novel_architect <command> ...

如果 console script 可用，也可以使用：

novel-architect <command> ...

执行前先确定项目路径：用户给出路径则使用该路径；用户只说“这本书/继续写”时，先检查常见 projects/<书名>/ 目录和 project.json；多个候选项目无法判断时再问用户。

review、save-first3-review 等命令返回非 0 通常表示门禁未过，不代表程序崩溃。此时读取输出 JSON、gate.json 或 repair.json，修复后重试。

2. Agent 自主执行契约

必须自己执行的动作

当任务涉及开书、续写、审校、修稿、改纲、重建、反馈诊断或状态检查时，Agent 必须自己调用 CLI、读取输出、写入文件并继续流程。

不要只回复：

请运行 python -m novel_architect prepare ...

应当实际运行命令，检查产物，再继续下一步。只有环境没有 shell/文件权限时，才给用户命令。

导出的 prompt 都是 Agent 工作项

这些命令会导出 prompt 或 input 文件。Agent 需要读取它们并亲自生成对应 JSON/文本，再调用保存命令或更新文件。

导出命令	产物	Agent 下一步
`market-open`	`editorial/market_pack_prompt.md`、`market_pack_input.json`	生成严格 JSON，调用 `market-save`
`beat-candidates`	`editorial/chXXXX/beat_competition_prompt.md`、`beat_competition_input.json`、`beat_options.json`	选择/生成最强方案，调用 `beat-select`，再 `apply-beat-selection`
`export-signal-prompts`	12 个 signal prompt JSON	逐个生成 model signal JSON，调用 `save-model-signal`
`first3-review`	`data/reviews/first3_review_prompt.md`、`first3_review_input.json`	生成含 `review_input_hash` 和 8 个分数的 verdict，调用 `save-first3-review`
`feedback-diagnose`	`data/feedback/chXXXX_diagnosis_prompt.md`、input	生成诊断；如需保存，将诊断写入反馈 JSON 的 `diagnosis` 后调用 `save-feedback`
`export-title-review-prompt` / `export-intro-review-prompt`	书名/简介审校 prompt	生成诊断，必要时更新 `market_pack.json`、书名/简介候选或开书资料

不要让用户把这些 prompt 粘给另一个模型，除非用户明确要求这种人工协作模式。

3. 任务入口速查

用户意图	Agent 应执行的主流程
开一本新书	`init` → `market-open` → `market-save` → 补强真相源 → `first-10-retention` / `save-first10-plan` → 前三章试生产
继续写下一章	`status` → `prepare` → beat competition → 写正文 → `review` → model signals → `review` → 修稿循环 → `commit`
修复本章	读取 `editorial/chXXXX/repair.json` 和 `gate.json` → 改正文 → `review` → 必要 model signals → 再 `review` → 通过后 `commit`
前三章审校	第 1-3 章已提交后运行 `first3-review` → 生成 verdict → `save-first3-review`
改纲/改设定	修改 `src/*.json` 真相源 → `rebuild` → `status` → 必要时重跑受影响章节 review
卷级/批量体检	`batch-review`、`volume-review`、`benchmark`、`status`
平台反馈回流	`save-feedback` → `feedback-diagnose` → 生成诊断 → 更新后续滚动规划/market pack/章节 notes
拆书建模	`learn --sample-dir <dir>`，再把结论转成可执行的题材/节奏/章节规划调整

gen-prompt 只用于用户明确要求“导出给外部写作模型/Claude Code 的独立提示词”时。普通续写不要用 gen-prompt 替代 prepare → beat → writing_task → review → commit 主流程。

4. 开书流程

开新书时，不要直接开始写第 1 章。先建立市场定位和真相源。

4.1 初始化项目

python -m novel_architect init --project <project_dir> --title <title> --genre <genre> --platform <platform> --premise <premise> --core-hook <core_hook> --protagonist <name>

初始化会生成 project.json、src/、manuscript/、data/、editorial/ 等目录。初始化只提供骨架，不代表开书策划完成。

4.2 生成并保存 market pack

运行 market-open，读取导出的 prompt/input，自行生成严格 JSON，再运行 market-save。

market pack 必须至少包含：

target_platform
genre_lane
target_reader
reader_desires
core_sell_points
anti_sell_points
title_candidates
intro_candidates
first_10_chapter_retention_plan
platform_notes
author_constraints

前 10 章计划中每章必须有 chapter、hook、visible_payoff、drop_off_risk。不要写“加强冲突”“提高爽感”这种不可执行空话。

4.3 补强真相源

src/ 是人工确认真相源。开书后检查并补强：

src/blueprint.json：前提、核心钩子、核心冲突、主角目标。
src/characters.json：角色身份、欲望、恐惧、弱点、弧线、slug。
src/character_voice_bible.json：角色声纹规则、禁用口吻、行动偏好、情绪泄漏点。结构为 {"schema_version":1,"characters":{"角色名":{...}}}；如果文件还是 skeleton 或角色 needs_completion=true，先补全再正式写正文。
src/world.json：世界/行业/力量规则，只保留服务冲突和爽点的设定。
src/taboos.json：绝对不能碰的桥段、AI 味、题材反模式。
src/volumes.json：卷级目标和滚动章纲。不要一次性把整本每章写死。
src/genre_config.json：题材打法；内置优先支持玄幻升级、都市逆袭、历史权谋、悬疑破局，其他题材需更依赖 market pack 和自定义 genre_config。

修改真相源后运行：

python -m novel_architect rebuild --project <project_dir>
python -m novel_architect status --project <project_dir>

不要手动修改 data/ 里的账本或派生状态来“修好”剧情；长期语义修正写入 src/ledger_overrides.json 或对应 src/*.json，再重建。

4.4 前十章留存计划

使用 first-10-retention 导出/生成计划；必要时自行细化后用 save-first10-plan 保存。前十章是入口漏斗，规划应具体到每章的 hook、可见收益、弃读风险和不能做什么。

5. 续写下一章标准流程

每章必须走完整闭环。不要直接根据聊天上下文写正文。

5.1 状态检查

先运行：

python -m novel_architect status --project <project_dir>

确定当前完成章数、gate 状态、索引健康和待处理风险。不要依赖聊天记忆判断下一章号。

5.2 PREPARE

python -m novel_architect prepare --project <project_dir> --query "<本章高层创作要求>"

产物：editorial/chXXXX/writing_task.json。这是写作阶段的自包含任务包，必须读取。它包含 writer_brief、narrative_context、叙事槽、商业留存字段、角色声纹、读者承诺、输出格式和硬规则。

第 4 章以后，prepare 会检查前三章专项审校。正常新书不得使用 --force-after-first3-fail；该参数只用于旧项目迁移或调试。

5.3 Beat competition

第 1-10 章必须执行 beat competition；第 10 章以后默认也建议执行，除非用户明确要求快速草稿。

python -m novel_architect beat-candidates --project <project_dir> --chapter <n>

读取导出的 prompt，生成或选择一个策略最强的方案，保存并应用：

python -m novel_architect beat-select --project <project_dir> --chapter <n> --file <selection.json>
python -m novel_architect apply-beat-selection --project <project_dir> --chapter <n>

选择标准：可见爽点最清楚、敌人损失最具体、角色按钮最鲜明、章尾追更理由最强、弃读风险最低。应用后重新读取最新 writing_task.json。

5.4 WRITE

根据 writing_task.json 写正文并保存到 manuscript/第XXX章-标题.md。标题必须有点击感，不要只保存为 第XXX章.md。

正文必须严格遵守 writing_task.output_format.field_template：

# 第XXX章-标题
## 章节信息
## 本章大纲
## 正文
## 记忆回写

关键要求：

正文不少于 2000 字，目标 2000-2500 字。
使用中文弯引号 “”。
第一段承接上章钩子；第 1 章则快速建立压迫、主角欲望和可见机会。
每章必须有普通读者 5 秒内能复述的可见爽点。
专业流程/术语必须转译成钱、权、脸面、身份、关系、秘密、战力、资源或安全得失。
角色对白必须体现 character_voice_bible，禁止所有人同一种战略总结口吻。
如制造新的读者期待，必须在记忆回写中填写新增读者承诺；如兑现期待，必须填写兑现 ID 和可见证据。

5.5 REVIEW 第一轮

python -m novel_architect review --project <project_dir> --chapter <n>

如果返回非 0，读取 editorial/chXXXX/gate.json 和 repair.json，不要跳过。

5.6 模型信号评估

导出信号 prompt：

python -m novel_architect export-signal-prompts --project <project_dir> --chapter <n>

前 10 章、卷首、卷末、高潮、转折、发布前章节：12 个 signal 都要生成并保存 model signal。

稳定期最低也要覆盖：

reader_pull
visible_payoff
blockbuster
title_hook
character_voice
domain_translation
story_logic
state_guard

保存每个模型信号：

python -m novel_architect save-model-signal --project <project_dir> --chapter <n> --signal <signal_type> --file <signal.json>

模型信号必须输出严格 JSON。若评分低于 7，不得写 pass。模型 pass 不能覆盖 heuristic warn/fail；最终采用 strictest merge。

5.7 REVIEW 第二轮与修稿循环

保存 model signals 后重新运行：

python -m novel_architect review --project <project_dir> --chapter <n>

只有 gate.json 中 passed=true 才能提交。若 passed=false，读取 repair.json，改正文后重复 review/model-signal/review，直到通过或到达有效停止点。

5.8 COMMIT

python -m novel_architect commit --project <project_dir> --chapter <n>

只在 gate 通过后执行。commit 会推进状态、重建索引、更新账本、处理 reader promise 创建/兑现/逾期。不要跳章提交；不要手动改 gate.json 或 signals 来强行通过。

6. 前三章专项门禁

新书第 1-3 章是试生产阶段。第 1、2、3 章分别完成 prepare → beat → write → review → model signals → review → commit 后，必须执行：

python -m novel_architect first3-review --project <project_dir>

读取 data/reviews/first3_review_prompt.md 和 first3_review_input.json，生成 verdict JSON，再保存：

python -m novel_architect save-first3-review --project <project_dir> --file <first3_verdict.json>

允许继续第 4 章必须同时满足：

verdict == "continue"
bulk_continue_allowed == true
原样包含当前 review_input_hash
8 个评分全部存在：title_intro_click_score、first_chapter_hook_score、protagonist_desire_score、conflict_speed_score、first_payoff_speed_score、enemy_or_pressure_score、setting_clarity_score、continuation_score
所有评分都是 1-10 数字，且全部 >= 7

如果结果是 rewrite_opening，先修前三章；如果是 redo_market_pack，先重做 market pack、书名/简介/前十章计划。不要用 --force-after-first3-fail 正常推进新书。

前三章正文、market pack 或入口输入变化后，旧 first3_review 会因 hash 过期而阻断第 4 章以后生产，必须重新运行 first3-review 并保存新 verdict。

7. 门禁与 12 个信号

review 生成 12 个信号、verdict、gate、repair。每次 review 都重新运行 heuristic signal；新鲜 model signal 保存为 .model.json 变体参与 strictest merge；final signal 取更严格结果。

信号	检测内容	失败处理
`anti_ai`	AI 套话、抽象密度、空段落、直引号	hard，必须修
`story_logic`	POV、信息来源、力量/商业逻辑、信息倾泻	hard，必须修
`state_guard`	钩子、代价、敌人线、必需元素、禁区、逾期 reader promise	hard/quality，必须修
`emotion`	情绪弧线、关系动态、后效	quality，失败不可提交
`blockbuster`	压迫/反制/兑现/代价四段爽点弧线	quality，失败不可提交
`visible_payoff`	钱/权/脸面/身份/关系/秘密/能力/资源/安全得失	quality，失败不可提交
`reader_pull`	开场钩子、中段悬念、章尾追更、成瘾循环	quality，失败不可提交
`title_hook`	章节标题点击感、标题/文件名一致性、章末钩子	quality，失败不可提交
`character_voice`	角色声纹差异、禁用口吻、对白归属	quality，失败不可提交
`domain_translation`	专业设定是否转译成普通读者可见得失	quality，失败不可提交
`novelty`	结构/章法/结尾模式重复	market，失败也会阻塞
`continuity`	钩子、代价、敌人线程承接	market，失败也会阻塞

简单规则：只看 gate.passed。passed=true 才能 commit；passed=false 就修。

8. 长线维护

每章：完整执行 prepare → beat → write → review → model signals → review → repair → commit。
每 3 章：运行 status，检查 active/overdue reader promises、gate 变化、索引健康。
每 5 章：运行 batch-review --start <a> --end <b>，检查连续弱项和重复模式。
每 10 章或关键节点：运行 volume-review、benchmark，滚动更新 volumes.json 和后续 5-10 章规划。
每卷结束：检查卷目标、敌人损失、读者承诺兑现、下一卷钩子。
发布后：用 save-feedback 记录数据和评论，用 feedback-diagnose 转成下一轮实验建议。样本很小时不要过拟合单条评论。

9. 真相源与目录规则

项目结构：

projects/<书名>/
├── project.json
├── src/                  # 真相源，人工确认设定和规划
├── manuscript/           # 正文章节 .md
├── data/                 # 派生状态，可重建，不手动改
├── editorial/            # 每章 brief / writing_task / signals / gate / repair
└── exports/

重要规则：

src/ 与 manuscript/ 是 truth input。
data/、editorial/ 是运行时/派生产物；不要手动改它们来绕过门禁。
改设定、改卷纲、改角色时修改 src/*.json，再 rebuild。
改正文时修改 manuscript/第XXX章-标题.md，再 review。
长期人工账本修正写入 src/ledger_overrides.json，再 rebuild。

10. 禁止事项

不要做以下事情：

不要把 CLI 工作转交给用户手动执行。
不要没有 prepare 就直接写正式章节。
不要跳过 beat competition 写前 10 章。
不要 gate.passed=false 还 commit 或继续下一章。
不要为正常新书使用 --force-after-first3-fail。
不要只保存 heuristic review 就认为商业质量足够；关键章节必须做 model signal。
不要手动改 gate.json、signals 或 data/ledgers 来制造通过。
不要让章节没有标题或只叫 第XXX章.md。
不要让记忆回写长期填“无”，尤其是 reader promise。
不要把专业流程写成会议纪要、授权记录、复核清单，而不转译成读者可见得失。
不要承诺逐字模仿某位作者或某本现成作品的语言风格。

11. 需要读取的参考文件

按需读取，避免把全部资料一次性塞入上下文。

文件	何时读取
`references/pipeline-spec.md`	对 PREPARE/WRITE/REVIEW/COMMIT、恢复、hash、新鲜度有疑问时
`references/review-spec.md`	处理 12 signals、model signal、verdict、gate、repair 时
`references/story-spec.md`	不确定章节格式、章节模式、节奏变体、记忆回写字段时
`references/state-spec.md`	改状态、账本、reader promise、ledger overrides、rebuild 时
`references/genre-spec.md`	题材打法、genre_config、题材 marker、内置 playbook 时
`references/learning-spec.md`	拆书建模和样本结构学习时
`references/longrun-spec.md`	batch/volume/benchmark 和长篇稳定性检查时

如果实现行为、README 和 references 冲突，以当前 Python CLI 行为为准，并在维护任务中同步文档。

12. 常用命令清单

python -m novel_architect --help
python -m novel_architect init --project <dir> --title <title> --genre <genre> [--platform <platform>] [--premise <text>] [--core-hook <text>] [--protagonist <name>]
python -m novel_architect market-open --project <dir> [--platform <platform>] [--genre-hint <genre>] [--seed-idea <idea>] [--author-intent <intent>] [--constraint <text>] [--stdout]
python -m novel_architect market-save --project <dir> --file <market_pack.json>
python -m novel_architect market-status --project <dir>
python -m novel_architect first-10-retention --project <dir> [--stdout]
python -m novel_architect save-first10-plan --project <dir> --file <first10.json>
python -m novel_architect status --project <dir>
python -m novel_architect prepare --project <dir> [--query <text>]
python -m novel_architect beat-candidates --project <dir> --chapter <n>
python -m novel_architect beat-select --project <dir> --chapter <n> --file <selection.json>
python -m novel_architect apply-beat-selection --project <dir> --chapter <n>
python -m novel_architect review --project <dir> --chapter <n>
python -m novel_architect export-signal-prompts --project <dir> --chapter <n>
python -m novel_architect save-model-signal --project <dir> --chapter <n> --signal <type> --file <signal.json>
python -m novel_architect commit --project <dir> --chapter <n>
python -m novel_architect resume --project <dir> --chapter <n> [--query <text>]
python -m novel_architect first3-review --project <dir>
python -m novel_architect save-first3-review --project <dir> --file <first3_verdict.json>
python -m novel_architect batch-review --project <dir> --start <a> --end <b>
python -m novel_architect volume-review --project <dir> [--volume <n>]
python -m novel_architect benchmark --project <dir>
python -m novel_architect rebuild --project <dir>
python -m novel_architect rebuild-index --project <dir>
python -m novel_architect validate --project <dir> --chapter <n>
python -m novel_architect learn --sample-dir <dir>
python -m novel_architect save-feedback --project <dir> --chapter <n> --file <feedback.json>
python -m novel_architect feedback-diagnose --project <dir> --chapter <n>
python -m novel_architect feedback-summary --project <dir>
python -m novel_architect gen-prompt --project <dir> [--outline-file <path>] [--stdout]

zhougz520/novel-architect

Ask in your favorite AI

문서