SuperAPI AI 工具集

gs-review

编程与开发

查看项目

更新于 11-15 18:37

技能介绍

gs-review 是一个面向代码审查的 AI 技能,目标是在改动进入生产前发现潜在问题。它从「什么会在生产环境出错」出发,而不是泛泛做风格检查。

用途

  • 审查未提交改动:不带参数时,审查全部未提交内容(已暂存、未暂存、未跟踪)。
  • 按 base ref 审查:传入分支、标签或提交时,审查该 ref 与 HEAD 的合并基点以来的全部改动,包括已提交与未提交部分。
  • 焦点审查:传入文件路径、目录、功能区域或简短审查重点时,只聚焦该范围。若参数既是存在的路径又是 git ref,按路径处理。

主要能力

  • 范围与风险识别:运行 git status、当前分支、diff 统计等命令,识别改动文件状态、语言与框架、所在层(后端、前端、数据库、测试、文档、基础设施、配置)以及风险类型(认证、金额、迁移、公开 API、用户可见 UI、并发、性能、纯文档),并统计改动规模。
  • 角色选择:按改动内容选基础角色(Elixir/Phoenix、前端、正确性、纯文档时的技术写作与准确性),再按风险追加安全、数据库、UI/a11y、架构、测试、QA 执行,并始终加入 Fresh Eyes。小改动(不超过 200 行、不超过 5 个文件、且不含认证/金额/迁移/公开 API/并发风险)由单个子代理承担全部角色;否则每个角色一个子代理并行。
  • 第二意见与反驳验证:Fresh Eyes 与验证阶段优先使用非宿主模型的另一供应商(如 Claude 宿主用 Codex via MCP、Grok headless 等,顺序见技能资料),逐条尝试反驳候选项,判定为 CONFIRMED、PLAUSIBLE 或 REFUTED,被反驳的条目被丢弃并计数。
  • 项目自定义指南:若项目存在 REVIEW.md,会按 references/review-md.md 的规则应用,影响改动文件列表、角色选择、QA 执行命令、范围包与报告证据。
  • 报告:仅在对话中输出,包含结论、最小改动视图(调用树、文件树或控制流的 diff 草图)、按严重度排序的发现(含 file:line、提出角色、确认状态、失败场景与修复建议)、证据(QA 命令的通过与失败计数,区分本次改动导致与既有失败)以及合并危险(单向门/双向门与最大影响范围)。

使用方式

  • 在支持该技能的 AI 编程环境中以斜杠命令调用:/gs-review [base ref | 焦点]。
  • 无参数审查全部未提交改动;传 git ref 审查自合并基点的全部改动;传路径或区域作为焦点。

适用场景

  • 提交前快速自检、分支合并前审查、涉及认证、金额、迁移、公开 API 等高风险改动的重点审查,以及文档类改动的准确性检查。

限制

  • gs-review 为只读:不应用修复、不写文件、不创建 issue、不提交;修复需用户后续另行请求。
  • 若当前目录不是 git 仓库、git 命令失败、改动为空且无焦点参数、或给定焦点路径不存在,会停止并提示。
  • 第二意见依赖可用的外部供应商;不可用时回退到通用子代理或宿主单独一轮,报告中会如实标注,且不会将其描述为跨供应商第二意见。该技能不会安装、更新或认证供应商,也不会放宽其只读控制。
  • 审查者使用通用子代理,不使用命名的自定义代理或代理目录。
  • 报告中「改动视图」优先使用 gs-show-me 技能(若已安装),但不写 HTML 文件。

其它

  • 仓库、作者与具体版本信息暂未提供;收费、定价与平台支持范围暂未提供。