用途:对代码库执行结构化、基于证据的审计。调用方式为 /audit [domain?],domain 可选 security、contracts、patterns、observability、ops 或 all;不填 domain 时默认运行全部领域。
主要能力:审计分两阶段,且必须按顺序执行。第一阶段为上下文检测,始终先运行,需明确语言、运行时/框架、认证机制、数据层、基础设施、API 形态、测试策略与 CI,并至少读取根目录布局、一个依赖清单、一个入口点或应用引导文件、一个配置示例;大型或 monorepo 仓库需按组件分别说明上下文,并说明抽样范围,不得声称读完整棵树。第二阶段按请求的领域应用检查,并适配实际存在的组件,缺失组件跳过对应检查。
各领域核心检查:security 关注认证是否在应有位置强制执行、公开路由是否显式、密钥是否出现在代码或提交配置与历史中、边界输入校验、安全响应头、会话/令牌失效;依赖 CVE 仅在本会话运行受支持扫描器(govulncheck、osv-scanner、npm audit)时才作为发现报告,否则明确标注未验证。contracts 关注声明 API 面与实现是否一致、破坏性变更是否受保护/版本化/记录、文档是否单一来源生成、内部消费者是否依赖声明契约。patterns 关注错误处理是否显式/类型化、依赖方向与分层、配置是否启动时加载校验、抽象是否有实际用途、语言/框架惯例、可变状态边界。observability 关注错误日志上下文、日志是否避免 PII、健康检查是否反映依赖、边界指标/追踪。ops 关注构建可复现性、CI 是否真正运行其声称的检查、依赖锁定与校验、本地/入职步骤、迁移/部署回滚。
行为规则:证据优先,先读或搜索再下结论,推断需标注 INFERRED 并说明可确认的文件;只报告错误、不完整或真实风险项,不列优点;某领域无发现则输出 [DOMAIN] PASS;位置优先 path/to/file:line,流程级问题用 (process / CI / policy);修复须可操作;每条发现标注严重级别 BLOCKER、HIGH、MEDIUM、LOW;结尾给出 AUDIT PASSED 或 AUDIT FAILED 及计数,存在 BLOCKER 即失败。
安全限制:除非用户在同一会话明确要求,不得执行破坏性操作(数据库重置、生产部署、批量删除、git push --force 等),仅使用只读检查,如读文件、Glob、Grep 和只读 git 命令(git log -1、git grep),不得重写历史。
输出格式:先输出 Context 块(日期、审计领域、语言、运行时/框架、认证、数据层、基础设施、API 面、测试、CI、抽样说明),再按领域输出审计报告,每条发现含严重级别、标题、位置、影响、修复,最后给出结论与计数。
适用场景:需要在合并前或上线前对代码库做多维度风险审查的团队。限制:资料未提供具体安装方式、收费、价格、平台支持或效果数据。