用途:审计、评估并改进代码库中的 CLAUDE.md 文件,确保 Claude Code 拥有最佳项目上下文。该技能会写入 CLAUDE.md 文件,但仅在展示质量报告并获得用户批准后进行更新。
主要能力与工作流:
- 发现阶段:查找仓库中所有 CLAUDE.md 文件,命令为 find . -name "CLAUDE.md" -o -name ".claude.md" -o -name ".claude.local.md" 2>/dev/null | head -50。文件类型包括项目根 ./CLAUDE.md(提交到 git 共享)、本地覆盖 ./.claude.local.md(gitignored 不共享)、全局默认 ~/.claude/CLAUDE.md(用户级)、包级 ./packages/*/CLAUDE.md 及任意子目录。Claude 会自动发现父目录中的 CLAUDE.md,monorepo 自动生效。
- 质量评估:按命令/工作流(高,20)、架构清晰度(高,20)、非显而易见模式(中,15)、简洁性(中,15)、时效性(高,15)、可操作性(高,15)评分;等级 A(90-100)至 F(0-29)。
- 质量报告:始终在更新前输出报告,含汇总与逐文件评估、问题、建议补充项。
- 针对性更新:报告后询问确认;仅提议真正有用的补充(命令、陷阱、包关系、测试方法、配置怪癖),保持精简,展示 diff 并说明原因。
- 应用更新:批准后用 Edit 工具应用,保留现有内容结构。
适用场景:需要让 Claude Code 更好理解仓库结构、构建测试命令、约定与陷阱时。
限制与提示:该技能会写入 CLAUDE.md,必须先获用户批准;CLAUDE.md 应简洁、人类可读、命令可复制粘贴;个人偏好放 .claude.local.md 并加入 .gitignore;用户级偏好放 ~/.claude/CLAUDE.md。会话中可按 # 让 Claude 自动将学习内容并入 CLAUDE.md。其他细节资料未提供。