用途
本技能用于对网文项目的单章正文进行结构化质量审查：调度统一 reviewer 审查章节、生成审查报告、输出并落库审查指标，并可写入兼容审查记录。
主要能力
- 解析真实书项目根，并校验其包含 .webnovel/state.json，否则阻断。
- 当目标章缺失 runtime 合同（contract）时，用详细大纲中的真实本章目标刷新合同，且禁止使用占位文本。
- 按需加载参考文档：核心约束、审查 schema 为常加载；涉及爽点或钩子、多线交织、阻断裁决时加载对应参考。
- 通过 Agent 工具调用统一审查 Agent（webnovel-writer:reviewer），由其自带审查方法与维度细则。
- reviewer 只返回严格 JSON；主流程将其写入 ${PROJECT_ROOT}/.webnovel/tmp/review_results.json。
- 由 review-pipeline --save-metrics 生成报告、输出 review_metrics.json 并写入 review_metrics 表，阻断判断以 review_results 中 blocking=true 为准。
- 写入 .webnovel/state.json 兼容审查记录（兼容投影，非事实真源）。
- 存在阻断问题时，通过 AskUserQuestion 让用户裁决处理策略。
使用方式
执行流程按以下步骤进行：
Step 1：解析项目根，设置 WORKSPACE_ROOT、SCRIPTS_DIR、PROJECT_ROOT。
Step 2：目标章缺合同（contract）时，读取项目体裁并用 story-system 命令以 --persist --emit-runtime-contracts 刷新。
Step 3：按触发条件加载参考文档。
Step 4：加载投影状态与待审正文，确认章节号与正文文件，缺正文或缺兼容状态文件立即阻断。
Step 5：调用统一审查 Agent，Prompt 为 chapter={chapter_num}; chapter_file={chapter_file}; project_root=${PROJECT_ROOT}; scripts_dir=${SCRIPTS_DIR}，严格输出 reviewer schema JSON，不评分、不口头总结；随后主流程把严格 JSON 写入临时 review_results.json，并记录 SubagentRun 汇总。
Step 6：运行 review-pipeline，传入 --chapter、--review-results、--metrics-out、--report-file、--save-metrics。
Step 7：运行 update-state -- --add-review 写入兼容审查记录。
Step 8：存在任意 blocking=true 问题时用 AskUserQuestion 让用户裁决：立即修复、仅保存报告稍后处理等。
作者友好过程提示与恢复契约
审查开始前先用作者语言说明本次流程：定位待审正文、刷新缺失合同、写作检查、生成报告和指标、处理阻断裁决；不直接输出原始 JSON、traceback 或长命令日志，技术详情写入 .webnovel/logs/run_last.log。过程提示每次不超过两行，只说明当前动作与影响。少打扰确认策略：无阻断时不询问；存在 blocking issue、缺待审正文、用户要求是否立即修改时才询问。卡住时说明卡点、已完成内容和恢复建议。不可恢复故障才在最终报告提示日志路径，收尾调用 user-report helper。
最终报告契约
最终回复面向作者，使用固定三段式（产生的文件与完成情况、过程中遇到的问题与异常耗时、下一步建议），并以一句总状态开头：已完成 / 部分完成 / 需要你处理 / 未完成。必须汇报审查报告文件、review_results.json、review_metrics.json、review_metrics 是否落库、阻断问题数量、用户裁决状态；无阻断则明确可继续写作。状态规则：有 blocking 问题且用户未选择处理策略时为“需要你处理”；只保存报告稍后处理时为“需要你处理”或“部分完成”；reviewer 跳过、失败或输出不完整时不得写“已完成”。异常分类分为已自动处理、建议确认、必须处理三类；下一步建议须使用任务化语言与可复制命令，不写 token 统计，排查故障时只给日志路径或建议运行 /webnovel-doctor。
适用场景
适用于网文写作流程中对已完成章节进行批量或逐章质量审查、生成结构化审查报告、维护审查指标与兼容审查记录，并在发现阻断问题时进行人工裁决。
限制
项目根不合法、缺 .webnovel/state.json 或缺待审正文时直接阻断。必须通过 Agent 工具调用 reviewer，禁止主流程伪造结论或口头总结代替 subagent 输出。reviewer 不持有写入权限，也不评分。报告与 metrics 只由 review-pipeline --save-metrics 产出，主流程不伪造 overall_score。本资料未提供具体的收费、价格、平台或效果信息。