SuperAPI AI 工具集

code-review

编程与开发

查看项目

更新于 10-15 17:31

技能介绍

用途:对某一个冻结范围做只读代码审查,输出基于证据的发现。它不编辑文件、不跑质量闭环、不生成 Verification Record、不决定最终声明上限,也不改变 Git 或服务商状态。

输入:接受一种获取路径。运行器移交:冻结 diff、CandidateRef、规范化 Ticket Envelope、验收标准、决策、基线、已观察证据与草稿记录。独立获取:只读获取 PR、提交、本地 diff 或用户指定范围,记录观察到的 head/commit/worktree 身份、请求约束、相关仓库规则与可用基线/证据。不通过解析 Markdown 推断 Ticket Envelope;独立上下文无规范化工单时,按显式请求与仓库契约审查。diff 变化则返回 stale-candidate 并停止。

容量上限:每次调用 max_volatile_bytes 为 107656 个规范化 UTF-8 字节;max_single_output_bytes 为 32596。所有 diff、原始文件切片、粘贴的移交、证据正文与工具结果在 CRLF 或孤立 CR 归一化为 LF 后计数。先获取预期清单;命令输出在进入上下文前截断,较大 diff 按文件或 hunk 继续。优先使用路径加 SHA-256 引用而非粘贴产物。若下一次必要读取会超限,返回 schema-3 部分结果并注明已检查/剩余范围与 budget-exhausted;不得跳过范围或降级发现来迁就上限。

审查轴:分别审查并只报告有证据支撑的发现——标准与可维护性;工单验收;语义回归;因果覆盖;声明安全。检查原始文件与 diff,不信任摘要。不调用 verification-audit;由调用方把发现交给其单次审计。

发现格式:按严重度排序:[blocker|should-fix|nit] path:line - 问题与影响。建议修复。blocker 指正确性、安全、数据丢失、工单失败、缺失因果覆盖或重大无支撑声明;should-fix 指有意义可维护性或非关键覆盖问题;nit 指可选打磨。每条发现尽可能指明被违反的验收标准、不变式、边界项或仓库规则。无发现时如实说明并列出残余证据限制。独立输出是只读草稿,不能声称完成工单或发布。不得对未检查的 CandidateRef 或独立范围报告 PASS。