这个 Skill 能做什么,适合哪些场景?
这是一个用于审计和改进 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 用户。
如何安装这个 Skill?
- 该 skill 可通过 Bash 和 Edit 修改仓库文件;使用前应确认目标路径、审阅 diff,并保留可恢复副本。
- 文档中的命令和文件引用没有在本次静态审查中执行或核验,质量评分可能受项目实际状态影响。
- 发现流程限制为最多 50 个结果,可能遗漏更深层或更多的 CLAUDE.md 文件。
- 未定义敏感信息、符号链接、权限错误和无 CLAUDE.md 文件时的处理策略。
- Shell / 命令行
- 本地文件系统
该技能位于 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;源材料没有提供此技能的独立安装命令或确切插件名称。
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/anthropics/claude-plugins-official.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/plugins/claude-md-management/skills/claude-md-improver" ~/.claude/skills/
rm -rf "$tmp"根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。
如何使用这个 Skill?
安装后,把下面任意一句发给 Agent 即可触发:
- 审计这个仓库的 CLAUDE.md 文件
- 检查并改进 CLAUDE.md
- 优化项目记忆
在已安装并启用该技能的 Claude Code 会话中提出类似“审计这个仓库的 CLAUDE.md 文件”“检查并改进 CLAUDE.md”或“优化项目记忆”的请求。技能会先输出质量报告;确认建议后,才会修改文件。
这个 Skill 有哪些优点和局限?
- 覆盖多个目录层级的 CLAUDE.md 文件。
- 提供明确的评分、等级、问题和改进建议。
- 要求先报告、后征得用户批准,再执行写入。
- 修改重点是命令、架构、测试和项目特有规则等具体内容。
- 面向 CLAUDE.md 和 Claude Code 工作流,迁移到其他客户端需要适配。
- 源材料没有提供测试套件、平台兼容性验证或失败恢复说明。
- 质量评估依赖 references/quality-criteria.md 和 templates.md,但源材料未提供这些文件的内容。
- 技能可以写入 CLAUDE.md,使用前应审阅建议和差异。
这个 Skill 与同类方案有什么区别?
与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| CLAUDE.md 改进助手 本页 ✓ Anthropic · 官方 | 53 · 谨慎使用 | ★ 38k | 11 天前 | Apache-2.0 |
| Jetson 目标知识库生成器 ✓ NVIDIA · 官方 | 54 · 谨慎使用 | ★ 3.6k | 11 天前 | Apache-2.0 |
| Claude Reflect 自学习记忆系统 | 57 · 谨慎使用 | ★ 1.8k | 22 天前 | MIT |
| 高级 LLM 评测 | 56 · 谨慎使用 | ★ 18k | 13 天前 | MIT |
| Supermemory 保存技能 | 34 · 不推荐 | ★ 2.8k | 13 天前 | — |
FollowSkills 如何评估这个 Skill?
明确声明可写入 CLAUDE.md,并要求先输出报告、再征得用户批准;更新指南要求展示 diff、保留结构,具备一定确认与可审查性。扣分原因是授予 Bash、Edit,未明确最小路径权限、敏感信息处理、数据流边界、备份/回滚机制,也未说明 Bash 命令的外部副作用限制。
工作流分为发现、评估、报告、确认、更新五阶段,且包含错误检查清单和失败命令等问题类型。扣分原因是仅静态文档,未提供测试套件或实际复现证据;发现命令使用 find 且运算符未完全加括号,可能产生范围歧义;未定义无文件、重复文件、超出 50 个文件或命令无法验证时的明确失败反馈。
名称、受众和主要触发语义清楚,覆盖项目根、单体仓库、包级及嵌套 CLAUDE.md,并说明只进行针对性更新。扣分原因是未明确不适用场景、输入规模边界、评分依据与输出机器可读格式;未说明中文内容或中文用户工作流支持。核心功能不依赖海外服务,因此没有因中国大陆网络可达性扣分。
文档结构清晰,使用渐进式流程、评分标准、模板、更新指南和验证清单;仓库提供 Apache-2.0 许可证,且官方维护来源已给定。扣分原因是选定 skill 没有版本、变更日志、依赖安装说明、维护责任或专门更新路径;引用的 references 未声明缺失时如何处理,也未提供 FAQ 或兼容性说明。
目标是审计并改进 CLAUDE.md,包含质量评分、逐文件报告、具体问题、推荐补充、diff 和用户确认,理论上能产出可直接审阅的更新方案。扣分原因是静态审查未验证命令、路径或结果正确性;最终更新依赖用户批准且没有示例完成产物,输出仍可能需要较多人工复核。
skill 提供了可审计的流程、评分表、模板、diff 格式和验证清单,仓库还提供维护型 CI 作为上下文证据。扣分原因是没有针对该 skill 的测试套件、运行记录或第三方复现证据,且实际代码库交叉验证仅被要求而未被证明完成;因此不超过静态上限 5。
点击维度查看打分理由
证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。
查看完整评分方法 →