Claude Skill

story-review

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

LLM Mart · 0 points · 1 views 0 listing impressions 0 install-command copies
Download zenstory-ai-oh-story-dsh-packages_knowledge_oh-story_skills_story-review-cf70e6d.zip · 123 KB

Install

skills CLI npx skills add https://github.com/zenstory-ai/oh-story-dsh/tree/main/packages/knowledge/oh-story/skills/story-review
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install zenstory-ai-oh-story-dsh@llmmart
Git git clone https://github.com/zenstory-ai/oh-story-dsh.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole zenstory-ai/oh-story-dsh collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

story-review:多视角对抗式审查

Spawn 版本提示(不阻断 spawn):先读取项目根 .story-deployed 的 agents_version。与本版 agents_version: 44 不一致时(标记缺失、字段缺失/非整数、小于或大于 44)照常按当前宿主角色来源检查并 spawn;同时在「这次怎么审的」里用一句白话提示作者「审稿助手是旧版,运行 /story-setup(ZCode 先更新插件)后新开会话」,Notice: agents bundle 版本不匹配(项目 {N},本版 44) 原文写进技术备注行;大于 44 时额外提示先更新 oh-story-claudecode,不要用本地旧版 setup 降级覆盖。版本提示本身不触发降级;文件缺失或异常、工具不可用、递归限制或调用失败按 Phase 0 处理,技术备注写 Fallback: ... -> solo。

你负责协调审查,找出小说的结构、角色、文字与设定问题,给出有原文依据的修改建议。

执行铁律:审查是找问题,不是验证正确性。

文风裁决:先读 references/style-resolution.md,加载本书文风,复用调用方的 style_resolution 与作者偏好;单独调用时按当前请求与本书文风裁决。同一裁决交给后续执行者。

作者偏好边界

只接收调用方已有的作者偏好,不查询或记录作者记忆;独立调用时不加载记忆文件。偏好只能帮助解释意图和组织报告,不能降低 rubric 严重度、把事实冲突判为无问题或跳过平台门禁;当前请求仍优先。


Phase 0:预检与降级(必须先执行)

  1. 确定请求模式:解析用户输入中的 full(默认,优先 spawn 全部 4 个 Agent)、lean(优先 spawn story-architect + consistency-checker)、solo(不 spawn Agent,由当前会话执行基础审查)。
  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 → 可以不改。执行路径只写在报告最后一行,格式固定:

技术备注:Mode {请求}→{实际} · Fallback {none | project custom agents unavailable -> solo | missing agents -> solo | malformed agents -> solo | agent tool unavailable -> solo | spawn failed -> solo | subagent recursion guard -> solo} · Rubric {fanqie | qidian | zhihu | generic} ({file | embedded})[ · Files {缺失或异常的 agent 文件}][ · Notice {版本不匹配原文}]

参考资料解析顺序

可读取参考文件时,按以下顺序尝试,第一个命中即用:

  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}/... 目录

靠前几层不存在属正常,命中第一个存在层即用;不要手工把 references/ 复制进 .codex/skills/。

规范路径如下;禁止只写裸文件名,禁止跨 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(跨批状态、连续性、乱序提醒)。
  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 章时再加开头新鲜度)。
  6. 确定性预检(只报告,不修改):当审查范围包含本地正文文件路径时,运行本 skill 自带脚本:
    node scripts/normalize-punctuation.js --check <正文文件...>
    node scripts/check-ai-patterns.js --check --fail-on=blocking <正文文件...>
    node scripts/check-degeneration.js --check <正文文件...>
    
    • ellipsis、double-hyphen、markdown-divider 归入 format findings;旁白引号外的 em-dash 只采用 check-ai-patterns.js 的语义改写建议(去重丢弃 normalize-punctuation.js 同位置的 em-dash;对话引号内被打断或拖音的 —— 不报错);默认 --quote-mode keep。另人工检查标点节奏是否通篇句号化或随机堆砌。
    • check-ai-patterns.js 的 blocking / advisory 作为 prose 候选,按 style_resolution、原文功能及 expression.md / narrative-focus.md / story-logic.md 复核,确认造成具体阅读损失后按下方严重度定级;功能性纠错、叙述与停顿保留。
    • check-degeneration.js 的 blocking(复读/截断/tier1 工程词)作为 S1/S2 prose findings(建议“重新生成该段,不是改写”),advisory(tier2 章节/歧义词)作为 S3。
    • story-review 不修改正文、设定或大纲文件(需自动修复正文建议转 /story-deslop);仅 full/lean 的「追踪文件维护」可修改 追踪/,分批审查可按 batch-review.md 写 .story-review/state.md。

统一 Findings Schema(所有模式必须使用)

所有 reviewer(包括 solo)先按统一结构整理问题,再按 Phase 4 或 solo 模板转写给作者;内部字段用于合并、排序,不原样贴进作者报告。location 必须使用工具读取结果显示的原始文件行号;不要删除空行后重新编号。

对 consistency / factual / causal / rule_boundary 类 finding,fix 字段只写事实统一方向(例如“统一为左臂旧伤,并同步正文/设定中冲突处”或“需在 A/B 时间线中裁定一个来源”),不要写文学创作建议。

- severity: S1 | S2 | S3 | S4
  category: structure | character | prose | consistency | platform | factual | format | causal | rule_boundary
  location: 文件路径:行号 或 章节/段落描述
  evidence: "引用原文或具体证据"
  issue: "问题描述"
  fix: "可执行修改建议"

严重度定义:S1–S4 的级别与长篇写作、检测器相同;审稿报告的小节标题按级别写,S1、S2 归「必须改」,S3 归「建议改」,S4 归「可以不改」:

  • S1:会破坏主线、角色动机、世界规则或读者信任,需优先修。
  • S2:明显影响章节效果、留存、节奏、人物可信度,本轮要修。
  • S3:局部质量问题,如措辞、轻微格式、局部节奏,可排期修。
  • S4:建议项或风格微调,不阻塞发布。

Phase 2:并行 Spawn Agent(full/lean 模式)

执行 Phase 0 后实际模式仍是 full/lean 时,读 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,按其中流程与输出格式执行。

追踪文件维护

有 追踪/_tracking-state.json 的长篇工程且实际模式是 full/lean 时,收尾读 references/review-tracking.md 修订追踪;solo 不改 追踪/,按 solo.md 第 5 步写进报告。

流程衔接

流水线: 通用 位置: 审查(写作之后)

时机 跳转到 命令
要修改查出的问题 story-long-write / story-short-write 返回对应写作 skill 修改
发现 AI 味需清理 story-deslop /story-deslop
Files (oh-story-dsh)
  • references
    • rubrics
      • fanqie.md 1012 B
        Loading…
      • qidian.md 1.1 KB
        Loading…
      • zhihu.md 1.4 KB
        Loading…
    • agent-prompts.md 13.5 KB
      Loading…
    • banned-words.md 10.9 KB
      Loading…
    • batch-review.md 2.3 KB
      Loading…
    • expression.md 9.6 KB
      Loading…
    • narrative-focus.md 6.7 KB
      Loading…
    • quality-rubric.md 5 KB
      Loading…
    • review-tracking.md 2.2 KB
      Loading…
    • solo.md 2.9 KB
      Loading…
    • story-logic.md 5.9 KB
      Loading…
    • style-resolution.md 3 KB
      Loading…
    • tracking-initialization.md 1.6 KB
      Loading…
    • tracking-transaction.md 8.6 KB
      Loading…
  • scripts
    • check-ai-patterns.js 79.6 KB
      Loading…
    • check-degeneration.js 15.4 KB
      Loading…
    • normalize-punctuation.js 19 KB
      Loading…
    • style-whitelist.js 1.1 KB
      Loading…
    • tracking_commit.py 83.1 KB
      Loading…
    • wordcount_core.py 18.9 KB
      Loading…
  • SKILL.md 19.3 KB
    ---
    name: story-review
    version: 1.1.1
    description: "多视角对抗式审查。full/lean 模式在已部署 reviewer agents 时并行 spawn;缺失/异常 agents 或 spawn 失败时自动降级 solo,参考文件不可读时使用内置 rubric fallback。触发方式:/story-review、/审查、「审查一下」「帮我审一下」。"
    metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudecode"}}
    ---
    # story-review:多视角对抗式审查
    
    > Spawn 版本提示(不阻断 spawn):先读取项目根 `.story-deployed` 的 `agents_version`。与本版 `agents_version: 44` 不一致时(标记缺失、字段缺失/非整数、小于或大于 44)**照常按当前宿主角色来源检查并 spawn**;同时在「这次怎么审的」里用一句白话提示作者「审稿助手是旧版,运行 /story-setup(ZCode 先更新插件)后新开会话」,`Notice: agents bundle 版本不匹配(项目 {N},本版 44)` 原文写进技术备注行;大于 44 时额外提示先更新 oh-story-claudecode,不要用本地旧版 setup 降级覆盖。版本提示本身不触发降级;文件缺失或异常、工具不可用、递归限制或调用失败按 Phase 0 处理,技术备注写 `Fallback: ... -> solo`。
    
    你负责协调审查,找出小说的结构、角色、文字与设定问题,给出有原文依据的修改建议。
    
    **执行铁律:审查是找问题,不是验证正确性。**
    
    **文风裁决**:先读 [references/style-resolution.md](references/style-resolution.md),加载本书文风,复用调用方的 `style_resolution` 与作者偏好;单独调用时按当前请求与本书文风裁决。同一裁决交给后续执行者。
    
    ## 作者偏好边界
    
    只接收调用方已有的作者偏好,不查询或记录作者记忆;独立调用时不加载记忆文件。偏好只能帮助解释意图和组织报告,不能降低 rubric 严重度、把事实冲突判为无问题或跳过平台门禁;当前请求仍优先。
    
    ---
    
    ## Phase 0:预检与降级(必须先执行)
    
    1. **确定请求模式**:解析用户输入中的 `full`(默认,优先 spawn 全部 4 个 Agent)、`lean`(优先 spawn `story-architect` + `consistency-checker`)、`solo`(不 spawn Agent,由当前会话执行基础审查)。
    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 → **可以不改**。执行路径只写在报告最后一行,格式固定:
    
    ```text
    技术备注:Mode {请求}→{实际} · Fallback {none | project custom agents unavailable -> solo | missing agents -> solo | malformed agents -> solo | agent tool unavailable -> solo | spawn failed -> solo | subagent recursion guard -> solo} · Rubric {fanqie | qidian | zhihu | generic} ({file | embedded})[ · Files {缺失或异常的 agent 文件}][ · Notice {版本不匹配原文}]
    ```
    
    ### 参考资料解析顺序
    
    可读取参考文件时,按以下顺序尝试,第一个命中即用:
    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}/...` 目录
    
    > 靠前几层不存在属正常,命中第一个存在层即用;不要手工把 `references/` 复制进 `.codex/skills/`。
    
    规范路径如下;禁止只写裸文件名,禁止跨 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 章时再加开头新鲜度)。
    6. **确定性预检(只报告,不修改)**:当审查范围包含本地正文文件路径时,运行本 skill 自带脚本:
       ```bash
       node scripts/normalize-punctuation.js --check <正文文件...>
       node scripts/check-ai-patterns.js --check --fail-on=blocking <正文文件...>
       node scripts/check-degeneration.js --check <正文文件...>
       ```
       - `ellipsis`、`double-hyphen`、`markdown-divider` 归入 `format` findings;旁白引号外的 `em-dash` 只采用 `check-ai-patterns.js` 的语义改写建议(去重丢弃 `normalize-punctuation.js` 同位置的 `em-dash`;对话引号内被打断或拖音的 `——` 不报错);默认 `--quote-mode keep`。另人工检查标点节奏是否通篇句号化或随机堆砌。
       - `check-ai-patterns.js` 的 blocking / advisory 作为 `prose` 候选,按 `style_resolution`、原文功能及 `expression.md` / `narrative-focus.md` / `story-logic.md` 复核,确认造成具体阅读损失后按下方严重度定级;功能性纠错、叙述与停顿保留。
       - `check-degeneration.js` 的 blocking(复读/截断/tier1 工程词)作为 S1/S2 `prose` findings(建议“重新生成该段,不是改写”),advisory(tier2 章节/歧义词)作为 S3。
       - `story-review` **不修改正文、设定或大纲文件**(需自动修复正文建议转 `/story-deslop`);仅 full/lean 的「追踪文件维护」可修改 `追踪/`,分批审查可按 batch-review.md 写 **.story-review/state.md**。
    
    ---
    
    ## 统一 Findings Schema(所有模式必须使用)
    
    所有 reviewer(包括 solo)先按统一结构整理问题,再按 Phase 4 或 solo 模板转写给作者;内部字段用于合并、排序,不原样贴进作者报告。`location` 必须使用工具读取结果显示的原始文件行号;不要删除空行后重新编号。
    
    对 `consistency` / `factual` / `causal` / `rule_boundary` 类 finding,`fix` 字段只写事实统一方向(例如“统一为左臂旧伤,并同步正文/设定中冲突处”或“需在 A/B 时间线中裁定一个来源”),不要写文学创作建议。
    
    ```yaml
    - severity: S1 | S2 | S3 | S4
      category: structure | character | prose | consistency | platform | factual | format | causal | rule_boundary
      location: 文件路径:行号 或 章节/段落描述
      evidence: "引用原文或具体证据"
      issue: "问题描述"
      fix: "可执行修改建议"
    ```
    
    严重度定义: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` |
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.