技能介绍

需要解决的实际问题

CLAUDE.md 是 Claude Code 的核心规范文件，负责约束代码风格、项目约定和工具使用逻辑。但随着使用时间推移，这个文件往往会逐渐失真：有些规则在真实对话中频繁被违反，说明表述不够明确；有些项目特有的约定（比如特定目录的命名规则、API 调用的优先级）从未被写进去；还有些全局规则因为技术栈更新，已经失去了适用场景。手动维护这些问题需要翻遍大量对话历史，既耗时又容易遗漏关键细节。

技能的核心工作逻辑

这个技能通过分析真实对话历史来反推 CLAUDE.md 的优化方向，核心步骤分为四步：

定位对话历史：首先找到项目的会话记录目录 ~/.claude/projects/，文件夹名由项目路径转换而来——把路径中的斜杠替换成短横线。
提取近期对话：从目录中提取最近 15-20 条会话（排除当前正在进行的会话），保存到临时目录，避免干扰分析结果。
并行子代理分析：启动多个子代理并行处理会话记录，每个代理会同时读取全局 ~/.claude/CLAUDE.md 和项目本地 ./CLAUDE.md（如果存在），并根据会话文件的大小分批处理：

- 大文件（>100KB）：每个代理处理 1-2 条
- 中等文件（10-100KB）：每个代理处理 3-5 条
- 小文件（<10KB）：每个代理处理 5-10 条

聚合分析结果：将所有代理的发现整合成结构化摘要，包含四个部分：

- Instructions violated：现有规则中未被遵守的条目，需要调整表述增强约束力
- Suggested additions - LOCAL：项目特有的模式或约定，适合写入本地 CLAUDE.md
- Suggested additions - GLOBAL：跨项目通用的模式，适合写入全局 CLAUDE.md
- Potentially outdated：可能已经不再适用的条目，建议删除或更新

结果会以表格或列表形式呈现，用户确认后再生成具体的修改草稿。

适用边界与注意事项

这个技能的效果依赖于两个前提：一是项目目录下有足够多的历史会话记录，如果只有几条对话，可能无法提取出有意义的模式；二是会话内容本身包含了足够的上下文信息，模糊或碎片化的对话可能导致分析结果偏离实际需求。此外，技能不会自动修改 CLAUDE.md 文件，所有修改都需要用户明确确认后才会执行。