zenstory-ai/oh-story-claudecode / skills/story-long-write
story-long-write
Verified长篇网文规划与写作。支持只讨论结构、只写大纲或指定细纲,明确要求正文后再写章节。触发方式:/story-long-write、/写长篇、「帮我开书」「定设定」「出卷纲」「规划剧情」「写大纲」「补细纲」「日更」「续写」「继续写」「修改第X章」「回炉」「重写第X章」。
references/workflow-outline.md
View on GitHub# workflow-outline.md:出细纲(按剧情批出细纲、补纲)
> 谁读:主会话出细纲、补纲时整份读;「排纲方法」一节进 story-architect 细纲任务包。
## 主会话:出细纲的步骤与汇报
卷纲只用 `outline_view.py --unit {单元编号}` 取全卷段与本段剧情(老卷纲有「作用域:批次底稿」段时加 `--stage outline`),设定从 `设定/` 定点读,不回翻对话;参考文件按 SKILL.md「写前必读」总表「出细纲、补纲」一行读。
已部署 story-architect 时,每批细纲在它的新上下文里出,调用见 [agent-calls.md](agent-calls.md)。没有子代理时主会话按下方「排纲方法」自己出:先给本批走向提案,作者确认后写入文件。
**收回与验收**:每章细纲写入后跑 `node scripts/check-outline-contract.js --json --project {书目录} --chapter {N}`(查什么见 outline-template.md)。exit 1 只按 `repair_scope` 补报告点名的字段再复验,最多两轮;仍失败就报告检查 ID 停下,不改其他章。advisory 项逐条人工判断,不强制归零。exit 2、脚本缺失或 node 不可用时如实报告验收未完成,不得声称细纲已合规。出完一批另跑一次 `node scripts/check-outline-contract.js --json --supply {卷纲路径} {单元编号}`,验证排纲笔记里有「写纲前查缺」(含「无缺口」情形);脚本只验小节存在,内容仍要人工判断。本检查只在新建、补建、回填时执行;既有项目的旧细纲不因此阻断写正文。
**中途补纲/扩纲小流程**(项目已有大纲;只改细纲不进入正文大修):
1. 定位请求范围、已写进度和所属剧情段:读 `大纲/大纲.md`;卷纲先用 `outline_view.py --toc {卷纲路径}` 定位,再 `--unit {单元编号}` 取闭包,尚无剧情段用 `--contract` 取全卷段,不整读。另读 `设定/题材定位.md` 和已有 `追踪/上下文.md`;有正文却缺追踪时停止补纲,提示按 workflow-daily 修复/迁移,不猜进度;无正文也无追踪时以现有纲/设定规划,不为读取状态先初始化。
2. 请求章已属于既有剧情段时复用这张卡,只补/改点名细纲,不另建剧情段;沿用「细纲锁定」。确需新剧情段先按 workflow-volume.md 追加卡(含「对标节奏迁移」选同类剧情),向卷尾**追加**卡及情绪弧线、故事线、伏笔规划,已锁定内容不动。新故事线先加进卷纲故事线表并写清在哪并回主线,再供细纲引用;日更不自动扩纲。正文里新长出的伏笔怎么编号见 SKILL.md「新增物三级」。用户补纲不等于授权修改其他章;超出本卷体量时先确认扩卷或开新卷。
3. 追加剧情段时答 workflow-volume.md「排纲自查」四项(按段内 1/4·中点·3/4 口径);进入细纲层时先做下方「写纲前查缺」。
4. 按本次交付层级停止:需要细纲时按批次边界只做请求范围,完成「细纲后设定补全」与批末复核。
5. 规划事件和未来揭示只落卷纲/细纲,不提前成为追踪事实。已有正文项目补纲不写 `追踪/`,不执行 init/commit;下一章必须履行的承诺在下一次正文事务里进入 `next_chapter_commitments`。
**向作者汇报**(开书、大纲、卷纲、细纲、补纲、改细纲都用这一份;按 SKILL.md「面向作者的汇报」):写纲前查缺、批末复核是内部核对,只把结论翻成故事话;要问作者的缺口,以及设定互相冲突的情况,都作为「要你定的事」问。出细纲后最后一句建议新开对话说「写第N章」。
<!-- author-report -->
```md
{做了什么,如「第二卷卷纲定好了」「补好了第22-26章细纲」「按你说的改了第23章细纲」}:
- {故事层要点,一行一件:这卷/这几章主要发生什么,主角得到或失去什么,停在哪个悬念上}
- {改细纲时:原来是什么,现在改成什么,会不会牵动别的章}
{某段剧情主角的功劳被别人拿走、或提前揭开、用掉了后面才该揭开的东西时一句话说清,如「第三段剧情里功劳落到了师父身上,我先把纲改成主角自己拿主意」;没有就删掉此行}
{前面吊起的期待还没兑现时说清哪章兑现;没有就删掉此行}
{要你定的事:一句问题+白话选项+推荐,如「主角的金手指每天能用几次?1. 一次(推荐,后面好加码)2. 不限次」;没有就删掉此行}
下一步:{如「要接着写第22章正文吗?」「要继续出第27-31章细纲吗?」}
```
---
## 排纲方法:批次、设定补全与分批
所请求范围内每章必须有 `大纲/细纲_第XXX章.md`,不跳章。细纲按剧情批构建(见本节末「按剧情批出细纲」);仅未限定范围的完整开书默认前 10 章,其他按 SKILL.md 的范围与停点交付:
1. **批次边界**:未指定章数时,一批 ≈ 一段剧情;>10 章拆两批。开书时前 10 章为一批、可跨段;每段建卡时召回一次,后续批共享结论。用户指定章数/范围时,只建范围内细纲,不因剧情段未完或剩余 ≤2 章而扩批;单批仍建议 ≤10 章。写正文缺纲按 workflow-chapter 开头处理。
2. **批次定位**(每一批补纲前先写进排纲笔记):当前章节区间属于哪个阶段与哪段剧情、这一批推进什么、可以揭开什么、先压住什么、章尾钩子不能越过的边界。
3. **写纲前查缺**:每批出细纲前查六项:①对手戏由谁接?对抗推进段具名对手隔了 2 章以上没出现是复核提示;对手可为盟友或亲人,秘境探索、种田经营、闭关突破、查案搜证与温情日常段不为凑间隔硬塞反派。②未来 3 章出场角色的设定卡齐不齐?③能力的新增和已有的接不接得上?④本批要用的数字、制度、规矩、距离与脚程在设定里真有没有?引用前检索核对具体条目,不能只猜文件存在。⑤本批用到的地点先落档;只提名不强补场景布局。是否和上一段同场景、同对手、同胜负手连排,要不要调?⑥本批推进哪几条故事线,还有没有能调的存货?结果以「写纲前查缺」小节写进书目录下的 `.story/排纲笔记/{剧情段编号}.md`(模板见 outline-template.md「排纲笔记」,不进卷纲):补上并记下的写清补了什么、落在哪个设定文件;要问作者的列候选及影响面;没缺写「无缺口」。并检查上一批「本章没写成的」与「写纲时补的」里还没解决的缺口。
4. **用卡排章**:建卡那批读这段剧情「参考对标书哪段剧情」指向的对标剧情(≤3 个文件,含结构分布/情节点索引),按「这段怎么排」铺章、情节点换素材;同一段的后续批共享卡里定下的结论,不重读对标剧情。当前卷纲缺少必需的剧情段字段时先补齐卷纲,不带缺失字段进入日更。
5. **写纲当场缺东西**:按下方「缺东西时三种处理」——能直接写的写进细纲,补上并记下的先落档再引用,要问作者的挂起受影响内容,其余部分继续。批末把后两种汇进同一份排纲笔记的「写纲时补的」:章号、缺什么、怎么处理、设定路径或提案;没有写「无」。直接写的现场材料不重复记录。
6. **批末复核**(每批建完必做):七个必填字段和可执行情节点齐全;「这章不能说破」可不写。不得用“每个情节点固定等于多少字”预测容量或自动补事件。结构检查脚本由主会话跑,报告点名哪个字段就只补哪个。**旧章细纲缺字段是常态,不要照抄同目录既有文件的字段集**,以 outline-template.md 为准。内容好坏不设脚本检查。
不强行一次产出 30 章细纲;全书 ≤30 章且用户明确要全书细纲时,可分批连续交付。
### 细纲模板与验收
模板、字段说明(哪些字段被脚本按名读取)与验收口径见 [outline-template.md](outline-template.md)「细纲」;排纲笔记模板见同一文件「排纲笔记」。新建、补建、回填都照它补齐。
**细纲锁定**:已写正文的章细纲锁定,未经用户确认不得修改;未写的章细纲可随正文反馈微调,改了写进汇报。已进入正文的卷的卷纲锁定规则见 workflow-volume.md。
**细纲质量要求**:七个必填字段齐备,强度按松紧分配(写法要求与松紧配额见 outline-template.md 与 outline-methods「每章松还是紧」);底线是每章都给读者一个往下看的理由、相邻章情绪不雷同。无法从材料确定的关系或副线写 `[待补充]`,不得杜撰。单章默认字数见 outline-methods「排纲刻度」。
> **细纲钩子来源**:优先沿本批剧情段「参考对标书哪段剧情」的走法与兑现方式设计钩子链;对标登记 ≥2 本时读 `cross-book-recall.md`,副对标同基调 `章节/*_摘要.md` 仍可作单章钩子灵感(可选)
**章节标题规则**:章名取本章最有冲突或最有梗的那条信息,不用「开始」「觉醒」这类概括词,也不把本章的兑现剧透出来。只做轻量去重;发现同名或明显重复标题时,按本章核心事件改名,并保持细纲标题与正文文件名一致。
**细纲后设定补全(每批细纲建完后执行)**:扫描本批细纲新出现的**会复用**具名角色/势力/关键设定,自动建档(一次性路人不建;已有设定按新信息增量补充、不覆盖):
- 角色 → `设定/角色/{名}.md`(模板见 character-basics.md);核心复用角色进入正文后由追踪事务建 `追踪/角色状态/{名}.md`;
- 势力/组织 → `设定/势力/{名}.md`;
- 影响多章的世界观规则与**刻度名目**(资质档位、职级待遇、货币物价、等级进度、名次席位、赏罚、时限,写成可数序列而非孤立值)→ `设定/世界观/{主题}.md`。
**缺东西时三种处理**:先查 `设定/世界观/`、`设定/势力/`、`设定/题材定位.md` 是否已有(含同义异名),再按 SKILL.md「新增物三级」分流——**直接写**进细纲不落档;**补上并记下**先落设定再供细纲引用(书目录相对路径如 `设定/角色/张三.md`),记入排纲笔记「写纲前查缺」;**问作者**在「写纲前查缺」列缺口、1-2 个候选及影响,批末用故事话问作者,不临时编数。
### 按剧情批出细纲(细纲分批边界)
一批细纲对应卷纲一段剧情,章数按段字数除以单章目标字数估算。建卡时做一次**剧情批召回**:读这段「参考对标书哪段剧情」指向的对标剧情(≤3 个文件)的「结构分布」「情节点索引」,回查该书 `剧情/节奏.md` 同区间爽点循环与被引情绪模块卡,提炼 5-8 拍共性节拍写入卡的「这段怎么排」,对照主对标 `剧情/情绪模块.md` 校准「这段让读者图什么」(单个模块卡未命中可跳过,主产物缺失按 benchmark-recall.md 处理;换素材与修硬伤同 workflow-volume.md「对标节奏迁移」步骤 3、4)。结论写入卡后,逐章细纲只用卡,不重读对标剧情。
排纲当场发现的缺口按上文「缺东西时三种处理」,批末汇进排纲笔记「**写纲时补的**」(步骤 5);下一批写纲前查缺固定读它。日更中途发现卷纲缺「参考对标书哪段剧情」等必需字段时,先补齐卷纲再建细纲(锁定卷纲停在补纲边界)。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |