用途:审计仓库的工具链,评估编码智能体能否自行验证其改动,并输出一份按优先级排序的报告。
主要能力:
- 检测项目上下文:通过 package.json、tsconfig.json、各类锁文件(bun.lockb/bun.lock、pnpm-lock.yaml、yarn.lock、package-lock.json)、pyproject.toml、requirements.txt、Cargo.toml、go.mod 等判断语言、包管理器、运行时与框架(如 Electron、React、Next.js、Vue、Svelte、Express/Fastify/Koa、Django/Flask/FastAPI),并识别 monorepo(workspaces、pnpm-workspace.yaml、lerna.json、nx.json、turbo.json)。
- 扫描现有工具:按语言工具矩阵检查 devDependencies、配置文件与 scripts(test、lint、typecheck、e2e、format、check),并扫描 .github/workflows/*.yml,已在 CI 覆盖的工具标记为 CI-covered 而非 Missing。
- 审计 CLAUDE.md:检查项目级 CLAUDE.md(或 .claude/CLAUDE.md)与全局 ~/.claude/CLAUDE.md,核对是否涵盖项目说明、技术栈、运行方式、测试、lint/类型检查、代码约定、目录结构、注意事项等主题,缺失或内容过薄时给出建议。
- 验证检测结果:对标记为“已安装”的工具做版本抽查(如 bunx vitest --version、pytest --version、cargo clippy --version、golangci-lint --version),失败则降级为“未找到”。
- 生成报告:输出 Agent Summary(missing_critical、missing_important、existing_tools、readiness_score 满分 12)、项目上下文、智能体上下文文件、现有工具表、就绪评分、按 Critical / Important / Nice-to-Have 分层的建议(含安装命令、脚本条目、面向智能体的验证命令)以及 Cheat Sheet。
使用方式:作为智能体技能调用,直接打印完整 Markdown 报告;除非用户要求,不写入文件。
优先级分层:Critical 包括项目 CLAUDE.md、单元/集成测试、lint、类型检查;Important 包括运行时与包管理器、E2E/浏览器测试(仅前端或 Electron)、结构化日志、GitHub CLI、全局 CLAUDE.md;Nice-to-Have 包括安全扫描、静态分析、测试覆盖率、视觉回归(仅在检测到 UI 组件或 Storybook 时)。
限制:仅报告与推荐,不自动安装;不主张替换已有工具,只填空白并附注更快的替代方案;JS/TS 与 Python 支持较完整,Rust/Go 仅给基础建议;无清单文件、空仓库、Electron、monorepo 等有对应处理说明。原文未提供定价、平台支持范围与运行效果数据,暂未提供。