CLAUDE.md Improver 是一个用于审计、评估和改进代码库中 CLAUDE.md 文件的 Claude 技能,目的是让 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(个人/本地设置,被 gitignore,不共享);全局默认 ~/.claude/CLAUDE.md(跨所有项目的用户级默认值);包级 ./packages/*/CLAUDE.md(monorepo 中的模块级上下文);以及任意嵌套位置的子目录文件(功能/领域特定上下文)。Claude 会自动发现父目录中的 CLAUDE.md 文件,因此 monorepo 可自动生效。
第二阶段:质量评估
对每个 CLAUDE.md 文件按质量标准评估,详细评分细则见 references/quality-criteria.md。快速评估清单包括:命令/工作流是否记录(高)、架构是否清晰(高)、非显性模式是否记录(中)、是否简洁(中)、是否反映当前代码库状态(高)、是否可执行而非含糊(高)。质量分数分为 A(90-100)、B(70-89)、C(50-69)、D(30-49)、F(0-29)。
第三阶段:输出质量报告
始终在做出任何更新之前输出质量报告,格式包含摘要(发现文件数、平均分、需更新文件数)以及逐文件评估(每项标准评分、问题列表、建议补充内容)。
第四阶段:针对性更新
输出质量报告后,更新前需征求用户确认。更新准则强调只提出有针对性、真正有用的补充,例如分析中发现的命令或工作流、代码中的陷阱或非显性模式、此前不清晰的包关系、有效的测试方法、配置上的特殊之处。应保持精简,避免复述代码中显而易见的内容、已覆盖的通用最佳实践、不太可能复现的一次性修复,以及本可用一句话说明却冗长解释的内容。每项更改需展示要更新的文件、具体新增内容(diff 或引用块)以及为何有助于后续会话的简要说明。
第五阶段:应用更新
用户批准后,使用 Edit 工具应用更改,并保留现有内容结构。
模板
references/templates.md 提供按项目类型划分的 CLAUDE.md 模板。
常见需标记的问题
包括失效命令、缺少依赖、过时架构、缺少环境设置、失效测试命令、未记录的特殊行为。
分享给用户的提示
Claude 会话中按 # 键可让 Claude 自动将学到内容写入 CLAUDE.md;保持简洁,密集优于冗长;所有记录的命令应可直接复制粘贴;个人偏好可放入 .claude.local.md(加入 .gitignore);用户级偏好放入 ~/.claude/CLAUDE.md。
优秀 CLAUDE.md 的要点
原则为简洁易读、命令可直接复制粘贴、项目特定模式而非通用建议、记录非显性陷阱与警告。推荐章节(按需使用)包括命令(构建、测试、开发、lint)、架构(目录结构)、关键文件(入口点、配置)、代码风格、环境(所需变量与设置)、测试、陷阱、工作流。