Skip to content

zjs105910/workbuddy-market / bundled/novel-writing-suite/skills/story-long-write

story-long-write

Verified

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

FileKindSize
SKILL.mdskill md14.2 KB
references/agent-calls.mdmarkdown7.3 KB
references/anti-ai-writing.mdmarkdown36.3 KB
references/artifact-protocols.mdmarkdown14.5 KB
references/author-memory-maintenance.mdmarkdown8.6 KB
references/author-memory.mdmarkdown11.3 KB
references/banned-words.mdmarkdown10.2 KB
references/benchmark-recall.mdmarkdown5.5 KB
references/character-basics.mdmarkdown16.5 KB
references/character-design-methods.mdmarkdown15.9 KB
references/character-relations.mdmarkdown17.4 KB
references/commercial-core-methods.mdmarkdown20.2 KB
references/cross-book-recall.mdmarkdown7.1 KB
references/deslop-gates.mdmarkdown14.1 KB
references/dialogue-mastery.mdmarkdown11.5 KB
references/emotion-on-page.mdmarkdown4.6 KB
references/emotional-arc-design.mdmarkdown12.0 KB
references/emotional-methods.mdmarkdown9.9 KB
references/female-audience-writing.mdmarkdown11.2 KB
references/genre-prose-cards.mdmarkdown7.0 KB
references/genre-prose-cards/东方仙侠.mdmarkdown2.7 KB
references/genre-prose-cards/传统玄幻.mdmarkdown2.7 KB
references/genre-prose-cards/历史古代.mdmarkdown2.6 KB
references/genre-prose-cards/历史脑洞.mdmarkdown2.9 KB
references/genre-prose-cards/双男主.mdmarkdown3.2 KB
references/genre-prose-cards/古言脑洞.mdmarkdown2.6 KB
references/genre-prose-cards/古风世情.mdmarkdown2.6 KB
references/genre-prose-cards/女频悬疑.mdmarkdown2.6 KB
references/genre-prose-cards/女频种田.mdmarkdown2.6 KB
references/genre-prose-cards/宫斗宅斗.mdmarkdown2.5 KB
references/genre-prose-cards/年代.mdmarkdown3.0 KB
references/genre-prose-cards/快穿.mdmarkdown2.8 KB
references/genre-prose-cards/悬疑灵异.mdmarkdown2.6 KB
references/genre-prose-cards/悬疑脑洞.mdmarkdown2.7 KB
references/genre-prose-cards/战神赘婿.mdmarkdown2.7 KB
references/genre-prose-cards/抗战谍战.mdmarkdown2.7 KB
references/genre-prose-cards/星光璀璨.mdmarkdown2.7 KB
references/genre-prose-cards/民国言情.mdmarkdown2.8 KB
references/genre-prose-cards/游戏体育.mdmarkdown2.8 KB
references/genre-prose-cards/玄幻脑洞.mdmarkdown2.9 KB
references/genre-prose-cards/玄幻言情.mdmarkdown2.5 KB
references/genre-prose-cards/现言脑洞.mdmarkdown2.7 KB
references/genre-prose-cards/科幻末世.mdmarkdown2.6 KB
references/genre-prose-cards/职场婚恋.mdmarkdown2.6 KB
references/genre-prose-cards/西方奇幻.mdmarkdown2.8 KB
references/genre-prose-cards/豪门总裁.mdmarkdown3.3 KB
references/genre-prose-cards/都市修真.mdmarkdown2.5 KB
references/genre-prose-cards/都市日常.mdmarkdown3.7 KB
references/genre-prose-cards/都市种田.mdmarkdown2.5 KB
references/genre-prose-cards/都市脑洞.mdmarkdown3.4 KB
references/genre-prose-cards/都市高武.mdmarkdown2.9 KB
references/genre-prose-cards/青春甜宠.mdmarkdown2.7 KB
references/genre-readers.mdmarkdown10.7 KB
references/long-chapter-hooks.mdmarkdown8.6 KB
references/long-chapter-quality.mdmarkdown8.6 KB
references/long-format.mdmarkdown2.5 KB
references/long-genre-catalog.mdmarkdown17.0 KB
references/long-genre-mechanics.mdmarkdown17.0 KB
references/long-reversal.mdmarkdown15.2 KB
references/long-suspense.mdmarkdown15.2 KB
references/opening-design.mdmarkdown12.5 KB
references/outline-conflict.mdmarkdown17.2 KB
references/outline-methods.mdmarkdown10.6 KB
references/outline-rhythm.mdmarkdown12.6 KB
references/outline-structure-theory.mdmarkdown12.4 KB
references/plot-core-methods.mdmarkdown19.8 KB
references/plot-emotion-system.mdmarkdown15.5 KB
references/plot-frameworks.mdmarkdown27.1 KB
references/plot-special-topics.mdmarkdown25.0 KB
references/project-files.mdmarkdown11.6 KB
references/reader-contract-and-progression.mdmarkdown11.3 KB
references/reference-index.mdmarkdown6.0 KB
references/stop-and-fix.mdmarkdown940 B
references/style-combat-face.mdmarkdown16.9 KB
references/style-craft.mdmarkdown13.1 KB
references/style-genre-modules.mdmarkdown24.2 KB
references/style-resolution.mdmarkdown3.9 KB
references/tracking-initialization.mdmarkdown1.3 KB
references/tracking-transaction.mdmarkdown14.9 KB
references/workflow-chapter.mdmarkdown14.4 KB
references/workflow-daily.mdmarkdown7.5 KB
references/workflow-outline.mdmarkdown20.7 KB
references/workflow-revision.mdmarkdown6.6 KB
references/workflow-setup.mdmarkdown13.4 KB
references/workflow-volume.mdmarkdown17.1 KB
references/writer-prompt-fallback.mdmarkdown3.5 KB
references/writing-craft.mdmarkdown28.1 KB
scripts/author_memory_commit.pyscript77.9 KB
scripts/build_architect_brief.pyscript15.8 KB
scripts/build_writer_prompt.pyscript31.8 KB
scripts/check-ai-patterns.jsscript73.5 KB
scripts/check-degeneration.jsscript14.8 KB
scripts/check-outline-contract.jsscript23.4 KB
scripts/check-outline-copy.jsscript13.0 KB
scripts/normalize-punctuation.jsscript13.2 KB
scripts/outline_view.pyscript11.8 KB
scripts/storyctl.pyscript25.0 KB
scripts/style-whitelist.jsscript1.1 KB
scripts/tracking_commit.pyscript81.8 KB
scripts/wordcount_core.pyscript17.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`、登记了对标却缺情绪模块/节奏时,读 [stop-and-fix.md](stop-and-fix.md) 照做(作者定了不对标不算缺,组装脚本会报「召回降档:成立,无对标」,照它走);修好再从步骤 1 开始。

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

---

## 单章写作流程

新书还没有 `_tracking-state.json` 时先按 [tracking-initialization.md](tracking-initialization.md) 初始化;已有正文却缺它,按 stop-and-fix 停下修。

1. **检查细纲**:读 `大纲/细纲_第{N}章.md` 全文,取「单元ID/位置」,跑 `outline_view.py --unit {单元ID} {卷纲路径}` 取卷契约、全卷常任裁定、当前剧情单元与终局底牌边界(日更同单元本批复用,不重跑)——**不整读卷纲**。细纲缺失或缺九个必填字段时**先补建再写**:按 workflow-outline.md 细纲模板补齐九个必填字段和四个小节,无证据的写 `[待补充]`,补完跑 `check-outline-contract.js` 验收。
2. **读取上下文**:`tracking_commit.py check`(取 `last_committed_chapter` / `state_revision`,完整 state 不进 prompt)→ `追踪/上下文.md` 全 7 栏 → 细纲点名的 `设定/势力/`、`设定/世界观/` 相关条目(为「必读设定」槽摘句);角色卡交给写手时只在「涉及角色」列名字、由写手读,主会话自己写时才读。上一章结尾由脚本代读,承接存疑才自己读。久别角色读 `追踪/角色状态/{名}.md`;更旧的信息按 workflow-daily「旧信息查找步骤」定点查。
3. **写前准备**:
   - **先跑组装脚本**:`{PYTHON} {skill 根}/scripts/build_writer_prompt.py --project {项目根} --chapter {N} --out`。`====` 以上是 prompt、以下是核对报告;退出码 2 =数据问题,修完重跑,不手拼绕过。
   - **状态筛选**:从续写状态卡取本章在场角色、要碰/要避的伏笔、必须履行的下一章承诺与相关长期约束,写成本节速记。
   - **召回**:核对报告写「召回降档:成立」时直接用脚本给的情绪/节奏;不成立时才完整读取 [benchmark-recall.md](benchmark-recall.md) 执行全量召回。
   - **意图确认**:一句话写清本章意图(例:「快节奏打脸——账单暴露→逼问→反证→公开代价」)。对照:细纲是唯一剧情蓝图,新增物按「新增物三级」;底牌不因章尾钩子提前泄露;细纲重复的同一要求只兑现一次;爽点前有可指认的铺垫,打脸/揭露章写在场配角的差异反应。
   - **契约风险**:细纲或单元卡标了需补强,把单元卡写的补强办法(交换、铺垫或成本)写进本章意图;标了契约破坏,先按 workflow-outline 补纲流程修纲再写;标契约安全的写前不重问,写后在步骤 9 核。
4. **资料研究**(按需):需查证外部事实时 spawn story-researcher 输出到 `参考资料/`,不可用则主会话查。
5. **标题预检**:看核对报告的重名结论;重名或明显重复才按核心事件改名,并同步细纲标题与正文文件名。
6. **写作准备**:交给写手时按 [agent-calls.md](agent-calls.md)「写一章」分前后两组交付;主会话自己写时也分两组:前组写到 `前组.md` 后跑一次 `storyctl.py wordcount checkpoint --file {前组} --project {项目根} --chapter {N}`,后组按 `remaining_user_range` 收、原文拼接;作者要一次成文才写全章。批准内容写完即停,不为字数加剧情;实际长度由步骤 8 收口。
7. **正文执行**:已部署 narrative-writer 时按 [agent-calls.md](agent-calls.md)「写一章」填槽交给它,交付后核对它只消费了批准情节点。未部署则主会话自己写:不填槽,按脚本输出与本节速记直接写,新增物自列申报表。写完逐段再看一遍检测器抓不住的三类 AI 腔:用工整对仗或金句替读者点题;叙述者跳出来总结情绪、解释动机、说出细纲的结论;章尾用感悟、升华或预告收。遇到就删,或改成人物的动作、对话、物件,让读者自己看出来。
8. **核情节点落点,再一次检测收口**:
   - 细纲每个情节点**至少出现一次**,漏即退回补写批准内容。不以字数为由。
   - 运行 `{PYTHON} {skill 根}/scripts/storyctl.py chapter check --project {项目根} --chapter {N} --fix-punctuation`:一次整理标点并跑 AI 句式、`check-degeneration.js` 退化、细纲照搬与字数检测(去味管线:检测器 → 选 Gate → 一次定点改写 → 复扫);文件改动后重跑,不再分别调各检测脚本。
   - 按返回的 `status` 走:`ready` → 完成步骤 9-12 再提交。`blocked` / `invalid`(退出码 1)→ 就地修净再重跑。`needs_decision`(字数出带)→ 看 `available_actions`:欠字不补不重试,按字数问法请作者选;超字把删除区间随 `compress-once` 交 narrative-writer 一次净删、零新语义,复检仍带外也请作者选。`tool_unavailable`(退出码 3,见 `quality.tool_errors`)→ 不能提交、无绕过,用停下问法告诉作者要装 Node.js 18+ 才能做写后检查。退出码 2(`status: error`)按 `error_code` 修命令。
9. **检查钩子、爽点与契约**:章尾有往下看的理由(低压/过场章留阶段目标即可);高压/推进章爽点到位;对着成稿过契约四问——主角是否靠自己的选择挣到本章结果?收益是否被配角、机构或巧合无交换地拿走?有没有提前动用后面的底牌?旧期待付利息、留新期待了吗?任一问不过就按问改:没挣到→让结果落在他的选择或判断上;收益被拿走→补交换或让他拿回控制点;提前用了底牌→换成本卷已解锁的手段;没付利息→给旧期待一个小兑现再留新钩。不达标只修批准内容,修后重跑步骤 8;需补强、契约破坏都在本章汇报里告诉作者。
10. **元信息扫描**:标题行以外清掉第X章、上一章、本章、前文、后文、伏笔、细纲、读者这类工程词,改成角色能感知的事件锚点(「比第一章那三秒开火更疼」→「比那三秒开火更疼」);角色真实读到「第X章」或本身是作者/读者的除外。
11. **检测结果处理**(选 Gate 与定点改写):严重度读作必须修 / 建议看 / 仅提示——检测器 blocking 与 checker 的 S1/S2 必须修,advisory 与 S3 建议看,S4 仅提示。`quality.blocking_findings` 就地改到净;`advisories` 逐条读原文判断,确属问题才改,不为归零机械改写。`formulaic-parallelism` 连同台词一起复核;细纲照搬里判定保留的补进细纲「复沓锚句」(这是登记,不算改大纲,不用暂停问作者)。禁用词表不整读,拿不准的二级词才查 `references/banned-words.md` 对应条目。改完只重跑步骤 8 复扫,不另安排全篇去味。
12. **更新追踪**:运行 `{PYTHON} {skill 根}/scripts/tracking_commit.py draft --project {项目根} --chapter {N}`,预填工作目录 `tracking.json`,并给出在场核心角色的当前快照和每类条目的样板(`shapes`)。只填 `delta` 与留空的本章结尾时间、场景:变化的核心角色(含本章首次进场的核心角色,草稿里没有就新建一份)把快照整份改好放进 `character_snapshots`;撤下的长期约束或风险从 `context` 删掉并把原文列进 `delta.retired_context_items`。不读脚本源码或 state 找格式;出错或 `mode=revision` 时才读 [tracking-transaction.md](tracking-transaction.md)。带内执行 `{PYTHON} {skill 根}/scripts/storyctl.py chapter commit --project {项目根} --chapter {N} --input {工作目录}/tracking.json`,作者接受当前长度把 `commit` 换成 `accept-current-length`。报错按提示改完重跑同一命令;体积超目标只是提醒,逐章记录写要点即可,不必为它删改。判为「登记」的申报项在这次事务里一并登记;有「先问作者」项时暂停提交与下一章。「本章没写成的」:细纲没给的追加进本单元排纲底稿「建纲追加」,先问作者的走下方处置表。
13. **提交后核对**:返回 `tracking_committed: true` 即本章完成。

## 向作者汇报

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

<!-- author-report -->
```md
第{N}章《{章名}》写好了,约 {字数} 字。
这章:{两三句讲发生了什么,停在哪个钩子上}。
{有需作者留意的新人物/新设定就一句话,如「加了个跑腿的小厮阿福,后面可能还会用」;没有就删掉此行}
{这章主角的功劳被别人拿走、或提前用了后面的底牌时,一句话说哪里、怎么补或要不要改纲;没有就删掉此行}
{自查结论一句话:「自查过设定和前文,没发现冲突」或「发现一处前后不一:{什么},已按前文改正」}
下一章:第{N+1}章《{章名}》,要接着写吗?
```

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

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

不到目标一半时选项 1 不标推荐。作者选 1 → `chapter accept-current-length`;选 2 → 等作者改完细纲/目标后回步骤 8;选 3 → 删本章正文与工作目录,不提交。收下被拒时:`BELOW_ACCEPT_FLOOR` 告诉作者差多少字,问补写还是就要这个长度;`COMPRESSION_REQUIRED` 先按 `compress-once` 删一次。作者知道原因仍坚持才加 `--force`。新增内容需要作者拍板(下方处置表「先问作者」)时:

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

写不下去、要停下时:

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

## 质量检查

字数范围按 SKILL.md 写前必读第 4 条。三个维度:**情绪交付**(交付了目标情绪吗)、**契约风险**(步骤 9 契约四问)、**技术质量**(一致性、格式、禁用词;排查具体问题时才读 [long-chapter-quality.md](long-chapter-quality.md))。

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

### Agent 调用:consistency-checker

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

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

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

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

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

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

审查在本章提交前改的连续性事实直接进步骤 12 的事务;提交后再改,按 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: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated 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: 196kUpdated Claude CodeCodexVerifiedInstall