用途
Review Campaign 用于对整仓库执行「有状态」的审查活动,把审查拆成可恢复的小型会话逐步推进。技能本身无状态且与具体仓库无关,所有活动状态都存放在目标仓库根目录的 reviews/ 台账里,并位于仓库档案中指定的活动分支上;若某项内容未进入台账,即视为未发生,不得依赖会话记忆。该技能仅支持显式调用。
核心概念
- Area(区域):矩阵中的一行,指一个目录簇或横切关注点,其规模以一次会话为宜。
- Pass(维度):矩阵中的一列,指结构或某个细节维度。
- Cell(单元):区域 × 维度,是一次会话的常规工作单位。
- Finding(发现项):区域文件中带编号、可执行的一条条目。
- Tier(分层):auto(无需讨论直接修复)或 triage(需要用户决定)。
使用方式
以 /review-campaign <mode> 调用;不带参数表示继续(continue)。
内置引导保护:当 reviews/REVIEW.md 不存在时,省略模式或显式 continue 均按 plan 处理;只有 plan 能引导台账,continue 不得创建 reviews/REVIEW.md。
按所选模式严格读取并遵循对应文件:
- plan —— 引导或重新规划:modes/plan.md
- sync —— 在不审查代码的前提下吸收基分支漂移:modes/sync.md
- continue —— 完成下一个审查单元:modes/continue.md
- status —— 报告进度与漂移,不写入:modes/status.md
- fix —— 仅应用符合条件的 auto 与 open 发现项:modes/fix.md
- triage —— 与用户一起判定 triage 与 open 发现项:modes/triage.md
在执行 plan、sync、continue、fix 或 triage 之前,先阅读 formats/ledger.md 以了解台账结构、发现项状态流转和 auto 层规则;status 可直接读取现有台账,仅当台账不完整或含义不明时才加载该格式说明。
维度路由
在 continue 模式下,只读取所选维度对应的评分标准。对于配置为批量执行多个维度的小型区域,要在每个维度运行时逐个加载评分标准,不要一次性全部预载。
- structure → rubrics/structure.md
- security → rubrics/security.md
- tests → rubrics/tests.md
- errors → rubrics/errors.md
- logging → rubrics/logging.md
- effect → rubrics/effect.md
- naming → rubrics/naming.md
- diet → rubrics/diet.md
- docs → rubrics/docs.md
阶段顺序
- 对每个区域执行 structure,按优先级排序;须在细节维度之前完成,以便后续审查看到重构后的形态。
- 仅对信任边界相关区域执行 security。
- 按区域执行细节维度,顺序为:tests → errors → logging → effect → naming → diet → docs。
活动约束
- 遵循仓库档案中关于分支/合并策略、发现项导出、验证、技术栈说明、代理指令以及已记录的架构锚点的规定。
- 记录任何发现项前,须依据代码、历史或使用情况加以验证。空维度是有效结果,不得编造发现项。
- 每个发现项只保留在其修复所属的维度中;在其他位置交叉引用时最多一行。
- 阻塞性发现项须立即上报。安全类发现项永远不进入 auto 层。
- 活动审查笔记提交仅限 reviews/ 目录。发现项只有通过 fix,或在 triage 导出后经仓库常规开发流程才能进入代码;sync 可整合基分支漂移,但不得修改被审查的代码。
长期使用建议
目标提示:反复运行 /review-campaign,直到报告矩阵完成或出现阻塞性发现项。每隔几次会话运行一次 /review-campaign status;当它报告基分支漂移时运行 sync。遇到阻塞项应立即停止并上报。审查会话可无人值守运行。在里程碑节点(完成某个阶段或某批 triage)合并活动分支,使导出的工作项与自动修复随台账一同流转。