SuperAPI AI 工具集

review-method

编程与开发

查看项目

更新于 10-15 09:53

技能介绍

review-method 是一个统一的评审方法技能,用于代码评审、团队评审与合并请求评审,并整合由信号选择的栈专项评审员。

用途

该技能旨在为一次评审运行提供统一的入口与协调流程。它以 variant(变体)、目标/标志(target/flags)和输出根目录(output root)作为输入,并可选接收同一快照下已准备好的评审包(same-snapshot prepared bundle)。输出为原生报告以及项目结果信封。技能明确要求:不要将另一个工作流作为执行器来调用。

主要能力

该技能覆盖 code-review、team-review 和 pr-review 三种评审变体,并由信号选择适用的栈专项评审员,例如 React、TypeScript 和平台评审员。评审员清单在消费方工作流的 dispatch.roles 中声明;隔离的内联工作者(inline workers)声明在其 sidecar 中。所有内联视角、批评者、历史、卫生或最小修复的简报,均使用由宿主 harness 提供的规范 project-protocol:isolated-worker 绑定;general-purpose 标签仅描述该内联任务,并非另一个 agent ID。

使用方式

流程上,技能要求先加载 senior-review:review-preparation 技能,除非已提供同一快照下准备好的评审包。若复用已准备的包,需要校验其目标、运行标识和快照。缺失的栈选择需在派发前通过 review-preparation 补全,并校验所准备的知识选择:其 schema、候选/运行/快照、内容与元数据指纹、范围以及分配的交付 ID。若知识绑定缺失或过期,必须针对当前确切候选重新准备,而不能复用旧 schema 或其他运行的包;被复用的包需要针对全部三个栈维度提供激活证据或跳过/缺口原因。技能要求不要为同一评审再准备另一次运行,也不要重复派发同一评审员。

随后,读取本技能中的 references/<variant>.md,在同一批次中派发完整的已准备选择,包括适用的 React、TypeScript 和平台评审员。核心角色输入与提示保持规范于 senior-review:review-quality-gates;栈角色使用其规范提供者定义与准备的共享输入。需保留已准备的 knowledge_selection,并只向每个工作者分配其范围内的 knowledge_ids、选择指纹以及确切的知识目录加载/引用绑定。每个工作者以只读输入方式加载其分配的知识,将其应用于代码证据,并返回 knowledge_usage,包含范围、工作者、哈希、引用和应用说明。任务特定的知识视角也需在同一派发与交付台账中记录。在交付前,任何工作者都不得获得同侪的发现结果。使用隔离上下文和宿主提供的协调机制;在开始整合前,必须对每个已选择的工作者完成核算。

整合阶段需加载 senior-review:review-consolidation 技能,并传入所有原生评审员结果。在整合完成之前,不要运行引用中的输出/修复尾部。

对于代码评审,仅在所有核心与栈结果通过原生整合与验证后,才读取 references/code-review-delivery.md。团队与 PR 的报告交付仍保留在其整合引用中。交付与任何被授权的修复步骤各运行一次。应用层的减法(application subtraction)需加载 senior-review:application-cleanup-method;重要的语义重构需返回调用方的发展计划,绝不委托给清理步骤。

适用场景

适用于需要对代码、团队协作或合并请求进行结构化评审的场景,特别是需要在同一批次中协调多个专项评审员、并对每个评审员的知识加载范围进行精确控制的评审流程。也适用于需要复用同一快照下已准备评审包、并对其有效性进行校验的场景。

限制

只读评审会保留工作区。在任何被接受的修复之前,需加载 project-protocol:project-protocol 以进行执行预检、授权、基线、候选门禁和自有恢复。提交与发布是相互独立的授权;请求评审并不等同于授权发布。资料未提供该技能的安装命令、支持的平台、收费价格或实际评测效果,这些信息暂未提供。