SuperAPI AI 工具集

code-review

编程与开发

查看项目

更新于 10-16 05:45

技能介绍

用途:在具体代码变更准备审查时,系统化检查缺陷、执行标准并共享知识,作为代码进入共享代码库前的最后质量关口。

主要能力:按流程校准审查目标,理解上下文,检查正确性、安全(OWASP Top 10)、可维护性、测试充分性与性能;将意见分为 Blocking、Should-fix、Nit、Question 四级;对棕地或契约敏感变更优先关注契约、共存、发布边界与测试覆盖。

必要用法:审查前读取 quality_target_context,确认目标是智能体内部技能、宿主运行时工具、本地 harness、内部服务还是公开 HTTP 服务;缺失或与代码矛盾时应停止并请求边界。默认输出按严重程度排序的简短发现列表,不提供修复代码、补丁或批准结论,除非明确要求。

限制:每个 Blocking 发现须有 diff、契约、测试或可追踪代码路径的证据;不报告无法追踪的假设性回归;不将清单逐项输出;不把分支机制观察升级为独立阻塞项。仓库提供预提交钩子,启用命令为 git config core.hooksPath .githooks,扫描实现为 scripts/hooks/no_magic_values_scan.py。魔法值例外需使用 ALLOW_MAGIC_NUMBER: reason, ticket。