用途:对代码仓库做 principal 级审计并给出按优先级排序的改进计划,适用于“审计这个仓库”“项目评审”“健康检查”“改进计划”、重大模型或工具升级后的重新基线、大重构前的需求确认,以及接手陌生代码库时的上手分析。
主要能力:按四个阶段依次执行——发现与测绘(目录结构、项目类型、语言框架、入口点、核心模块、数据与控制流、依赖与配置、CI、文档、既有约定,输出 Repo Map);取证审计(架构设计、代码质量、安全、测试、性能、依赖、DevEx 与运维、文档,每条含发现内容、file:line 位置、具体后果、严重度 Critical/High/Medium/Low,并单列优势);改进策略(归纳 3–5 个主导主题、目标状态与原则、明确不修的取舍、可衡量的完成标准);详细任务计划(每项含标题、说明、受影响文件、验收标准、工作量 S/M/L/XL、变更风险、依赖,按里程碑 0 安全网、1 关键修复、2 高杠杆、3 质量打磨排序,另列快速见效项,前 3 项附实现概要)。
使用方式:可通过 skill repo-audit、命令 /ai-eng/repo-audit 或 agent repo-audit-review 调用。约束:不得修改代码,仅作分析;唯一写入是生成报告文件 reports/YYYY-MM-DD-repo-audit.md,目录不存在则创建;需运行仓库自身的校验命令(类型检查、lint、测试)并报告真实结果。最终文档含执行摘要、Repo Map、审计报告、改进策略、任务计划、待决问题,并在对话中直接给出执行摘要与快速见效项及报告路径。
限制:所有结论须以文件路径和行号为依据,无法验证时须明确说明而非猜测;宁可给 15 条高置信度发现而非 50 条推测;需区分事实与判断;按项目成熟度校准建议,原型不推荐企业级基础设施;大型仓库优先深入贡献 80% 价值的核心 20% 代码并标注复审较轻区域;不凑字数,健康维度一句话带过。