SuperAPI AI 工具集

code-review

测试与质量

查看项目

更新于 10-16 02:35

技能介绍

用途:审查自某个固定点以来的代码改动,适用于分支、PR、进行中的工作,或用户要求“review since X”的场景。

主要能力:以用户提供的固定点为基准,从两条轴审查改动。Standards 轴检查代码是否符合仓库文档化的编码规范,并附带一组固定的 Fowler 代码坏味道基线(如 Mysterious Name、Duplicated Code、Feature Envy 等),仓库文档规范优先于基线,坏味道均为判断性提示而非硬性违规。Contract 轴检查代码是否满足工单验收标准、是否实现工单列出的每个签名并保持签名原样。两条轴作为并行子代理运行,避免相互污染上下文,再由本技能汇总。另有 Journey 轴,不审查 diff,而是在交付切片集成后按 PRD 旅程运行一次,判断通过、失败或需人工查看。

使用方式:先确定固定点,未指定则询问。已提交工作用 git diff <fixed-point>...HEAD,进行中工作用 git diff <fixed-point> 并显式读取范围内未跟踪文件,用 git log <fixed-point>..HEAD --oneline 记录提交。确认固定点可解析(git rev-parse <fixed-point>)且改动非空。随后查找工单与契约(提交信息或分支名中的 issue 引用、用户传入路径、docs/、specs/、.scratch/ 下的规格文件),以及规范来源(如 CODING_STANDARDS.md、CONTRIBUTING.md)。并行启动两个子代理,最后在 ## Standards 与 ## Contract 标题下原样呈现报告,不合并或重排,并以一行总结各轴发现数量与最严重问题。

限制:若找不到工单或规格,跳过 Contract 子代理并在报告中说明;若必需审查者无法启动或报告无法读取,应报告为 blocked,不得以实施者判断替代。Journey 轴证据缺失或为空视为需人工查看,不得判为通过。具体收费、价格、平台与效果资料暂未提供。