SuperAPI AI 工具集

code-review-axes-and-quality

测试与质量

查看项目

更新于 10-16 01:07

技能介绍

用途:在代码合并前对提交范围、功能、模块或工作区做结构化审查,产出可执行、可恢复的审查计划,而非仅聊天式意见。执行层依赖配套技能 delegation-mode,需先阅读 ../delegation-mode/SKILL.md,遵循其 worker 契约、稳定任务 ID、.agents/plans/ 输出约定、顺序/并行选择规则、结果文件标记与跨会话 DONE_IDS 恢复流程。

主要能力:固定运行十个审查维度——正确性、性能、可扩展性、基础设施、库卫生、安全、数据完整性与并发、可观测性、可维护性、可读性;即使某维度无发现也须运行并明确声明。每条发现需包含问题、文件与行号或符号、影响、建议修复、严重级别(CRITICAL/HIGH/MEDIUM/LOW)及状态。审查协议为:理解意图、先读测试、读完整实现上下文、跑全部十轴、核实验证记录、给出结论。仅当无未解决的 CRITICAL 或 HIGH 时方可批准。

使用方式:将 scripts/review-plan.template.js 复制为 .agents/plans/YYYY-MM-DD-<slug>.js,填写 DATE、SLUG、PROJECT_CONTEXT 与审查范围,选择 MODE 为 sequential 或 parallel。每个轴输出一个扁平计划文件,命名如 YYYY-MM-DD-<slug>-01-correctness.md 至 -10-readability.md 及 -FINAL.md。轴 worker 须为 config: { $kind: "general" },读取完整相关文件、不修改应用源码,并在文件与响应末尾写入 FILE_WRITTEN: <exact-path>。中断后可用 ls .agents/plans/YYYY-MM-DD-<slug>-*.md 2>/dev/null 检查,更新 DONE_IDS 后重跑,仅补派缺失轴;确认最终报告存在完整后再设 FINAL_DONE = true。

适用场景:提交范围、功能、模块或工作区的合并前审查,需要可恢复、可审计、按严重级别排序的审查结论。

限制:不修改应用代码;不得凭测试通过或作者自信而草率批准;不得声称未实际运行的检查;不得手改 lockfile;不确定的死代码不得静默删除;未提供具体安装命令、收费与平台信息。