SuperAPI AI 工具集

code-review

测试与质量

查看项目

更新于 10-16 04:57

技能介绍

用途:对固定代码范围执行双轴只读评审。Standards 检查代码是否符合仓库记录的工程规范;Spec 检查代码是否忠实实现需求来源。两个维度由相互独立的子 Agent 并行评审,再分栏聚合,避免上下文污染与结论遮蔽。本 Skill 只报告问题,不修改代码、提交或远端状态。

主要能力与流程:一、加载项目上下文,使用已加载的 CONTEXT 与 RULE,记录来源;相关 CONTEXT 提供给 Standards 与 Spec Agent,完整 RULE 提供给 Standards Agent,主 Agent 在聚合前逐条终检。二、固定评审范围,把用户指定的 commit、branch、tag 或 range 作为固定点并验证引用,分支范围使用 git diff <fixed-point>...HEAD,记录 git log <fixed-point>..HEAD --oneline;未给固定点时按 PR、当前分支、未提交改动或文件目录的当前实现选择可复现范围;引用无效、diff 为空或无有效文件时停止。三、按顺序定位 Spec 来源(用户指定文档、commit 引用、本地需求文档),无来源时跳过 Spec Agent 并标明无可用需求依据。四、定位 Standards 来源,读取 AGENTS.md、CLAUDE.md 或等效指令及仓库编码与测试规范;项目规范优先,工具可确定性检查的交给工具。Standards 始终使用代码味道基线(如 Mysterious Name、Duplicated Code、Feature Envy、Data Clumps、Primitive Obsession、Repeated Switches、Shotgun Surgery、Divergent Change、Speculative Generality、Message Chains、Middle Man、Refused Bequest),这些是需证据与判断的风险信号而非硬性违规,项目规范认可时不报告;涉及模块职责、接口、接缝、adapter、测试面或深浅程度时读取 codebase-design。五、并行执行两个维度,Standards Agent 逐条核对全部已加载 RULE 并返回核对表,未核对则评审未完成;Spec Agent 报告缺失、部分完成、scope creep 与行为错误,每条须引用需求依据。六、主 Agent 独立复核每条候选 finding,必要时追踪调用路径,只保留可被固定范围直接证明且有具体影响的问题,独立判定 P0 至 P3 并修正表述;补做漏核的 RULE。七、聚合输出,在 ## Standards 与 ## Spec 下分别呈现,不跨维度合并;编号为 STD-001、SPEC-001 等,格式含评审范围、问题标题、文件行号、证据、影响、建议;RULE 核对与主 Agent 终检状态需列出;无发现时写「未发现问题」,最后按维度汇总保留数量并引用各自最严重问题。

适用场景:评审分支、PR、未提交改动、文件或目录,或检查实现是否符合需求。限制:只读,不修改代码;需要有效固定范围与可验证依据;缺少需求来源时不做 Spec 评审;严重程度与代码味道信号依赖证据与判断,项目规范明确认可某写法时不报告对应信号。该 Skill 的具体安装方式及收费信息暂未提供。