SuperAPI AI 工具集

basic-review

编程与开发

查看项目

更新于 11-01 00:30

技能介绍

/basic-review 是一个可移植的正确性审查技能,专注审查“待变更”的改动是否值得在合并前阻止。它只读取 diff 并输出报告,不编辑、不暂存、不提交代码;调用方(例如 /qa-full 第 3 步)收到发现后自行修复,再重新运行本审查进行验证。

审查范围:带参数时,审查参数指定的范围(如 origin/main...HEAD)或路径;不带参数时,“待变更”指当前分支相对基线的 diff 加上未提交内容,即 git diff <base>...HEAD 与 git diff HEAD,基线按 /qa-full 第 1 步的方式确定(gh repo view default branch,否则 origin/HEAD,否则 main/master)。没有可审查内容时直接说明并停止。审查时会读取每个改动 hunk 及足够的上下文(调用方、所在函数、读取的配置)来判断,并对照实际代码核实,而不是从命名推断。

审查顺序大致为:正确性(逻辑错误、不变量破坏、遗漏边界、差一错误、竞态、生命周期/内存缺陷、吞掉错误的失败路径);安全性(注入、认证授权错误、密钥处理、不安全反序列化、不安全默认值、TOCTOU);可靠性与性能(阻塞错误的线程、无界资源使用、意外的 O(N²)、无退避重试、静默失败路径);契约风险(调用方依赖的行为变更、默认值被静默更改、向后兼容性破坏、缺少迁移)。之后应用技能目录中的 checklist.md(gstack 的 pre-landing checklist):运行其 Pass 1(CRITICAL)类别,再运行 Pass 2,并遵守其 Suppressions 列表;由于本技能只读,忽略其中的 Fix-First / AUTO-FIXED 指令及其输出格式(改用本技能的报告格式),并跳过它分配给 gstack 专家子代理或 gstack 专属标记的条目。

报告格式:每个发现一条,按严重程度从高到低排列,格式为 [CRITICAL|HIGH|MEDIUM|LOW] (confidence: high|medium) file:line;Why it is wrong: ...;Fix: ...(无明显修复时写 no obvious fix)。调用方把 CRITICAL 和 HIGH 视为阻止合并项。结尾一行给出一行结论:审查的范围和按严重程度统计的发现数量。没有值得修复的问题时明确写出“No findings worth fixing in <range>.”。

判定标准:候选问题必须同时满足:对正确性、安全性、性能或可维护性有实质影响,且是离散可操作的(一个缺陷一个修复);由本次 diff 引入(改动前就存在的问题最多一句“pre-existing”旁注,不算发现、不算阻断项);严谨程度与文件所在环境匹配;作者被告知后愿意修复(否则不算);无推测——“可能影响其他调用方”必须指出可证明受影响的调用方名称;不是被伪装成 bug 的有意行为变更。纯风格、格式、命名以及 linter 或 CI 已强制执行的内容跳过。

相关技能:/review(gstack)是完整审查,安装后优先使用,它更深入并自行应用修复;/clean-code 处理 KISS/DRY/SOLID/YAGNI 质量清理,本审查跳过;/defense 对同一 diff 做更深入的安全审计。

限制:本技能只读,不修改代码;需要修复时依赖调用方。关于安装方式、价格、平台支持等,资料未提供。