story-review

多视角对抗式审查。full/lean 模式在已部署 reviewer agents 时并行 spawn;缺失/异常 agents 或 spawn 失败时自动降级 solo,参考文件不可读时使用内置 rubric fallback。触发方式:/story-review、/审查、「审查一下」「帮我审一下」。

By zenstory-ai · 12,996 installs

npx skills add zenstory-ai/oh-story-claudecode --skill story-review

Source repository · Upstream listing

story review:多视角对抗式审查 Spawn 版本提示(不阻断 spawn):先读取项目根 .story deployed 的 agents version 。与本版 agents version: 37 不一致时(标记缺失、字段缺失/非整数、小于或大于 37) 照常按当前宿主角色来源检查并 spawn ;同时在「这次怎么审的」里用一句白话提示作者「审稿助手是旧版,运行 /story setup(ZCode 先更新插件)后新开会话」, Notice: agents bundle 版本不匹配(项目 {N},本版 37) 原文写进技术备注行;大于 37 时额外提示先更新 oh story claudecode,不要用本地旧版 setup 降级覆盖。版本提示本身不触发降级;文件缺失或异常、工具不可用、递归限制或调用失败按 Phase 0 处理,技术备注写 Fallback: ... solo 。 你负责协调审查,找出小说的结构、角色、文字与设定问题,给出有原文依据的修改建议。 执行铁律:审查是找问题,不是验证正确性。 文风裁决 :先读 [references/style resolution.md](references/style resolution.md),加载本书文风,复用调用方的 style resolution 与作者偏好;单独调用时按当前请求与本书文风裁决。同一裁决交给后续执行者。 作者偏好边界 只接收调用方已有的作者偏好,不查询或记录作者记忆;独立调用时不加载记忆文件。偏好只能帮助解释意图和组织报告,不能降低 rubric 严重度、把事实冲突判为无问题或跳过平台门禁;当前请求仍优先。 Review Mode 选择 /story review 或 /story review full → 优先 spawn 全部 4 个 Agent;如果当前已经在子代理内,核心 Agent 未部署/异常,或 spawn 失败,自动降级为 solo。 /story review lean → 优先 spawn story architect + consistency checker ;如果当前已经在子代理内,任一所需 Agent 未部署/异常,或 spawn 失败,自动降级为 solo。 /story review solo → 不 spawn Agent,由当前会话执行基础审查。 Phase 0:预检与降级(必须先执行) 1. 确定请求模式 :解析用户输入中的 full 、 lean 、 solo ;未指定时目标模式为 full 。 2. 确认是否允许 spawn :如果当前已经在子代理/Agent 内执行,不再递归 spawn,直接降级为 solo 。 3. 识别当前宿主的角色来源 :ZCode 支持插件子代理,检查当前已启用插件注册的同名角色,不要求 .zcode/agents/ 。其他宿主按下一步查本端目录;不因宿主名、部署标记包含 zcode 或其他端目录存在而降级。 4. 检查核心 Agent 可用状态 (仅查当前宿主来源): Claude Code .claude/agents/ 、OpenCode .opencode/agents/ 、Codex .codex/agents/ 、Antigravity .agents/agents/ ;ZCode 查注册角色的定义,不拿项目文件存在性代替运行时注册 full 必需 agent: story architect 、 character designer 、 narrative writer 、 consistency checker lean 必需 agent: story architect 、 consistency checker 对每个必需 Agent: Claude Code agent( .claude/agents/ ) :读取 frontmatter,确认 name: 与 subagent type 完全一致;frontmatter 缺失、不可解析或 name 不匹配时视为 malformed agent。 OpenCode agent( .opencode/agents/ ) :文件名即 agent 名(OpenCode 不要求在 frontmatter 中写 name: ),读取 frontmatter 确认 mode: subagent 和 permissions: 规则列表存在且可解析即可(2.x 用复数 permissions: ,旧版单数 permission: 视为待重新部署);frontmatter 缺失或不可解析视为 malformed。 Codex agent( .codex/agents/ ) :文件名为 {agent}.toml ,TOML 必须可解析,且包含 name 、 description 、 developer instructions ; name 必须与目标 agent 完全一致。 Antigravity agent( .agents/agents/ ) :路径为 .agents/agents/agent name/agent.md ( agent name 为目标 agent 名),frontmatter 必须可解析,且 name 与目标 agent 一致、 mainAgent: false 、 subagent: true 、 tools 非空;缺失或不匹配视为 malformed。 ZCode plugin agent :注册名与目标角色一致;可读定义须有可解析的 name 、 description 和正文。定义不可直接读时以运行时注册为准,不扫描其他端文件。 任一必需角色缺失或 malformed 时不尝试派发,降级 solo ;白话说明助手缺失或损坏,并建议当前宿主重部署(ZCode 更新/启用 oh story 插件后新开会话)。 missing agents solo / malformed agents solo 与问题角色/文件写进技术备注 Fallback、Files 两栏。 5. 确认 Agent 工具可用 :Claude/OpenCode/Codex 需要当前运行时的子 Agent/Task 工具,Antigravity 需要 invoke subagent ,ZCode 用 Agent 按当前 schema 派发注册角色;不可用时降级 solo ,技术备注写 Fallback: agent tool unavailable solo 。 6. 运行时失败降级 :如果任何 Agent spawn 返回失败、 subagent type / agent / agent type / TypeName 不可用、frontmatter/TOML 运行时解析失败或子 Agent 无法启动,停止继续 spawn,改用 solo 重新审查,技术备注写 Fallback: spawn failed solo 与失败的 agent 名;不要把部分成功的 Agent 结果当成 full/lean 结论。 7. 确定实际模式 :请求模式与实际模式都写进报告末尾的技术备注行。 审查基准与参考资料规则(必须遵守) 参考文件补充审查标准;不可读时使用下方内置基准包。 报告面向作者(必须遵守) 报告写给作者:审了什么、哪里要改、为什么(用读者感受和故事后果说,附原文引用)、要作者拍板的事、下一步。reviewer 名、S1–S4、Gate、检测器类别名、脚本名、PASS/FAIL、文件字段名不进正文;位置写「第 N 章「引文」」或「第 N 章第 M 段」。优先级换成白话(小节标题照模板):S1、S2 → 必须改 ,S3 → 建议改 ,S4 → 可以不改 。执行路径只写在报告最后一行,格式固定: 参考资料解析顺序 可读取参考文件时,按以下顺序尝试,第一个命中即用: 1. {项目根}/.claude/skills/{规范路径} (Claude Code 项目内安装) 2. {项目根}/.opencode/skills/{规范路径} (OpenCode 项目内安装) 3. {项目根}/.codex/skills/{规范路径} (Codex 项目内安装) 4. {项目根}/.zcode/skills/{规范路径} (ZCode 项目内安装) 5. {项目根}/skills/{规范路径} (OpenClaw / Reasonix / generic 部署,也是本仓库开发环境) 6. {项目根}/.agents/skills/{规范路径} (Antigravity 项目内真实 skill root;Codex / Reasonix 也可能扫描此目录或其 symlink) 7. 当前运行时加载本 skill 的目录,或其可访问的全局 skill 搜索路径中同名 {skill name}/... 目录 靠前几层不存在是正常的,不是部署损坏。 /story setup 会为 Antigravity 把 13 个 skill 真实复制到 .agents/skills/ ,为 ZCode 复制到 .zcode/skills/ ,并为 OpenClaw / Reasonix / generic 复制到 skills/ 。Codex 项目部署不复制 skill 本体,本 skill 由 Codex 从 skill root 加载,references 通常命中第 6 或第 7 层。不要手工把 references/ 复制进 .codex/skills/ ——手工副本不受 story setup 管理,升级后会静默变旧。 规范路径如下;禁止只写裸文件名,禁止跨 skill 误读其他 skill 的 references: 用途 规范路径 通用内容评分 rubric story review/references/quality rubric.md 去 AI 味方法 story review/references/expression.md · story review/references/narrative focus.md · story review/references/story logic.md 词句信号索引 story review/references/banned words.md 平台 rubric story review/references/rubrics/{fanqie,qidian,zhihu}.md 标点预检脚本 story review/scripts/normalize punctuation.js AI句式预检脚本 story review/scripts/check ai patterns.js 内置审查基准包(路径不可读时必用) 如果上述参考文件在当前项目中不可读, 不要把审查降级为无 rubric,也不要在报告里说“无法加载具体 rubric”后停止使用标准 。必须使用本节内置基准包,技术备注行的 Rubric 来源写 embedded 。 通用网文内容 rubric: 核心卖点:本章是否围绕明确卖点推进;看不出卖点至少 S2。 冲突推进:本章是否有阻碍、选择、代价或关系变化;只解释/闲聊/总结至少 S2。 任务卡点:角色办事被卡住时,是否卡出信息、关系、代价、选择或伏笔变化;卡点只剩流程细节、删掉不影响故事至少 S3。 情绪曲线:是否有铺垫、升温、释放或反转;情绪平直或突兀至少 S2/S3。 钩子与期待:开头或结尾是否制造后续问题;没有悬念或未完成期待至少 S2。 开头新鲜度(仅开篇/前 3 章):开局有具体人物/处境切口,还是同题材默认套路(能整体换到任意同类书)?"有钩子/非天气开场"不豁免同质化;套路化开局即使有钩子也至少 S3,整体撞同题材模板 S2。 角色动机:行为是否符合目标、性格、处境和关系压力;为剧情服务而失真是 S1/S2。 对话质量:是否有潜台词、信息控制、角色差异;说明书式对话至少 S2。 设定一致性:不违背已写规则、时间线、角色属性;明确事实冲突通常 S1。 文字自然度:具体、可感、动作承载信息;AI 腔、陈词滥调、总结体按影响定 S2/S3。 句长节奏:按本书文风、语义承接与场景功能判断;机械碎句、动作清单或臃肿长句按影响定 S3/S2,不按统一字数或句长模板验收。 标点节奏:标点是否服务语气/人物声线;通篇句号化、随机堆砌问号/感叹号,或残留 …… / —— 硬造停顿,按影响定 S3/S2。 具体字数表达校验:正文用“这五个字 / 短短四字 / 三个字一落 / 八个字砸下去”等具体字数表达评价台词、题字、信件、念头或弹幕时,必须能确认统计口径、机器核对结果和叙事必要;不能确保字数计算正确时,按文字自然度问题处理,建议改成“这句话一落”“那几个字”“话音落下”等非具体数字表达。 格式可读性:段落短、对话独立、无多余空行;格式阻碍阅读按 S3,严重混乱按 S2。 剧情循环:目标 → 阻碍 → 行动 → 代价/反馈 → 新期待;缺少目标/阻碍/反馈通常至少 S2。 高潮构建:检查蓄能、情绪落差与兑现;强反转可用蓄能 → 假胜 → 崩解 → 反转/兑现,缺铺垫或兑现通常 S2/S3。 关系进展:互动尺度必须匹配当前关系阶段;越界亲密、突然信任、突然敌对都需要铺垫,否则按影响定 S1/S2。 伏笔状态:伏笔状态需可追踪;伏笔密度只作为结构风险提示,除非直接造成理解混乱,否则不升级到 S2+。 三层去味 fallback 速查: 表达:套词、总结句、工整句式是否机械复现或重复意思?词语本身只是线索,直写情绪、纠错对比与文风允许的叙述可保留。 用笔:关键交锋或决定是否被概括,次要流程是否过详?压缩、展开均应保住人物体验和必要承接。 故事:行动有什么来由、解决依据从何而来、前后改变了什么?安静场景可承载关系与认知变化,不强求冲突。 处理原则:有原文证据才输出 finding,指出阅读损失、最小建议与资料限制;只报告,不落改,不默认拆短、加动作或新增剧情。 平台 fallback 摘要(叠加在通用 rubric 上): 番茄长篇:强开局、强冲突、高频爽点/情绪反馈、低理解门槛。 起点长篇:设定自洽、升级路径、长线期待、世界观承载力。 短篇:开头钩子、反转有铺垫、情绪兑现、信息差推进。 Phase 1:收集待审查内容 1. 确定审查范围 : 用户指定了章节/文件 → 只审查指定内容。 用户未指定 → 项目是 git 仓库时审 git diff name only 里的正文/设定/大纲文件;否则长篇审 正文/ 下最近修改的章,短篇审 正文.md 。报告开头写明审了哪些。 2. 范围传递策略 : 优先把文件路径、章节名、行号范围传给 reviewer,不要把整本或大量章节完整复制进每个 prompt。 单文件或短片段可附 300 1200 字关键摘录。 多章/整卷/整本审查必须分批:按章节或文件组拆分,每批输出独立 findings,再综合;分批前先完整读 [references/batch review.md](references/batch review.md)(跨批状态、连续性、乱序提醒)。 3. 读取支撑材料 :solo 和分批审查时由你读正文、相关设定、角色档案、大纲、 追踪/上下文.md 与伏笔文件;full/lean 只读定范围、定平台和分批开放项要用的文件,其余由 reviewer 按路径自己读。缺材料时在报告里标为证据不足。 4. 识别篇幅与目标平台,加载 rubric : 通用 rubric 每次都加载:读 story review/references/quality rubric.md ,不可读时用内置通用网文内容 rubric。平台表叠加在通用 rubric 上,不替代它。 篇幅:书目录下有 正文/ 或 设定/ 子目录的是长篇,有 正文.md 或 设定.md 文件的是短篇(与 /story 路由同一口径)。 平台:用户这次指定的优先;其次长篇读 设定/题材定位.md 、短篇读 设定.md 的「目标平台」。 .active book 只用来定位书目录,不当平台来源。 按下表叠加平台表,文件不可读时用内置平台 fallback 摘要: 篇幅 目标平台 叠加的平台表 长篇 起点 story review/references/rubrics/qidian.md 长篇 番茄 story review/references/rubrics/fanqie.md 长篇 晋江、其他、未定、没写 不叠加 短篇 知乎盐言(也写作盐选)、番茄、七猫、黑岩、红果、小程序、未定、没写 story review/references/rubrics/zhihu.md 短篇另按 设定.md 「平台基调」核对格式、引号和导语。 技术备注行的 Rubric 写叠加的平台表( fanqie qidian zhihu ),不叠加写 generic ;括号里文件可读写 file ,用了内置摘要写 embedded 。 5. 形成审查基准包摘要 :把已加载的文件内容或内置 fallback 摘要压缩为 5 12 条审查标准,后续 solo 和子 Agent 都必须使用这份摘要。审查提示词要各保留一条剧情循环、高潮构建和关系进展的判断,审第 1 3 章时再加开头新鲜度。摘要必须保留一条句长标准:叙述默认是逗号长句,碎句和电报体与 AI 腔同级处理,不因「短」放行;本书文风另有约定时按文风。 6. 确定性预检(只报告,不修改) :当审查范围包含本地正文文件路径时,运行本 skill 自带脚本: 将 ellipsis 、 double hyphen 、 markdown divider 结果作为 format findings 合并进报告。 em dash 破折号只采用 check ai patterns.js 的语义改写建议(见下条); normalize punctuation.js 报的同一位置 em dash 在合并时去重丢弃,避免同处出现「机械替换」与「按功能改写」两条相互冲突的 finding。另外人工检查标点节奏是否通篇句号化或随机堆砌,脚本不替代语气判断。 check ai patterns.js 的 blocking / advisory 都先作为 prose 候选,按 style resolution 、原文功能及三层方法逐条复核;确认造成具体阅读损失后,按下方严重度定义定级。功能性纠错、叙述与停顿保留,不把脚本级别直接换成必须修改的 finding。检测器改法仅作参考,不覆盖文风与事实边界。完整语义复核见 expression.md 、 narrative focus.md 、 story logic.md ,只报告问题与建议,不落改。 check degeneration.js 报告模型退化(逐字复读/截断/占位符/工程词泄漏),每条带 severity: blocking advisory :blocking(复读/截断/tier1 工程词)作为 S1/S2 prose findings,修复建议是「重新生成该段,不是改写」;advisory(tier2 章节/歧义词)作为 S3。 这三个预检脚本只读; story review 不修改正文、设定或大纲文件 ,需要自动修复正文时建议转 /story deslop 。full / lean 模式只有下方「追踪文件维护」允许修改 追踪/ ;分批审查的所有模式都可按 batch review.md 写 .story review/state.md ,solo 除该状态外不写项目内容。 默认 quote mode keep ,不把知乎盐言短篇的 「」 当作问题;只有项目明确指定引号风格时才检查对应转换建议。 统一 Findings Schema(所有模式必须使用) 所有 reviewer(包括 solo)先按统一结构整理问题,再按 Phase 4 或 solo 模板转写给作者;内部字段用于合并、排序,不原样贴进作者报告。 location 必须使用工具读取结果显示的原始文件行号;不要删除空行后重新编号。 对 consistency / factual / causal / rule boundary 类 finding, fix 字段只写事实统一方向(例如“统一为左臂旧伤,并同步正文/设定中冲突处”或“需在 A/B 时间线中裁定一个来源”),不要写文学创作建议。 严重度定义:S1–S4 的级别与长篇写作、检测器相同;审稿报告的小节标题按级别写,S1、S2 归「必须改」,S3 归「建议改」,S4 归「可以不改」: S1 :会破坏主线、角色动机、世界规则或读者信任,需优先修。 S2 :明显影响章节效果、留存、节奏、人物可信度,本轮要修。 S3 :局部质量问题,如措辞、轻微格式、局部节奏,可排期修。 S4 :建议项或风格微调,不阻塞发布。 Phase 2:并行 Spawn Agent(full/lean 模式) 执行 Phase 0 后实际模式仍是 full/lean 时,读 [references/agent prompts.md](references/agent prompts.md) 按其中的调用规则与四个 prompt 并行 spawn,综合裁决与报告模板也在其中;不 spawn 缺失的 Agent。每个 Agent 不继承父对话上下文,prompt 自包含路径、范围与统一 Findings Schema。 Phase 3:综合裁决(full / lean 模式) 收齐 reviewer 结果后按 agent prompts.md「综合裁决」合并、去重、呈现分歧。 Phase 4:输出报告(full / lean 模式) 实际模式确为 full/lean 时用 agent prompts.md 的报告模板;降级 solo 时改用 solo.md 模板。 solo 模式 降级或指定 solo 时读 [references/solo.md](references/solo.md),按其中流程与输出格式执行。 追踪文件维护 有 追踪/ tracking state.json 的长篇工程且实际模式是 full/lean 时,收尾读 [references/review tracking.md](references/review tracking.md) 修订追踪;solo 不改 追踪/ ,按 solo.md 第 5 步写进报告。 流程衔接 流水线: 通用 位置: 审查(写作之后) 时机 跳转到 命令 要修改查出的问题 story long write / story short write 返回对应写作 skill 修改 发现 AI 味需清理 story deslop /story deslop