SuperAPI AI 工具集

audit

编程与开发

查看项目

更新于 10-15 23:42

技能介绍

用途:audit 是上下文引导器,负责编写后续技能与 AI 工具都会读取的 AGENTS.md 文件。AGENTS.md 是跨工具的标准上下文文件,根目录与嵌套区域各一份;CLAUDE.md 仅作为一行指针,通过 @ 导入同目录 AGENTS.md,内容不重复。

主要能力:全新项目(尚无代码)时,先询问编码规范,再结合 /scope 设定的构建方式生成根 AGENTS.md;既有但无文档的项目会扫描全库,判断哪些内容属于全局(根)哪些属于区域(嵌套),写出根与嵌套 AGENTS.md;部分文档项目只补齐缺失内容,不覆盖已有内容;传入区域路径(如 /audit src/auth)则只扫描该区域。旧版有内容的 CLAUDE.md 会在获得许可后迁移进 AGENTS.md,并替换为指针。

使用方式:以区域路径作为参数触发区域扫描;无参数时根据预检信号路由到不同阶段。预检会检查根 AGENTS.md 是否存在、源码数量、提交历史、清单文件、monorepo 标记以及工作流设置信号。全新项目会通过选择题询问编码规范;既有项目直接扫描。修改已有根 AGENTS.md 或迁移旧文件前会先征求许可。主线程负责写入,仅在扫描量大时启动只读子代理。

适用场景:新项目脚手架完成后、既有代码库缺少文档时、需要为某个区域补充上下文时,以及 monorepo 中按工作区逐步深化文档时。

限制:不创建 ADR(由 /architect 负责),不维护变更后的文件(由 /sync 负责),不编写功能范围(由 /scope 负责)。除 git 外不依赖其他 CLI。不覆盖已有 AGENTS.md,只保守补齐。