CLAUDE.md 改进助手
审计并精准改进代码库中的 CLAUDE.md 文件。
明确声明可写入 CLAUDE.md，并要求先输出报告、再征得用户批准；更新指南要求展示 diff、保留结构，具备一定确认与可审查性。扣分原因是授予 Bash、Edit，未明确最小路径权限、敏感信息处理、数据流边界、备份/回滚机制，也未说明 Bash 命令的外部副作用限制。
工作流分为发现、评估、报告、确认、更新五阶段，且包含错误检查清单和失败命令等问题类型。扣分原因是仅静态文档，未提供测试套件或实际复现证据；发现命令使用 find 且运算符未完全加括号，可能产生范围歧义；未定义无文件、重复文件、超出 50 个文件或命令无法验证时的明确失败反馈。
名称、受众和主要触发语义清楚，覆盖项目根、单体仓库、包级及嵌套 CLAUDE.md，并说明只进行针对性更新。扣分原因是未明确不适用场景、输入规模边界、评分依据与输出机器可读格式；未说明中文内容或中文用户工作流支持。核心功能不依赖海外服务，因此没有因中国大陆网络可达性扣分。
文档结构清晰，使用渐进式流程、评分标准、模板、更新指南和验证清单；仓库提供 Apache-2.0 许可证，且官方维护来源已给定。扣分原因是选定 skill 没有版本、变更日志、依赖安装说明、维护责任或专门更新路径；引用的 references 未声明缺失时如何处理，也未提供 FAQ 或兼容性说明。
目标是审计并改进 CLAUDE.md，包含质量评分、逐文件报告、具体问题、推荐补充、diff 和用户确认，理论上能产出可直接审阅的更新方案。扣分原因是静态审查未验证命令、路径或结果正确性；最终更新依赖用户批准且没有示例完成产物，输出仍可能需要较多人工复核。
skill 提供了可审计的流程、评分表、模板、diff 格式和验证清单，仓库还提供维护型 CI 作为上下文证据。扣分原因是没有针对该 skill 的测试套件、运行记录或第三方复现证据，且实际代码库交叉验证仅被要求而未被证明完成；因此不超过静态上限 5。
- 该 skill 可通过 Bash 和 Edit 修改仓库文件；使用前应确认目标路径、审阅 diff，并保留可恢复副本。
- 文档中的命令和文件引用没有在本次静态审查中执行或核验，质量评分可能受项目实际状态影响。
- 发现流程限制为最多 50 个结果，可能遗漏更深层或更多的 CLAUDE.md 文件。
- 未定义敏感信息、符号链接、权限错误和无 CLAUDE.md 文件时的处理策略。
它能做什么 & 适用场景
这是一个用于审计和改进 CLAUDE.md 文件的开发工具技能。它会扫描代码库中的 CLAUDE.md、.claude.md 和 .claude.local.md 文件，并依据预设标准评估内容质量。技能会输出逐文件质量报告，随后在获得用户确认后进行针对性修改。它适合需要维护项目上下文、补充工作流说明或优化项目记忆的 Claude Code 用户。
使用 Glob、Grep、Read 和 Bash 查找并检查代码库中的 CLAUDE.md 文件，包括项目根目录、嵌套目录、包目录和用户级默认文件。它依据命令与工作流、架构清晰度、非显而易见的模式、简洁性、时效性和可操作性进行评分，并生成包含总分、等级、问题和建议补充内容的质量报告。报告完成后，它会等待用户批准，再使用 Edit 对 CLAUDE.md 文件进行针对性更新。
- 维护单体仓库的用户，需要检查根目录和各包目录中的 CLAUDE.md 是否覆盖实际架构。
- 项目迁移或重构后，需要找出过时命令、架构描述和测试说明的开发团队。
- 刚接手代码库的开发者，需要快速评估项目上下文文档是否足够可执行。
- 希望优化项目记忆或进行 CLAUDE.md maintenance 的 Claude Code 用户。
优缺点一览
- 覆盖多个目录层级的 CLAUDE.md 文件。
- 提供明确的评分、等级、问题和改进建议。
- 要求先报告、后征得用户批准，再执行写入。
- 修改重点是命令、架构、测试和项目特有规则等具体内容。
- 面向 CLAUDE.md 和 Claude Code 工作流，迁移到其他客户端需要适配。
- 源材料没有提供测试套件、平台兼容性验证或失败恢复说明。
- 质量评估依赖 references/quality-criteria.md 和 templates.md，但源材料未提供这些文件的内容。
- 技能可以写入 CLAUDE.md，使用前应审阅建议和差异。
如何安装
该技能位于 https://github.com/anthropics/claude-plugins-official 的 plugins/claude-md-management/skills/claude-md-improver/SKILL.md。README 说明插件可通过 Claude Code 插件系统安装：/plugin install {plugin-name}@claude-plugins-official；源材料没有提供此技能的独立安装命令或确切插件名称。
如何使用
在已安装并启用该技能的 Claude Code 会话中提出类似“审计这个仓库的 CLAUDE.md 文件”“检查并改进 CLAUDE.md”或“优化项目记忆”的请求。技能会先输出质量报告；确认建议后，才会修改文件。