SuperAPI AI 工具集

review-preparation

编程与开发

查看项目

更新于 10-15 09:53

技能介绍

用途 该技能用于准备评审输入,覆盖三种变体:代码评审(code-review)、团队评审(team-review)和 PR 评审(pr-review)。它不编写新的检测提示词,而是复用现有输入进行准备,最终产出已解析的目标与快照、原生评审简述、上下文文件、评审人选择、运行身份和证据发现。

执行前置 执行前需加载 project-protocol:project-protocol 技能,用于执行预检和受限的运行记录。只读评审可以使用脏工作区:需要记录其完整快照并保留现有编辑。评审行为本身不会创建变更授权。若调用方绑定了候选,则该候选具有权威性,需先通过 project-protocol 校验其项目/工作树、运行、范围和当前快照,再推导评审输入。需使用其捕获的基线和确切的候选内容,包括受限的未跟踪文件及其完整内容,并排除本次运行的输出根目录。

基线与候选处理 不得用分支比较或上一个提交替换该目标。基线内容缺失属于已声明的比较缺口,而非凭空构造变更前状态的许可;需保留实际候选内容,并将任何依赖该比较的关卡标记为不可用。

准备阶段 读取本技能内的 references/<variant>.md,并执行其准备阶段一次。现有评审人输入保持不变。对于团队评审,X-ray 分析在协调者上下文中执行(见 Phase 1a),不作为角色派生;需在 runs.json 中解析确切的运行,且不得用镜像替代缺失的运行。

输出位置与记录 参考文档中的原生报告位置相对于显式评审输出根目录。当生命周期提供运行根目录时,将 scratch/context 放置于该处,而不是创建第二个根运行。需记录相同的项目快照和运行身份。缺失的输入/工作者证据应作为降级覆盖返回,不得编造发现。

技术栈维度 读取 references/stack-dimensions.md,将 React、TypeScript 和平台绑定纳入同一评审人选择。团队评审中这属于 Phase 0b,在展示计划之前;代码和 PR 评审中则跟随范围解析之后。准备阶段只选择评审人而不派发。需记录每个维度的激活证据或跳过原因,然后将完整选择传递给 review-method。准备完成的捆绑包不能暗示任何已选评审人已运行。

知识绑定 加载 skill-catalog:skill-catalog 技能。在解析范围和原生评审人选择之后,读取本技能内的 references/knowledge-bindings.md。需针对同一候选快照和实际可用的技能清单准备一个 knowledge_selection;将范围/视角分配和内容指纹加入该简述;知识选择对所有已分类的可用技术栈开放,而非固定语言列表。需显式返回清单/分类/匹配缺口以及失败的选定加载。在其绑定发生变化之前,复用确切的已准备记录。