Skip to content

zenstory-ai/oh-story-claudecode / skills/story-long-write

story-long-write

Verified

长篇网文规划与写作。支持只讨论结构、只写大纲或指定细纲,明确要求正文后再写章节。触发方式:/story-long-write、/写长篇、「帮我开书」「定设定」「出卷纲」「规划剧情」「写大纲」「补细纲」「日更」「续写」「继续写」「修改第X章」「回炉」「重写第X章」。

FileKindSize
SKILL.mdskill md13.0 KB
references/agent-calls.mdmarkdown5.3 KB
references/artifact-protocols.mdmarkdown9.8 KB
references/author-memory.mdmarkdown6.6 KB
references/banned-words.mdmarkdown10.9 KB
references/benchmark-recall.mdmarkdown5.2 KB
references/character-basics.mdmarkdown12.3 KB
references/character-relations.mdmarkdown10.2 KB
references/cross-book-recall.mdmarkdown3.9 KB
references/dialogue-mastery.mdmarkdown11.0 KB
references/emotional-methods.mdmarkdown7.9 KB
references/female-audience-writing.mdmarkdown7.5 KB
references/genre-prose-cards.mdmarkdown7.0 KB
references/genre-prose-cards/东方仙侠.mdmarkdown2.3 KB
references/genre-prose-cards/传统玄幻.mdmarkdown1.9 KB
references/genre-prose-cards/历史古代.mdmarkdown1.7 KB
references/genre-prose-cards/历史脑洞.mdmarkdown2.0 KB
references/genre-prose-cards/双男主.mdmarkdown2.3 KB
references/genre-prose-cards/古言脑洞.mdmarkdown1.8 KB
references/genre-prose-cards/古风世情.mdmarkdown2.3 KB
references/genre-prose-cards/女频悬疑.mdmarkdown1.8 KB
references/genre-prose-cards/女频种田.mdmarkdown1.8 KB
references/genre-prose-cards/宫斗宅斗.mdmarkdown1.6 KB
references/genre-prose-cards/年代.mdmarkdown2.1 KB
references/genre-prose-cards/快穿.mdmarkdown1.9 KB
references/genre-prose-cards/悬疑灵异.mdmarkdown1.7 KB
references/genre-prose-cards/悬疑脑洞.mdmarkdown1.9 KB
references/genre-prose-cards/战神赘婿.mdmarkdown1.9 KB
references/genre-prose-cards/抗战谍战.mdmarkdown1.8 KB
references/genre-prose-cards/星光璀璨.mdmarkdown1.8 KB
references/genre-prose-cards/民国言情.mdmarkdown1.9 KB
references/genre-prose-cards/流派兜底.mdmarkdown8.4 KB
references/genre-prose-cards/游戏体育.mdmarkdown1.9 KB
references/genre-prose-cards/玄幻脑洞.mdmarkdown2.0 KB
references/genre-prose-cards/玄幻言情.mdmarkdown1.7 KB
references/genre-prose-cards/现言脑洞.mdmarkdown1.8 KB
references/genre-prose-cards/科幻末世.mdmarkdown1.7 KB
references/genre-prose-cards/职场婚恋.mdmarkdown1.7 KB
references/genre-prose-cards/西方奇幻.mdmarkdown1.9 KB
references/genre-prose-cards/豪门总裁.mdmarkdown2.3 KB
references/genre-prose-cards/都市修真.mdmarkdown1.7 KB
references/genre-prose-cards/都市日常.mdmarkdown2.8 KB
references/genre-prose-cards/都市种田.mdmarkdown1.7 KB
references/genre-prose-cards/都市脑洞.mdmarkdown2.4 KB
references/genre-prose-cards/都市高武.mdmarkdown2.0 KB
references/genre-prose-cards/青春甜宠.mdmarkdown1.8 KB
references/genre-readers.mdmarkdown6.9 KB
references/long-chapter-hooks.mdmarkdown6.5 KB
references/long-chapter-quality.mdmarkdown3.3 KB
references/long-format.mdmarkdown2.1 KB
references/long-genre-catalog.mdmarkdown11.9 KB
references/long-genre-mechanics.mdmarkdown8.3 KB
references/long-reversal.mdmarkdown12.3 KB
references/long-suspense.mdmarkdown9.2 KB
references/opening-design.mdmarkdown4.5 KB
references/outline-methods.mdmarkdown12.5 KB
references/outline-template.mdmarkdown8.0 KB
references/plot-core-methods.mdmarkdown5.3 KB
references/project-files.mdmarkdown4.7 KB
references/reader-contract-and-progression.mdmarkdown6.9 KB
references/revision-diagnosis.mdmarkdown3.6 KB
references/style-combat-face.mdmarkdown9.1 KB
references/tracking-initialization.mdmarkdown1.6 KB
references/tracking-transaction.mdmarkdown9.0 KB
references/workflow-chapter.mdmarkdown12.5 KB
references/workflow-daily.mdmarkdown6.3 KB
references/workflow-outline.mdmarkdown11.5 KB
references/workflow-revision.mdmarkdown6.5 KB
references/workflow-setup.mdmarkdown10.9 KB
references/workflow-volume.mdmarkdown6.4 KB
references/writing-craft.mdmarkdown23.6 KB
scripts/author_memory_commit.pyscript75.0 KB
scripts/build_architect_brief.pyscript21.8 KB
scripts/build_writer_prompt.pyscript41.7 KB
scripts/check-ai-patterns.jsexecutablescript79.8 KB
scripts/check-degeneration.jsscript15.4 KB
scripts/check-outline-contract.jsscript28.3 KB
scripts/check-outline-copy.jsscript13.4 KB
scripts/convert_outline_format.pyscript20.0 KB
scripts/normalize-punctuation.jsexecutablescript19.0 KB
scripts/outline_view.pyscript18.2 KB
scripts/storyctl.pyexecutablescript37.0 KB
scripts/style-whitelist.jsscript1.1 KB
scripts/template_fence.pyscript2.6 KB
scripts/tracking_commit.pyscript89.6 KB
scripts/wordcount_core.pyexecutablescript18.9 KB

references/workflow-chapter.md

View on GitHub
# workflow-chapter.md:单章正文工作流(Phase 4-5)

> 谁读:主会话写一章、日更的每一章整份读。

每章按本文件执行,日更批次见 `workflow-daily.md`。

**缺文件先修,本轮不写**(修好再从「检查细纲」开始;告诉作者用下方「写不下去、要停下时」的问法):
- `tracking_commit.py check` 不过:按它的提示修。
- 已有正文却缺 `_tracking-state.json`:请作者走 `/story-import`「旧追踪项目迁移」;新书还没有正文时不算缺,按下方初始化。
- 自动生成的视图与 state 不一致:按 [tracking-transaction.md](tracking-transaction.md) 为该章提交 `mode=revision` 事务重建,不手改、不继续下一章。
- 有对标却缺情绪模块/节奏/文风:请作者用 `/story-long-analyze` 补拆。本书有自定义文风时不缺文风;无对标(判定见 [benchmark-recall.md](benchmark-recall.md))或召回降档成立时都不算缺。

**缺细纲**:写指定章时按 [outline-template.md](outline-template.md) 补建点名章细纲(目标情绪、主角目标/关键选择须明确,其余未知写 `[待补充]`),跑 `check-outline-contract.js` 验收再写,汇报里说补了什么;日更批内停在该章前问作者。

**细纲缺两行**:旧细纲缺字段时照旧字段写,不回写;唯一例外是「目标情绪」「主角目标/关键选择」两行(空、`[待补充]`、无、待定都算缺,组装脚本核对报告会点名)。缺了不拒写:主会话按卷纲本段剧情补出这两行写回细纲,汇报里说「补了这两行」,再写;卷纲里也没有本章内容才停下问作者。

**工作目录**:本章临时文件(writer_prompt.md、tracking.json)只放书目录下 `.story/work/第NNN章/`,不写系统 `/tmp`、`正文/`、`大纲/` 或书根;提交成功后脚本自动删除。

---

## 单章写作流程

新书还没有 `_tracking-state.json` 时先按 [tracking-initialization.md](tracking-initialization.md) 初始化。

1. **检查细纲**:读 `大纲/细纲_第{N}章.md` 全文,跑 `outline_view.py --chapter {N} {卷纲路径}`(知道编号可用 `--unit {编号}`)取全卷规矩、当前剧情段与压住不揭的事项(日更同段本批复用,**不整读卷纲**)。缺细纲或缺两行见开头。
2. **读取上下文**:`tracking_commit.py check` → `追踪/上下文.md` 全 7 栏 → 细纲点名的 `设定/势力/`、`设定/世界观/` 相关条目;角色卡交写手时只列名字由写手读,主会话自写才读。久别角色读 `追踪/角色状态/{名}.md`;更旧信息按 workflow-daily「旧信息查找步骤」查。
3. **写前准备**:
   - **组装脚本**:跑 `{PYTHON} {skill 根}/scripts/build_writer_prompt.py --project {项目根} --chapter {N} --out`(`====` 以上为 prompt、以下为核对报告;exit 2 修完重跑,不手拼绕过)。
   - **状态筛选**:从续写状态卡取本章在场角色、要碰/要避的伏笔、下一章承诺与长期约束。
   - **召回**:核对报告写「召回降档:成立」时直接用脚本输出;不成立时完整读 [benchmark-recall.md](benchmark-recall.md) 执行全量召回。
   - **意图与硬伤确认**:一句话写清本章意图;细纲是唯一剧情蓝图,新增物按 SKILL.md「新增物三级」;后面才揭开的东西不因章尾钩子提前打出;细纲或剧情段标了「要补」时把补法写进本章意图,标了「有硬伤」先按 workflow-outline 修纲再写。
4. **资料研究**(按需):需查证外部事实时 spawn story-researcher 输出到 `参考资料/`,不可用则主会话查。
5. **标题预检**:核对报告报重名或明显重复时按核心事件改名,同步细纲标题与正文文件名。
6. **正文执行**:整章一次写完,批准内容写完即停,不为字数加剧情。已部署 narrative-writer 时按 [agent-calls.md](agent-calls.md)「写一章」派发并核对它只消费了批准情节点;未部署则主会话自写并自列新增物申报表。写完自查删改四类问题:工整对仗/金句点题;叙述者跳出来替读者点题、复述刚演过的情绪或照搬细纲结论(角色自己的利害盘算、因果说明与直白情绪正常保留,别改成手眼小动作);不改变局面的手眼/道具微动作代偿;章尾感悟升华或预告。
7. **检测收口**:
   - 细纲每个情节点**至少出现一次**,漏则退回补写。
   - 运行 `{PYTHON} {skill 根}/scripts/storyctl.py chapter check --project {项目根} --chapter {N} --fix-punctuation --plain`:一次整理标点并跑 AI 句式、退化(`check-degeneration.js`)、细纲照搬、字数与碎度/动作心理比(后两项仅参考)。改动后重跑,不再单调各检测脚本;工具未跑通则不提交并告知作者(缺 Node 提示装 Node.js 18+)。
   - **字数出了范围**:欠字不补、不重试,用下方字数问法请作者选;超字交 narrative-writer 按 agent-calls「超字一次净删」删一次(自写同样只删不加),复检仍超请作者选。选 1 → `chapter accept-current-length`(不到目标一半或超长未压缩被拒时先告知/先删一次,作者坚持加 `--force`);选 2 → 等作者改完细纲或目标后回本步;选 3 → 删本章正文与工作目录,不提交。
8. **检查钩子与爽点**:章尾有往下看的理由,推进/爆发章爽点到位;不达标只修批准内容,修后重跑「检测收口」。
9. **元信息扫描**:标题行以外清掉第X章、上一章、本章、前文、后文、伏笔、细纲、读者等工程词,改成角色感知的事件锚点。
10. **检测结果处理**:检测器的必须改与 checker 的 S1/S2 必须修;建议看与 S3 读原文确属问题才改(拿不准按类别查 `references/banned-words.md` 对应节,不整读);细纲照搬里判定保留的补进细纲「原样出现的原话」(旧名复沓锚句,不算改大纲)。改完重跑「检测收口」复扫。
11. **更新追踪**:跑 `{PYTHON} {skill 根}/scripts/tracking_commit.py draft --project {项目根} --chapter {N}` 预填 `tracking.json`,只填 `delta`、本章结尾时间/场景与变化的核心角色快照(`character_snapshots`),撤下的约束/风险写入 `delta.retired_context_items`;出错才读 [tracking-transaction.md](tracking-transaction.md)。再跑 `{PYTHON} {skill 根}/scripts/storyctl.py chapter commit --project {项目根} --chapter {N} --input {工作目录}/tracking.json`(接受当前长度换 `accept-current-length`)。判为「登记」的申报项一并提交;有「先问作者」项时暂停提交。「本章没写成的」:细纲没给的追加进本段排纲笔记「写纲时补的」,先问作者的走下方处置表。
12. **提交后核对**:返回 `tracking_committed: true` 即本章完成。

## 向作者汇报

按 SKILL.md「面向作者的汇报」,下列时机照模板说;`{}` 换成故事里的话,其余内部结论不说给作者。提交成功、本章完成后(日更批量改用 workflow-daily 批末汇报):

<!-- author-report -->
```md
第{N}章《{章名}》写好了,约 {字数} 字。
这章:{两三句讲发生了什么,停在哪个钩子上}。
{写前补了细纲两行就一句:「细纲没写这章要让读者感受什么,我按卷纲补了:{补的内容}」;没有就删掉此行}
{有需作者留意的新人物/新设定就一句话,如「加了个跑腿的小厮阿福,后面可能还会用」;没有就删掉此行}
{自查结论一句话:「自查过设定和前文,没发现冲突」或「发现一处前后不一:{什么},已按前文改正」}
{有习惯没带上就用原话说,核对报告拼好了就照说;没有就删掉此行}
下一章:第{N+1}章《{章名}》,要接着写吗?
```

字数一次处理后仍不在范围内时,请作者选,不自行补写:

<!-- author-report -->
```md
第{N}章《{章名}》写完了,比目标{少/多}了约 {差额} 字(目标约 {目标} 字,现在 {实际} 字)。{一句原因,如「细纲的事写完就到这儿了,硬凑会注水」}
你想怎么处理?
1. 就按现在的长度收下(推荐)
2. 我改细纲或字数目标,再重写这章
3. 这章不要了
```

不到目标一半时选项 1 不标推荐。新增内容需要作者拍板(下方处置表「先问作者」)时:

<!-- author-report -->
```md
第{N}章{写的时候多出了一样东西 / 写到一半想加一样东西,还没写},需要你定:{用故事话说是什么}。
它会牵动{后面哪段剧情或哪个已定安排,如「原定第三卷才揭开的那封信」}。
1. {留下 / 加上},我把后面的大纲一起改过来
2. {删掉 / 不加},按原细纲写
我建议选 {1/2}:{一句理由}。
这章先不算写完,等你定了再往下。
```

写不下去、要停下时:

<!-- author-report -->
```md
第{N}章还没法写:{白话说缺什么,如「这一章还没有细纲」}。
建议{一个动作,如「我先按卷纲把这章细纲补出来给你看」},可以吗?
```

## 质量检查

字数范围按 SKILL.md「记下本轮约束」。查三个维度:**情绪交付**(目标情绪是否兑现)、**钩子与爽点**(「检查钩子与爽点」)、**技术质量**(一致性、格式、禁用词;排查具体问题时才读 [long-chapter-quality.md](long-chapter-quality.md))。

**写后同轮清零**:同一轮内完成「检测收口」到「检测结果处理」,必须改的(含写后 hook 推回的毒句式)清零才算本章完成。**唯一豁免**:用户显式说"本章不去味/跳过检查"时,在该章标题行下加一行 `<!-- 去味:跳过 -->`(写后 hook 与下一章前的欠账拦截都认它)。退化类(复读、截断、拒绝语、工程词泄漏)只重写受影响段落,最多 2 次,仍失败按停下问法请作者定夺;故事内系统用语、弹幕、有功能的重复台词保留。

### Agent 调用:consistency-checker

**按需调用**:写手申报表非 `0`,或核对细纲时发现未申报的跨章事实(新证词、证据、承诺、关系变化)才在本章 spawn;否则日更批末核对时整批查一次(workflow-daily Step 3),非日更的单章写作在「更新追踪」提交前对本章查一次。Prompt 见 [agent-calls.md](agent-calls.md)。不可用则主会话自己核:申报项与跨章事实是否与细纲、角色卡、已登记追踪冲突;承诺与伏笔有没有被遗忘或无推进;有没有突然塞进大量新设定。

**新增物处置(主会话)**(正文定稿、追踪未提交时做)。checker 只给事实证据,归哪一栏由主会话判:

| 处置 | 判据 | 出口 |
|---|---|---|
| **登记** | 无必须修的冲突,也不属先问作者项 | 角色/势力按 workflow-outline.md「细纲后设定补全」补建静态档案、可复用设定补进 `设定/世界观/{主题}.md`,由主会话直接改设定文件(追踪事务不写设定);新伏笔按 SKILL.md「新增物三级」取下一个编号并追加进本卷伏笔表;伏笔、关系、约束、下章承诺进「更新追踪」事务的对应 delta 字段 |
| **修复** | 有必须修的冲突 | 退回写手就地改正文或删掉该新增物,最多一次 |
| **先问作者** | 先问作者项(SKILL.md「新增物三级」),或冲突要靠创作决策;「本章没写成的」里标先问作者的也走这行 | 按拍板问法问作者(已写的问留不留,没写的问「还没写,要不要加」);本章暂停提交及下一章。作者接受则按授权改卷纲/设定(没写的补写)后提交,不接受则删改后提交 |

申报为 `0` 仍做正文与细纲的正常核对,发现漏报照本表处置。

### Agent 调用:narrative-writer(去AI味审查)

**按需调用**:「检测收口」里像 AI 腔、要读原文判断的提示 ≥3 条,或必须改的一次就地修改后仍未清零,才 spawn 一次;否则主会话按「检测结果处理」改。Prompt 见 [agent-calls.md](agent-calls.md)。不可用(主会话自己写)时不读去味细则:逐条按检测器那条提示改,先判能否直接删(删后不丢伏笔、钩子、角色、情节和必要信息就删),会丢才改写;必须改的改到净,建议看的确属问题才改。语义提示仍多时照常收口,在汇报里建议作者之后另开对话用 `/story-deslop` 精修。

审查在本章提交前改的连续性事实直接进「更新追踪」的事务;提交后再改,按 workflow-revision:`draft --chapter {N}` 预填 → 改 → `chapter commit`。
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall