用途:规划和管理故事弧、情节点、铺垫与回收以及叙事时间线。每个弧是 plot/arcs/ 下的 Markdown 文件,plot/timeline.md 按故事顺序保存计划事件与背景故事,plot/_index.md 列出所有弧、状态和主题覆盖。
前提:项目须已存在(由 story-init 技能创建),通过项目根目录的 story.md 验证。
主要能力:依据 story.md 的体裁、主题和形式选择结构,参考 references/structure-models.md,默认三幕;短篇和闪小说改用 references/short-story-form.md;需要自上而下设计或雪花法时参考 references/snowflake.md。创建弧时询问名称、类型、涉及角色、服务主题和 MICE 线索,用 story add arc 生成文件后填写。情节点存于弧文件的表格,并同步到时间线。时间线用 | When | Event | Arc | Chapter | 表格按时间顺序维护。
节奏与回收:场景 outcome 取 yes、no、yes-but、no-and,章节 hook 取 cliffhanger、question、revelation、reversal、decision、emotional、resolution;用 story pacing . 查看每章仪表盘。铺垫记录按用途分别放入 continuity/clues、continuity/promises、continuity/questions,或弧的 Foreshadowing 表、continuity/motifs.md。
用法:可用时使用 Story CLI,未安装则用捆绑的 node ../story-maintenance/scripts/story.js,参数相同;仅在用户指定仓库检出时用 node <checkout>/bin/story.js。常用命令包括 story reindex .、story wordcount . --write、story check .、story grid .、story timeline .、story diagram timeline、story diagram arcs、story context、story next .、story clues .、story move scene、story move chapter。重排前须向用户展示新顺序并等待批准,用 CLI 移动而非重命名。
限制:无 CLI 时需手动完成注册表、反向链接和字数检查;beat 字段为自由文本,超过 60 字符会警告;弧表由 story reindex 重建,不可手改;move 不重写 Ch {N} 单元格、正文或大纲 beat,需手动更新。其他细节暂未提供。