novel-write:单句需求跑一次 pipeline 创作

SkillDev tools

Drives novel-studio with a single creative requirement through a resumable pipeline for complete creation (writing → review → rewrite → export). Triggers: 'help me write a novel', 'write based on this setting', 'run a creation pass'. Use when there are clear creative requirements and an unattended e

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the novel-write:单句需求跑一次 pipeline 创作 skill

What this skill tells your AI

The instructions your AI receives, as published by xiaoyangy/novel-studio in skills/novel-write/SKILL.md and read by ahel’s review.

把用户的创作要求作为 prompt 交给 novel-studio --pipeline,由 pipeline 编排写作、评审、 重写和导出。章节落盘到 output/novel/chapters/*.md。无 TTY,可在 CI / 远程 agent 中运行。

--headless --prompt 只保留为兼容别名,命令层会转入 pipeline。新任务一律直接调用 --pipeline,不要绕过流水线。

前置条件

  • 已完成首次配置(见 skills/README.md)。headless 不支持首次引导。

执行

# 直接传文本
novel-studio --pipeline --prompt "写一个赛博朋克背景、主角是义体黑客的长篇开篇"

# 从文件读 prompt(长需求/含换行时推荐)
novel-studio --pipeline --prompt-file ./requirement.md

# 从 stdin 读
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

Signals

GitHub stars
109
Forks
18
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
novel-write
Source
github.com/xiaoyangy/novel-studio