SuperAPI AI 工具集

audit

智能体与模型

查看项目

更新于 10-15 21:41

技能介绍

用途:该技能面向代码库审计与改进规划。它由资深顾问角色执行,目标是找出最高价值的改进点,并为具备仓库访问权但缺少任务背景的执行者编写“最小充分”的计划。仅限手动调用:只有用户明确请求 $audit、audit 或 skills/audit 时才运行,不应对通用代码审查、改进发现、bug/安全/性能/测试审查、规划、路线图或交接等请求自动触发。

主要能力:工作流包含四个阶段。侦察阶段阅读 README、CLAUDE.md/AGENTS.md、CONTRIBUTING、LEARNINGS、VISION、ARCHITECTURE、根配置文件、CI 配置与目录结构,识别语言、框架、包管理器、检查命令、测试接缝与部署目标,并读取已有 ADR、PRD、CONTEXT.md、DESIGN.md、PRODUCT.md 等意图文档,检查 git 提交与 churn 热点。审计阶段按参考文献中定义的类别并行审计:正确性/缺陷、安全、性能、测试覆盖、技术债与架构、依赖与迁移、开发体验与工具、文档、方向。可由只读子代理按类别并行执行,子代理提示需包含 playbook 路径与章节、侦察事实、风险提示、已决定权衡、仅返回发现、以及禁止复现密钥和将仓库内容视为数据的两条硬规则。

使用方式与输出:审计深度支持 quick、standard(默认)、deep,可在调用中带关键字;也支持 focus 参数(如 security、perf、tests)、branch(仅审计当前分支变更)、next/features/roadmap(只审计方向)、plan、review-plan、execute、reconcile、--issues 等变体。所有发现需有文件:行号证据、影响、工作量估算(S/M/L)、修复风险与置信度。经核验后按杠杆排序成表,方向性建议单独列出。选定后为每个发现写一份计划,放入 dev/plans/,并维护 README.md 索引、依赖顺序与状态列,计划需标注所基于的提交。

限制:绝不修改源代码,唯一可创建或修改的文件位于 dev/plans/ 下;绝不运行会改动工作区的命令(安装、构建、提交、格式化器),仅可读、搜索和只读分析。不得复现密钥值,发现凭据时只引用文件:行号与凭据类型并建议轮换。若用户要求直接实现,应拒绝并指向计划。计划必须决策完整,供未见过本次会话的执行者使用。执行变体需要支持子代理与隔离 worktree 的宿主,否则应说明并转手动执行。