用途:在首次推送到 GitHub、仓库转公开或预生产部署前,对代码库做一次逐文件的深度审计,并直接修复发现的问题,而非仅记录问题。
主要能力:清理不应入库的文件(.DS_Store、Thumbs.db、日志、临时文件、构建产物、依赖目录、IDE 文件、备份文件、测试产物等);检查并补全 .gitignore,确认存在不含值的 .env.example;审计死代码(注释代码、未用导入/变量/函数、不可达代码、重复逻辑);代码质量(命名、魔法数字、调试语句、TODO/FIXME、TypeScript any、== 与 ===、超长函数、深层嵌套);逻辑问题(空值检查、未 await 的异步、缺 catch、死循环、switch 缺 default);安全(硬编码密钥、SQL 注入、命令注入、路径遍历、XSS、密码哈希、鉴权与越权、数据暴露、依赖审计);可扩展性(N+1 查询、缺失索引、无界查询、SELECT *、后台队列、限流、缓存、超时);架构(目录结构、关注点分离、超大文件、复用);性能(后端阻塞、批量调用、缓存头;前端代码分割、图片优化、懒加载);文档(README 内容、注释解释原因);测试(关键路径覆盖、残留 test.only/fdescribe、test.skip 需说明);最后运行应用做回归验证。
使用方式:当用户要求“审计代码库”“推送前审查”“清理代码”或“优化一切”时触发。按 SKILL.md 执行工作流,先看 metadata.json 确认仓库、分支、提交与导入路径,再看 ORIGIN.md 了解来源。发现密钥等严重问题标记为 CRITICAL BLOCKER。完成后按固定格式输出报告:已删除文件、代码变更、安全问题、可扩展性改进、最终状态与安全/代码质量/可扩展性评分。
适用场景:首次推送、仓库公开、预生产评审、推送前清理。
限制:仅适用于上述范围;输出不能替代针对具体环境的验证、测试或专家评审;缺少必要输入、权限、安全边界或成功标准时应先询问;不确定是否删除某文件时需询问用户;改动后必须测试。