| name | novel-write |
| description | 用一句创作需求驱动 novel-studio 走可恢复 pipeline 完整创作（写作→评审→重写→导出）。触发：「帮我写本小说」「按这个设定写」「跑一次创作」，已有明确创作要求且希望无人值守端到端产出章节时使用。 |
novel-write：单句需求跑一次 pipeline 创作
把用户的创作要求作为 prompt 交给 novel-studio --pipeline，由 pipeline 编排写作、评审、
重写和导出。章节落盘到 output/novel/chapters/*.md。无 TTY，可在 CI / 远程 agent 中运行。
--headless --prompt 只保留为兼容别名，命令层会转入 pipeline。新任务一律直接调用
--pipeline，不要绕过流水线。
前置条件
- 已完成首次配置（见
skills/README.md）。headless 不支持首次引导。
执行
novel-studio --pipeline --prompt "写一个赛博朋克背景、主角是义体黑客的长篇开篇"
novel-studio --pipeline --prompt-file ./requirement.md
echo "需求文本" | novel-studio --pipeline --prompt-file -
参数
| 参数 | 说明 |
|---|
--prompt <text> | 单句创作需求；与 --prompt-file 互斥 |
--prompt-file <path> | 从文件读需求，- 表示 stdin |
--stages <list> | 可选，默认 write,review,rewrite,deliver |
--config <path> | 可选，指定配置文件 |
产物
- 章节：
output/novel/chapters/*.md
- 写法资产：
output/novel/meta/writing_assets.json（可编辑、复用、由弧摘要持续沉淀）
- 人工感写法参考：内置
assets/references/human-feel-craft.md 会随 reference_pack.references.human_feel_craft 注入，迁移《同桌是只假装高冷的猫》的物件回扣、主观误判、短对话和现实支架，避免正文只靠解释和模板情绪推进。
- reference-library 写作技巧总纲：内置
assets/references/refer-writing-techniques-digest.md 会随 reference_pack.references.writing_techniques_digest 注入，来自 data/reference-library/writing-craft 19 篇逐篇提炼，约束全书设计、大纲、人物、单章目标/阻力/代价/新增信息、事件余波和中文标点功能。
- 本书世界：
output/novel/book_world.json（地图、地点、路线、势力图谱）
- 资源账本：
output/novel/meta/resource_ledger.json（已入账事实与待确认提案分离）
- RAG trace：
output/novel/meta/rag/retrieval_trace.jsonl（召回命中原因）
- 运行日志：项目目录下
headless.log
失败排查
- 报「首次启动需要先在交互终端运行一次 novel-studio 完成配置引导」→ 先在交互终端跑一次
novel-studio 完成 stdin 配置，或手写 ~/.novel-studio/config.json。
