用途
Global Reviewer(综述草稿)用于在综述草稿进入 LaTeX/PDF 阶段之前,做一次全局的、以证据为先的一致性审查。目标是让草稿读起来像一篇连贯的论文,而不是拼接起来的子章节,并让发现的问题可审计、可路由到正确的上游修复环节。
触发词包括:global review、consistency check、coherence audit、术语一致性、全局回看、章节呼应、拷打 writer。适用场景是:草稿已存在,希望在最终排版前做一次连贯性检查。
主要能力
该技能通过两个角色卡开展工作:
- 一致性审查者(审计员):找出真实审稿人会指出的跨章节问题,并路由到正确的上游修复。检查范围/分类体系一致性与跨章节术语漂移;标记未充分说明的论断(缺少任务/指标/约束的数字);把缺失证据视为失败信号并路由上游。它避免通过新增论断或引用来绕过缺口。
- 连贯性编辑(桥梁发现者):识别“拼接孤岛”式结构以及导致这种结构的前置内容弱点。找出过渡句/引导句在做规划者叙述而非论证桥梁的地方;标记重复出现的证据政策免责声明,并指出前置内容应是其唯一归属。它避免只做不改变可读性或可验证性的风格挑剔。
技能自身负责的范围包括:跨章节连贯性(主线、定义、范围)、论文语气完整性(在安全时移除规划者/流水线叙述)、术语一致性(规范术语与同义词策略)、论断→证据卫生(未充分说明的数字、薄弱引用)。不负责的范围包括:改变大纲结构(路由到 C2)、新增来源/引用(路由到 C1/C4)、在笔记单薄时强化缺失的评估细节(路由到 C3/C4)。
使用方式
该技能包含一个确定性辅助脚本,可从当前草稿和上下文生成符合门禁要求的 output/GLOBAL_REVIEW.md(不发明事实/引用)。
快速开始:
uv run python .codex/skills/global-reviewer/scripts/run.py --help
uv run python .codex/skills/global-reviewer/scripts/run.py --workspace <workspace>
全部选项:
--workspace <dir>
--unit-id <U###>(可选;用于日志)
--inputs <semicolon-separated>(罕见覆盖;优先使用默认值)
--outputs <semicolon-separated>(罕见覆盖;默认写入 output/GLOBAL_REVIEW.md)
--checkpoint <C#>(可选)
示例(合并草稿后生成全局审查):
uv run python .codex/skills/global-reviewer/scripts/run.py --workspace <workspace>
冻结策略:如果手动编辑了审查报告并希望冻结它,创建 output/GLOBAL_REVIEW.refined.ok 以防止被覆盖。
输入:output/DRAFT.md。只读上下文(用于避免漂移):outline/outline.yml、outline/taxonomy.yml、outline/mapping.tsv、outline/claim_evidence_matrix.md、citations/ref.bib。
输出:output/GLOBAL_REVIEW.md(以要点为主的报告;始终写入);output/DRAFT.md(可选安全编辑;仅在编辑为低风险时)。
工作流会显式使用上下文文件:对照 outline/outline.yml 检查结构;对照 outline/taxonomy.yml 检查范围词汇;通过 outline/mapping.tsv 检查覆盖信号;用 outline/claim_evidence_matrix.md 抽查论断;对照 citations/ref.bib 做引用键合理性检查。
报告格式要求 output/GLOBAL_REVIEW.md 以要点为主,并逐字包含以下标题:
A. Input integrity / placeholder leakage
B. Narrative and argument chain
C. Scope and taxonomy consistency
D. Citations and verifiability (claim -> evidence)
E. Tables and structural outputs
并在所有阻塞性问题解决后,在顶部包含一行:- Status: PASS(或 - Status: OK)。
适用场景
适用于综述草稿的最终连贯性检查,尤其是需要检查术语一致性、跨章节呼应、范围/引用卫生,以及希望把问题路由到正确上游修复环节的场景。也适用于在合并草稿后生成全局审查报告。
限制
不可发明事实;不可发明引用;不可增删引用键;缺失证据是失败信号,应写 TODO 并路由上游,而不是“绕过”缺口。该脚本不“撰写”新的综述内容,只汇总完整性/引用/结构信号并重新运行草稿质量检查。若审查标记缺失引用/未定义键,应运行 citation-verifier 并确保 citations/ref.bib 包含 output/DRAFT.md 中每个被引用的键。若审查建议的修改会新增论断,应将其转换为“缺失证据”TODO,因为该环节不得发明事实或引用。