audit 是一个综合审计技能,提供两种模式。默认模式下执行分支审计:对分支 diff 做推送前审查,覆盖 8 个类别并给出 Clean/Minor/Blocking 结论。当用户仅说“audit”且存在有改动的分支时运行分支审计;若指定具体需求(如安全审计、检查文档、审查 UI),则运行相应深度审计,也可一次请求多个审计。
分支审计流程:先收集上下文,确定基线分支(main、master 或上游跟踪分支),运行 git diff <base>...HEAD 获取完整分支 diff,运行 git diff 与 git diff --cached 查看未提交/已暂存改动,运行 git log --oneline <base>..HEAD 查看提交列表,并判断分支意图。报告开头给出分支摘要。随后逐类审计,仅报告有发现的类别,每个发现只出现一次,需有客观证据(文件行号、符号、命令输出或脱敏代码片段),不因文件名、依赖或引文看起来可疑就报告。8 类包括:机密与凭据(最高优先级,报告时须脱敏,如“API key sk_live_...7dc 位于 src/config.py:42”)、非预期改动、调试残留、测试覆盖、构建与测试套件、提交规范、集成检查、合并冲突与变基状态。
严重性分级:Blocking 指可能不宜推送/发布的问题;Minor 指低风险清理或卫生问题;Clean 指无已确认的可行动发现。发现分为已确认、疑似待验证与非发现,疑似项不得夸大为 Blocking。深度安全报告使用 Critical/High/Medium/Low,但分支结论仍映射为 Clean/Minor/Blocking。最后输出确认发现汇总表并给出结论;用户要求修复则修复,否则仅报告。
深度审计需委派给子代理以充分探查代码库,可并行启动,每个子代理产出写入文件的报告并回传要点。深度类型包括:代码质量、文档脆弱性、文档与代码同步、语言最佳实践、并发、资源管理、测试质量、功能完整性等。每个类型均列出具体检查项,资料中功能完整性部分结尾被截断。安全、UI 设计等深度审计的具体检查项在资料中未完整展开。