SuperAPI AI 工具集

review-campaign

编程与开发

查看项目

更新于 10-16 04:40

技能介绍

用途

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

阶段顺序

  1. 对每个区域执行 structure,按优先级排序;须在细节维度之前完成,以便后续审查看到重构后的形态。
  2. 仅对信任边界相关区域执行 security。
  3. 按区域执行细节维度,顺序为:tests → errors → logging → effect → naming → diet → docs。

活动约束

  • 遵循仓库档案中关于分支/合并策略、发现项导出、验证、技术栈说明、代理指令以及已记录的架构锚点的规定。
  • 记录任何发现项前,须依据代码、历史或使用情况加以验证。空维度是有效结果,不得编造发现项。
  • 每个发现项只保留在其修复所属的维度中;在其他位置交叉引用时最多一行。
  • 阻塞性发现项须立即上报。安全类发现项永远不进入 auto 层。
  • 活动审查笔记提交仅限 reviews/ 目录。发现项只有通过 fix,或在 triage 导出后经仓库常规开发流程才能进入代码;sync 可整合基分支漂移,但不得修改被审查的代码。

长期使用建议

目标提示:反复运行 /review-campaign,直到报告矩阵完成或出现阻塞性发现项。每隔几次会话运行一次 /review-campaign status;当它报告基分支漂移时运行 sync。遇到阻塞项应立即停止并上报。审查会话可无人值守运行。在里程碑节点(完成某个阶段或某批 triage)合并活动分支,使导出的工作项与自动修复随台账一同流转。