AI 插件开发工具插件系统【免费下载链接】claude-plugins-officialOfficial, Anthropic-managed directory of high quality Claude Code Plugins.项目地址https://gitcode.com/GitHub_Trending/cl/claude-plugins-official点击查看免费下载CLAUDE.md 是 Claude Code 理解项目上下文的核心载体但代码库持续演进会让它迅速失真、过期甚至误导后续会话。claude-md-management插件中的claude-md-improver技能为此提供了一套系统化的质量评估规范——quality-criteria.md用六个维度、总分 100 分的评分卡对 CLAUDE.md 进行体检并驱动定向改进。本文完整拆解这套评分标准、等级换算、六步评估流程与红线清单并结合仓库中的 SKILL.md、update-guidelines.md 与 templates.md让读者既能读懂评分卡的每一分是如何打出的也能直接落地执行审计与改进。一、评分卡总览六维度 100 分制quality-criteria.md将 CLAUDE.md 的质量拆解为六个可量化的维度每个维度有独立的权重与评分档位满分合计 100 分维度满分核心检查点Commands/Workflows命令与工作流20构建、测试、部署命令是否齐全且带上下文Architecture Clarity架构清晰度20能否让 Claude 快速理解代码库结构Non-Obvious Patterns非显而易见的模式15陷阱、怪癖、边界情况是否被记录Conciseness简洁性15内容是否密集有价值而非废话堆砌Currency时效性15是否反映当前代码库的真实状态Actionability可执行性15指令是否可直接执行而非含糊理论这套评分卡的设计思想很明确CLAUDE.md 不是给人看的装饰性文档而是注入给 Claude Code 的上下文context。因此命令是否可用架构是否可理解内容是否过时这类直接影响后续会话效率的问题被赋予了最高权重而简洁性可执行性则约束内容质量的上限。完整的评分细则见 quality-criteria.md。二、Commands/Workflows20 分命令与工作流完备度这一维度衡量 CLAUDE.md 是否完整记录了项目的基本操作命令各档位如下20 分满分所有关键命令都已记录且附带上下文——构建、测试、lint、部署命令齐全开发工作流清晰常见操作均有文档。15 分大部分命令已记录但部分缺少上下文说明。10 分仅有基础命令没有工作流描述。5 分命令很少大量缺失。0 分完全未记录任何命令。从 SKILL.md 的实战流程看审计时尤其要核对命令是否能跑构建命令是否仍然有效、测试脚本是否已变更、缺失的依赖工具是否被提及——这些都被列为需要重点标记的常见问题Common Issues to Flag。一个好 CLAUDE.md 中的命令应当是可直接复制粘贴的例如 templates.md 推荐用表格形式集中呈现## Commands | Command | Description | |---------|-------------| | install command | Install dependencies | | dev command | Start development server | | build command | Production build | | test command | Run tests | | lint command | Lint/format code |三、Architecture Clarity20 分架构清晰度这一维度考察 CLAUDE.md 能否充当代码库地图帮助 Claude 快速定位文件与理解模块关系。评分档位20 分具备清晰的代码库地图——关键目录得到解释模块间关系有文档入口点entry points被标识在相关处描述了数据流。15 分有良好的结构总览但存在少量遗漏。10 分仅提供基础目录列表。5 分描述含糊或不完整。0 分完全没有架构信息。值得注意的区别在于目录列表与架构地图前者只是把目录树复制进文档后者则解释了每个目录的职责、模块之间的依赖方向以及入口文件的位置。这正是架构维度 10 分与 20 分之间的关键分水岭。对应模板中的写法是带注释的目录树## Architecture root/ dir/ # purpose dir/ # purpose dir/ # purpose在 monorepo 场景中SKILL.md 还提示Claude 会自动发现父目录中的 CLAUDE.md 文件因此包级./packages/*/CLAUDE.md与子目录级文档可以各司其职架构描述也应当按层级拆分避免一份文件试图承载整个仓库的全部结构。四、Non-Obvious Patterns15 分非显而易见的模式代码注释里通常不会写的东西恰恰是这一维度要捕捉的——那些我们为什么这样做的非常规决策与踩坑经验15 分陷阱与怪癖被完整记录——已知问题有文档变通方案workaround有解释边界情况被标注非常规模式附带了为什么这样做的说明。10 分记录了部分模式。5 分模式文档极少。0 分没有任何模式或陷阱记录。update-guidelines.md 给出了这类内容的典型形态## Gotchas - Tests must run sequentially (--runInBand) due to shared DB state - yarn.lock is authoritative; delete node_modules if deps mismatch它同时强调反面教材通用最佳实践如始终为新功能写测试使用有意义的变量名不属于项目特定模式不应写入。这一维度的价值在于它能阻止未来会话重复经历同样的调试过程。五、Conciseness15 分简洁性CLAUDE.md 会作为提示词的一部分被注入每多一行废话就多占用一份宝贵的上下文窗口。因此15 分内容密集且高价值——没有填充内容或显而易见的信息每一行都带来增量价值不与代码注释重复。10 分大体简洁但有少量冗余。5 分部分段落啰嗦。0 分大部分是填充内容或在复述显而易见的代码。update-guidelines.md 给出了鲜明的对比示例。反面案例是长篇解释 JWT 是什么、RFC 7519 是什么标准正面案例只有一行Auth: JWT with HS256, tokens in Authorization: Bearer token header.同时复述代码本身显而易见的信息如UserService类负责用户操作也被明确列为不应添加的内容——类名已经说明了这一点写进 CLAUDE.md 只会稀释密度。核心原则是每一行都必须挣得自己的位置every line must earn its place。六、Currency15 分时效性CLAUDE.md 的最大风险不是写得太少而是写完之后就再也不更新15 分反映当前代码库状态——文档中的命令真实可用文件引用准确技术栈是最新的。10 分大体是最新的存在轻微过期。5 分有若干过期引用。0 分严重过期。在 SKILL.md 的审计流程中时效性检查要求将文档与实际代码库交叉核对执行或至少在脑中推演文档中的命令、检查引用的文件是否真实存在、验证架构描述是否与现状一致。README 中给出的典型触发场景正是数据库架构变更后CLAUDE.md 中遗漏了新添加的 revenue 表与 useRevenue 钩子——这正是时效性失分的真实写照可参考上方示例截图中的问题列表。七、Actionability15 分可执行性文档写得再正确如果指令无法执行价值也趋近于零15 分指令可以直接执行——命令可复制粘贴步骤具体路径真实存在。10 分大部分可执行。5 分部分指令含糊。0 分含糊或停留在理论层面。路径是真实的命令能直接复制是这一维度的硬性要求。模板中所有命令均以可直接复制的形式出现templates.md 的 Update Principles 也反复强调要具体使用真实文件路径、真实命令、要当前对照实际代码库核实、要简短每个概念尽量一行、要有用能否帮助新会话理解项目。八、等级换算与质量报告输出六个维度打分汇总后按总分换算成 A–F 等级见 SKILL.md Phase 2等级分数区间含义A90–100全面、当前、可执行B70–89覆盖良好有少量缺口C50–69只有基础信息缺少关键章节D30–49内容稀疏或已过期F0–29缺失或严重过期评分完成后SKILL.md 的 Phase 3 强制要求在任何修改之前必须先输出质量报告ALWAYS output the quality report BEFORE making any updates。报告的标准格式为## CLAUDE.md Quality Report ### Summary - Files found: X - Average score: X/100 - Files needing update: X ### File-by-File Assessment #### 1. ./CLAUDE.md (Project Root) **Score: XX/100 (Grade: X)** | Criterion | Score | Notes | |-----------|-------|-------| | Commands/workflows | X/20 | ... | | Architecture clarity | X/20 | ... | | Non-obvious patterns | X/15 | ... | | Conciseness | X/15 | ... | | Currency | X/15 | ... | | Actionability | X/15 | ... | **Issues:** - [List specific problems] **Recommended additions:** - [List what should be added]上方示例截图展示的正是该格式的落地形态报告先汇总发现的文件数与平均分再逐文件给出总分与等级接着列出分维度评分表最后点明具体问题如遗漏 revenue 表、遗漏 useRevenue 钩子与推荐修改内容。九、评估流程六步审计法quality-criteria.md 定义了标准化的六步评估流程完整阅读 CLAUDE.md 文件——不遗漏任何章节与实际代码库交叉核对——在脑中或真实地执行文档中记录的命令检查引用的文件是否真实存在验证架构描述是否准确按每个标准逐一打分——六个维度分别给出分数计算总分并给出等级——对照 A–F 换算表列出发现的具体问题——精确到哪个文件、哪句话、什么问题提出具体改进建议——不是泛泛的建议更新文档而是给出可落地的修改方案。在 SKILL.md 中这套流程被扩展为五个阶段发现Discovery用find命令定位所有 CLAUDE.md 文件→ 质量评估Quality Assessment→ 质量报告输出Quality Report→ 定向更新建议Targeted Updates→ 获批后应用修改Apply Updates。整条链路确保先评估、再报告、后修改报告未出之前绝不触碰文件。十、红线清单一眼识别低质量 CLAUDE.mdquality-criteria.md在评分标准之外专门列出了红旗Red Flags清单——审计时一旦发现下列任何一项即可直接判定该文件存在问题会导致失败的命令——路径错误、依赖缺失引用了已删除的文件/目录——文档中的路径指向不存在的内容过时的技术版本——技术栈信息与现状脱节从模板复制粘贴后未做定制——内容与项目无关模板痕迹明显与本项目无关的通用建议——放之四海皆准的废话从未完成的 TODO 项——文档自己都承认的遗留事项多个 CLAUDE.md 文件之间的信息重复——同一信息散落多处维护时极易产生不一致。对照 SKILL.md 的常见问题清单Common Issues to Flag可以看到这些红线在实际审计中的具体表现过期的构建命令、未提及的必要依赖、已变更的文件结构、缺失的环境变量说明、已变化的测试脚本、未记录的陷阱undocumented gotchas。它们共同指向同一个本质——CLAUDE.md 与代码库的漂移drift。十一、从评分到改进定向更新与 diff 规范打分只是手段改进才是目的。评分卡发现缺口后改进阶段遵循 update-guidelines.md 的增删边界应当添加的五类内容分析过程中发现的命令/工作流省去未来会话的重复探索代码中的陷阱与非显而易见模式阻止重复调试从代码中无法直接看出的包/模块依赖关系被验证有效的测试方法环境/配置相关的怪癖如NEXT_PUBLIC_*变量必须在构建时而非运行时设置。明确不添加的四类内容代码显而易见的复述通用最佳实践不太可能再次发生的一次性修复如某个 commit 修了个 bug冗长的解释能用一行说清就不要用一段。每次建议修改都要以diff形式呈现格式规范为三步指明文件与插入位置 → 给出 diff 块 → 一句话说明为什么有用### Update: ./CLAUDE.md **Why:** Build command was missing, causing confusion about how to run the project. diff ## Quick Start bash npm install npm run dev # Start development server on port 3000 提交前还要过一遍 [update-guidelines.md](https://link.gitcode.com/i/c2e96be07af3ed16da21e3c8903aab11) 的验证清单每条新增是否项目特定是否没有通用建议或显而易见的信息命令是否已被测试可用文件路径是否准确新会话看到它是否真的有用是否已是表达该信息最简洁的方式只有在用户批准后才实际修改文件Phase 5Apply Updates。 ## 十二、好 CLAUDE.md 的底层原则 把评分卡的六个维度综合起来可以提炼出一份好 CLAUDE.md的验收标准同样见 [SKILL.md](https://link.gitcode.com/i/92ed17d36d06f6d94094a467e3c57cf4) 的 What Makes a Great CLAUDE.md - **简洁且可读**——密度优先一行为一个概念 - **命令可直接复制粘贴**——满足 Actionability 满分要求 - **记录项目特定模式而非通用建议**——满足 Non-Obvious Patterns 与 Conciseness 的要求 - **捕捉非显而易见的陷阱与警告**——这是区分平庸与优秀文档的分界线。 推荐的章节骨架只选用与项目相关的部分不需要全部Commands、Architecture、Key Files、Code Style、Environment、Testing、Gotchas、Workflow。具体模板项目根目录最小版/完整版、包模块版、monorepo 根版见 [templates.md](https://link.gitcode.com/i/8e81c08bc605c880d01d6b52836bfeb1)。 ## 十三、与维护闭环配套的使用建议 评分卡不是孤立存在的它服务于 claude-md-management 插件的完整维护闭环claude-md-improver 技能负责周期性审计由代码库变更触发适合定期维护配套的 /revise-claude-md 命令负责在会话结束时捕获新学到的上下文见 [revise-claude-md.md](https://link.gitcode.com/i/934270a72ac52a48ed4e0c812cb1589e) 与 [README.md](https://link.gitcode.com/i/e0552ea9041d1dd15113414d1ef05ad8)。日常使用中值得记住的几条建议 - 审计时可用 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 存放跨项目的全局默认 - Claude 会话中按 # 键可让 Claude 自动把本次会话的学习沉淀进 CLAUDE.md - 保持简洁CLAUDE.md 本质上是提示词的一部分密度胜过长度。 掌握这套六维度评分卡之后你不仅能自己给 CLAUDE.md 打分更能看懂 claude-md-improver 每次输出的质量报告背后的打分逻辑从而让项目记忆始终与代码库保持同步。赞分享AI 插件开发工具插件系统【免费下载链接】claude-plugins-officialOfficial, Anthropic-managed directory of high quality Claude Code Plugins.项目地址https://gitcode.com/GitHub_Trending/cl/claude-plugins-official点击查看免费下载相关推荐用 claude-md-improver 技能审计并改进 CLAUDE.md为 Claude Code 构建高质量项目记忆用 claude md improver 技能审计并改进 CLAUDE.md为 Claude Code 构建高质量项目记忆 CLAUDE.md 是 ClaudAI 插件开发工具插件系统用 Toto-2.0-4m-npu 预测监控指标零样本多变量时间序列预测实战指南用 Toto 2.0 4m npu 预测监控指标零样本多变量时间序列预测实战指南 监控指标预测是运维与可观测性场景中最常见的需求之一CPU 使用率、请求延迟人工智能基础模型深度学习本地部署AscendAllData数据质量六维度质量评估模型AllData数据质量六维度质量评估模型 你是否还在为数据不一致、缺失值过多、业务规则冲突等数据质量问题头疼作为企业数字化转型的核心资产低质量数据可能导致大数据数据工程数据集成数据治理数据可视化后端前端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考