SuperAPI AI 工具集

audit

编程与开发

查看项目

更新于 10-15 22:16

技能介绍

用途:对代码库做一次外科式、行为保持不变的清理与审计。核心规则是绝不改变可观察行为,测试前后都必须通过;若改动会改变行为,只标记不执行。

主要能力:

  • 栈检测与范围确定:读取 package.json、go.mod、Gemfile、pyproject.toml、pom.xml 或 Cargo.toml,按项目真实技术栈惯例决策。默认范围为当前分支或工作区改动文件,可用 git diff main...HEAD --name-only 与 git diff --name-only 判断;用户明确要求全库时扩展。还需读取 CLAUDE.md / AGENTS.md 与 team-memory/MEMORY.md,尊重既有约定与已记录决策。
  • 冗余审计:识别啰嗦注释、防御性 cargo-cult(不可能抛错的 try/catch、非空值的空检查、无说明的 any 转换、无意义重试、永久为真的特性开关)、结构冗余(复制粘贴、单实现抽象、无过滤 barrel 文件、单常量文件)、AI 噪声(PLAN.md 等通用规划文件、残留调试输出、超 30 天注释代码、占位文本)、前端冗余(渐变默认背景、超大圆角按钮、模板式三卡片布局、Inter 全局唯一字体、硬编码颜色、魔术像素、内联样式、prop drilling、God 组件、幻觉导入、key={index}、Em dash 与空泛 CTA)以及内容层面的模糊营销用语。
  • 技术债审计:DRY 违规的重复逻辑/查询/校验/常量;SOLID 违规(单一职责、开闭、里氏替换、接口隔离、依赖倒置);结构性债(超 400 行 God 文件、5 个以上参数、特性依恋、原始类型偏执、死路由/死端点/死列,删除前用 grep 验证)。
  • 分级处理:立即处理(明显无价值的噪声、精确重复、grep 确认的死代码、无防御价值的模式);简单则处理(无需改调用方的抽取、移除无价值包装、合并单实现抽象);只标记(需更大重构的 SOLID 问题、需设计决策的结构问题、触及测试边界或接口);绝不处理(需改变行为的、数据库 schema、公共 API 或外部契约、team-memory 记录的刻意选择)。
  • 执行与验证:按删除、抽取、合并、重命名、重排的顺序一次通过;运行 /gate(lint、typecheck、build、tests)必须全部通过,失败需修复,不得通过删除测试来恢复通过;两次修复仍失败则回退具体改动并在提交信息中说明。最终以单次原子提交收尾:git add -A 后按模板 git commit 提交,列出 3-5 项最重要改动、已标记未修复债、Gate: PASSED。
  • 永不触碰:测试文件、数据库迁移、锁文件(除非依赖变更)、生成文件、.env 与配置密钥。

与 /gate 集成:gate 可将 audit 作为可选出厂前步骤,范围限于当前分支改动文件,审计后重跑 gate;若审计导致失败则回退并由 gate 报告具体文件。

不适用场景:刚写一小时的绿地代码、功能开发中途、尚未理解代码库时、代替架构讨论(架构错误应使用 /architect)、生成代码/迁移/锁文件。

限制:除上述流程与命令外,官方未提供价格、平台支持或其他能力信息。