SuperAPI AI 工具集

code-audit

测试与质量

查看项目

更新于 10-15 21:52

技能介绍

用途:对代码库或指定范围做彻底、语言无关的审计,输出按严重程度排序的结构化报告,保存为项目根目录下的自包含文件。

主要能力:逐行阅读范围内代码,追踪从外部输入到处理层、输出与存储的数据流,并跨模块边界跟踪调用链。审计类别包括竞态条件与并发、死代码、反模式与代码异味、性能、正确性、错误处理缺口、测试质量。安全分析被有意排除;若请求涉及漏洞、注入、认证授权、密钥、加密、依赖 CVE、OWASP、IaC 或 CI/CD,建议改用 security-audit 技能。

使用方式:先确定范围(整个仓库、目录、文件列表、自然语言描述的功能区域,或文件内特定函数/类/代码区域)。报告格式需在启动消息中明确,或由技能询问:HTML(默认,自包含文件,含内联 SVG 数据流图、严重程度徽章、可折叠 Intent Brief 主题与交叉引用锚点)或 MD(纯 Markdown)。文件名分别为 AUDIT-REPORT-YYYY-MM-DD.html 与 AUDIT-REPORT-YYYY-MM-DD.md。

流程:解析范围并排除生成文件(锁文件、编译产物、vendored 依赖、压缩包),除非用户明确包含;对提交的生成代码检查修改标记。选择并确认审计类别,宽泛请求默认全部类别。通过三个并行子代理发现意图:文档扫描、代码意图扫描、git 历史扫描,产出按主题组织的 Intent Brief。分析分两阶段:Phase A 文件级逐项检查,Phase B 跨文件追踪数据流与调用链、检查架构问题。范围超过 50 个文件或 10,000 行时使用并行子代理分区,按服务或架构层划分。最后去重、合并同一根因、移除误报、统一严重程度,再生成报告。

限制:安全审计不在范围内;生成与 vendored 代码不做文件级分析,仅在边界报告发现;若指定路径不存在会警告并继续,全部不存在则停止询问;范围不明确时只问一个澄清问题;重新审计时默认沿用原范围,并标注已解决与仍存在的发现。具体模板细节、严重程度指南与检查清单见技能内 references 文件。