SuperAPI AI 工具集

overnight-repo-auditor

安全与审计

查看项目

更新于 10-16 02:38

技能介绍

用途:在 Anthropic Managed Agents 的 14.5 小时任务时限内,通宵自主审计整个代码库,最终产出一份按严重级别评定的汇总报告,覆盖安全、性能、无障碍、依赖与代码质量,全程无需用户提问或确认。

主要能力与工作流: 第一阶段侦察(约 5-10 分钟):扫描仓库结构,识别语言、框架、配置文件,估算代码行数,判断相关审计模块。安全与代码质量始终执行,性能始终执行,无障碍仅在存在前端/模板文件时执行,依赖仅在存在清单或锁文件时执行。侦察结果写入 audit-workspace/00-reconnaissance.md 作为共享上下文。 第二阶段并行审计:通过 Agent 工具同时部署所有相关代理,每次调用使用 run_in_background: true 且全部调用放在同一消息中。每个代理提示由完整侦察报告(需内联粘贴,代理不自动共享文件系统上下文)、references/shared-rubric.md 的严重等级标准与发现格式、以及各自专属 brief 组成。输出文件:01-security-audit.md、02-performance-audit.md、03-accessibility-audit.md(遵循跳过条件)、04-dependency-audit.md(遵循跳过条件)、05-code-quality-audit.md。定向运行时可只部署指定代理并仅在最终报告保留对应章节。 第三阶段编译(约 5-10 分钟):所有后台代理返回后,读取各报告,跨代理去重,评定最终严重等级,生成含前 10 项优先事项的执行摘要,将 overnight-audit-report.md 写入仓库根目录并输出简短完成消息。

运行规则与限制: 完全自主运行,绝不要求用户输入;遇到歧义选择更彻底的方案并记录。对源代码只读,仅创建 audit-workspace/ 目录和 overnight-audit-report.md,绝不修改、构建或执行项目代码;唯一例外是依赖审计员可运行只读包审计命令(npm audit、pip audit 及同类)。在时间窗允许时应详尽而非抽样。

扩展性:按规模估算时长与策略,<10K 行约 15-30 分钟;10K-50K 行约 30-90 分钟;50K-200K 行约 1-4 小时,安全与代码质量可能需要子代理;200K-500K 行约 4-8 小时,各代理生成 2-3 个子代理;500K+ 行约 8-14 小时,全面子代理部署并按文件批次分配。

错误处理:代理失败重试一次,再失败则写部分报告并继续其他代理,报告覆盖缺口;文件访问错误跳过并记录;超时优先高风险文件(认证、支付、数据处理、公开端点),审查超过 2000 个文件时对低风险文件采用抽样策略;重跑会覆盖 audit-workspace/ 与 overnight-audit-report.md,建议先提交或复制先前结果。报告描述源代码,应按源码同等敏感度处理;若 .gitignore 存在但未列出 audit-workspace/,建议添加以防提交审计输出。