SuperAPI AI 工具集

story-maintenance

通用与其它

查看项目

更新于 10-15 20:32

技能介绍

用途:为 Story Skills 写作项目提供确定性维护。它只处理机械一致性,例如失效引用与过期登记表;判断发现对故事意味着什么、以及如何改稿,仍由 revision-continuity、plot-structure、voice-style、genre-craft 等创作技能负责。

用法:优先使用 story <command>;不可用时用 node scripts/story.js <command>,或 node <checkout>/bin/story.js <command>(仅限用户指定仓库检出时)。后两种要用绝对路径,并从本来运行 story 的目录执行,以保持相对路径含义。用 Node,不用 Bun,也不要运行检出包脚本。均不可用时按 references/conventions.md 手动维护。CLI 应就地运行,不要复制脚本进项目,也不要自建生成或批量写入脚本;项目保持 markdown 优先。命令在项目根运行,或显式传故事路径。

每次改动故事文件后按序运行:story reindex .、story wordcount . --write、story check .。check 只在错误时退出 1,警告不失败(--strict 则失败)。

主要能力:validate、reindex、wordcount、links、continuity(死亡/复活、承诺与线索顺序、契诃夫缺口、角色与状态、道具归属、时钟与路线)、compare、snapshot、similarity、progress、pacing、clues、voices、names、mentions、timeline、prose、series、knowledge、context、list、diagram、passes、report、next、doctor(--fix 只做机械修复)、migrate、import、export、build(markdown、EPUB、DOCX、Shunn、HTML、print、narration、metadata、Fountain、Twee、ink、codex),以及 add/rename/move/split/merge/remove 等实体与章节操作。多数命令支持 --json,便于读取结果。

适用场景:校验与修登记表、检查链接与连续性、统计与进度报告、节奏与线索审查、改名前后排查、生成结构图、导入既有稿件、导出与构建成品。

限制:只做机械一致性,不替用户决定剧情,不改散文;import --force 会先删除 chapters/ 下全部 chapter-NN.md,需确认;snapshot --restore 会删除快照缺失的 markdown 并移除空目录,应先 --dry-run 并经用户同意;破坏性或多文件命令先 --dry-run;add 的引用选项用 id(ASCII kebab-case)。完整命令与各命令标志可运行 story --help 或 story <command> --help,细则见 references 下对应文档。