一、基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | claude-md-management | 合集仓库子目录名(见下方说明) |
| 所属合集仓库 | anthropics/claude-plugins-official(Anthropic 官方维护的 Claude Code 插件市场) | GitHub API |
| 作者/维护者 | Anthropic 官方(plugin.json 具名 support@anthropic.com;插件作者 Isabella He <isabella@anthropic.com>) | plugin.json + README |
| 来源链接 | https://github.com/anthropics/claude-plugins-official/tree/main/plugins/claude-md-management | — |
| 许可证 | Apache License 2.0 | GitHub API |
| 所属合集仓库整体 Stars/Forks | 32,213 / 3,591(注:该数字属整个插件市场,不代表本插件自身热度,仅供了解所属市场规模) | GitHub API |
| 该插件自身活跃度 | 该子目录历史提交 4 次,最近一次 2026-02-20(补充 License);功能自 2026-01-16 首次提交后未再有实质改动 | GitHub Commits API |
| 官方市场安装量 | 271,221 次安装 | claude.com 官方插件详情页(实测抓取) |
| 最新版本 | 1.0.0 | plugin.json |
| 安装方式 | 见第十章 | 仓库根 README |
二、功能介绍与亮点
claude-md-management 是 Anthropic 官方发布的 CLAUDE.md 维护插件,专门解决“项目上下文文件写完就过时”这一 Claude Code 用户的通病,包含两个互补组件:
- claude-md-improver(Skill):扫描仓库内全部 CLAUDE.md 文件,对照命令文档完整性、架构清晰度、信息时效性等标准打分评级,生成质量报告后再提出针对性的最小化修改建议,改动前先展示报告、不擅自大改
- /revise-claude-md(命令):在一次工作会话结束时,把本次发现的坑(新命令、代码模式、环境怪癖等)提炼后写回合适的 CLAUDE.md 或
.claude.local.md - 配套三份参考文档(quality-criteria.md 打分标准、templates.md 模板、update-guidelines.md 更新准则),把“什么样的 CLAUDE.md 算好”讲清楚,而不是泛泛而谈
- 定位精准:一个管“审计存量”,一个管“沉淀增量”,覆盖 CLAUDE.md 生命周期的两端
三、适用场景
固定分类:元技能与 Agent 增强
适用于任何已经或计划维护 CLAUDE.md 项目说明文件的 Claude Code 用户与团队——尤其是文件写好后长期没人回头检查、逐渐与代码脱节的常见场景;也适合团队协作中希望把“这次踩的坑”制度化沉淀下来、而不是只存在某个人脑子里的场景。受益人群:日常用 Claude Code 处理多个项目、CLAUDE.md 随项目演进的初中级开发者。
四、跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方 claude-plugins-official 市场一条命令安装,.claude-plugin/命令/技能机制是 Claude Code 插件系统专属实现 |
| Codex | 不支持 | 仓库根 README 明确插件通过 Claude Code 插件系统安装,未见 Codex 兼容说明;CLAUDE.md 本身也是 Claude Code 专属的上下文文件约定 |
| OpenClaw | 未验证 | 已抓取材料未提及,未为此单独搜索 |
| Hermes Agent | 未验证 | 已抓取材料未提及,未为此单独搜索 |
五、推荐理由
Anthropic 官方出品、27万+安装量(在同仓库官方插件中仅次于 43万+安装的 code-review),把“CLAUDE.md 该怎么维护”这个几乎每个 Claude Code 用户都会遇到、却少有标准答案的问题,变成一条命令+一个技能就能落地的固定流程。
六、评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 10 | 官方/一线机构(Anthropic)出品,claude.com 官方页面实测显示 271,221 次安装,在该市场的同类官方插件中仅次于 code-review |
| 可用性 | 8 | 插件市场一条命令安装;README + SKILL.md + 3 份参考文档结构完整;但该子目录最近一次提交在 2026-02-20,仅为补 License |
| 安全性 | 9 | 见下方安全检查清单 |
| 综合评分 | 9.0 | 三项均值 |
安全检查清单:
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行及权限范围 | claude-md-improver 技能内使用 find . -name "CLAUDE.md" 等本地文件发现命令,范围严格限定在扫描当前仓库文件系统,不涉及任何写权限外的操作 |
| ② 运行时联网外发数据 | 未见任何网络调用或外部服务集成,全部处理在本地文件系统内完成 |
| ③ API Key/凭据要求及存储方式 | 无任何凭据请求 |
| ④ 可疑指令/Prompt Injection 迹象 | README 全文与 SKILL.md 全文均经逐条审阅,指令聚焦于“审计+提出最小化改动建议+需用户确认”,未发现试图操纵执行额外操作的文字 |
| ⑤ 作者/组织信誉 | Anthropic 官方仓库,plugin.json 具名,作者 Isabella He 具名邮箱可查 |
| ⑥ License 是否明确 | Apache License 2.0,明确 |
| ⑦ 最近维护时间 | 该子目录 4 次提交,最近 2026-02-20;所属仓库整体近日仍持续提交,未见废弃迹象 |
七、跟同类 Skills 相比的优势
claude-plugins-official 市场内还有多个聚焦不同“元技能”方向的官方插件,可供对照:
| 技能 | 核心定位 | 安装量 | 与本推荐的差异 |
|---|---|---|---|
| claude-md-management(本推荐) | 审计+维护 CLAUDE.md 项目记忆文件 | 271,221 | 该市场内专门解决“项目上下文文件老化”问题的官方方案 |
| hookify | 通过分析对话模式创建 hooks,拦截不想要的行为 | 57,960 | 面向“自定义行为拦截”这一更进阶的自定义场景,学习曲线高于审计一份文档 |
| plugin-dev | 插件开发工具包(agents/commands/MCP 集成脚手架) | 65,020 | 面向“开发新插件”的进阶用户,非日常项目维护刚需 |
| agent-sdk-dev | Claude Agent SDK 开发辅助 | 64,672 | 面向用 SDK 写自定义 Agent 的开发者,受众更窄 |
| mcp-server-dev | 设计与构建 MCP Server | 30,042 | 面向 MCP 服务端开发,文档相对单薄,非普适场景 |
差异化核心:本插件命中的是“几乎每个 Claude Code 用户迟早都会遇到”的高频普适场景,其余几款均偏向某个进阶开发分支(写 hooks、写插件、写 SDK、写 MCP server),受众更窄。
八、用户评价
该插件目前在 Reddit / Hacker News / X(Twitter)等独立渠道尚无一手用户评价或讨论——现有可查证内容均为官方介绍性文字。可参考的客观使用规模数据(271,221 次安装)已列入第一章。
九、其他补充
该插件由 Anthropic 内部工程师 Isabella He 具名维护,与同仓库的 code-review、feature-dev、security-guidance、ralph-loop 等插件同属 2026 年初集中上线的官方插件批次,版本迭代历史暂无公开 changelog。
十、安装使用方式
渠道:Claude Code 插件市场(唯一渠道)
/plugin install claude-md-management@claude-plugins-official
若终端提示找不到该市场,先添加一次:
/plugin marketplace add anthropics/claude-plugins-official
/plugin install claude-md-management@claude-plugins-official
安装后无需重启,直接可用:
- 审计功能:在对话中用自然语言触发,如“审计一下我的 CLAUDE.md”或“check if my CLAUDE.md is up to date”
- 会话学习沉淀:在会话末尾运行
/revise-claude-md
十一、注意事项
- 该子目录最近一次实质性提交距今约 5 个月,功能本身较简单稳定,但如遇 Claude Code 插件机制升级需留意兼容性
- 仅适用于 Claude Code;CLAUDE.md 是 Claude Code 专属的项目上下文约定,其他 Agent 生态无法直接复用该插件
- 审计与会话捕获均为“生成建议、需用户确认”模式,不会自动覆盖已有 CLAUDE.md 内容,但多项目/多团队场景下仍建议先看一遍生成的报告再采纳