SuperAPI AI 工具集

review

测试与质量

查看项目

更新于 10-16 23:14

技能介绍

用途

该技能用于在代码合入(pre-landing)前对 PR 进行审查,提供一套两遍式检查清单,帮助审查者系统化地发现问题。

主要能力

根据描述,审查分为两个阶段:

第一遍为关键(critical)检查,关注以下方面:

  • SQL 安全(SQL safety)
  • 竞态条件(race conditions)
  • LLM 信任边界(LLM trust boundaries)
  • 枚举完整性(enum completeness)

第二遍为信息性(informational)检查,关注以下方面:

  • 副作用(side effects)
  • 魔法数字(magic numbers)
  • 死代码(dead code)
  • 测试缺口(test gaps)

此外,该技能还提供:

  • 对抗性审查(adversarial review),会根据 diff 的规模自动缩放强度
  • 范围漂移检测(scope drift detection)

使用方式

该技能引用了上游文档,作者声明其引用了 gstack 的 review 技能文档。资料中提供了大量前置脚本(Preamble)、AskUserQuestion 格式、完整性原则、仓库归属模式、贡献者模式、完成状态协议、遥测与计划状态页脚等内容。这些脚本涉及:

  • 运行 gstack-update-check 进行更新检查
  • 在 ~/.gstack/sessions 下记录会话
  • 读取 proactive 与 telemetry 等配置
  • 输出 BRANCH、PROACTIVE、REPO_MODE、LAKE_INTRO、TELEMETRY 等状态

资料中给出的部分命令示例:

_UPD=$(~/.claude/skills/gstack/bin/gstack-update-check 2>/dev/null || .claude/skills/gstack/bin/gstack-update-check 2>/dev/null || true)
~/.claude/skills/gstack/bin/gstack-config get gstack_contributor
~/.claude/skills/gstack/bin/gstack-telemetry-log --event-type skill_run --skill _pending_finalize --outcome unknown --session-id "$_SESSION_ID"

资料还涉及 Completeness Principle(Boil the Lake)、Repo Ownership Mode(solo / collaborative / unknown)、Contributor Mode 的评分与提交报告流程、Completion Status Protocol(DONE / DONE_WITH_CONCERNS / BLOCKED / NEEDS_CONTEXT)以及 Telemetry 与 Plan Status Footer 等配套流程。

适用场景

适用于在代码合并前对拉取请求(PR)执行结构化审查,尤其是涉及数据库操作、并发、LLM 调用边界与枚举定义的改动。

限制

资料未提供该技能的收费情况、独立价格、具体支持平台、性能指标或效果数据。资料中的脚本引用了本地路径 ~/.claude/skills/gstack/... 与 ~/.gstack/...,需相应环境支持。部分内容(如官方文本、实际运行结果)暂未提供。

引用文档

以下为作者声明的引用来源,保留指定版本、署名和许可。

作者的来源声明