终极指南HumanLayer Skills 重写 CLAUDE.md 的 5 大核心原则【免费下载链接】skills项目地址: https://gitcode.com/GitHub_Trending/skills53/skillsskills53/skillsHumanLayer Skills是 HumanLayer 出品的 Claude Code 技能库其中的 improve-claude-md 技能可以按 5 大核心原则自动重写你的 CLAUDE.md用important if条件块显著提升 AI 的指令遵循率。本文带你快速理解这套方法并上手使用 为什么 AI 会选择性忽略你的 CLAUDE.md问题出在 Claude Code 的机制上它给每次注入的 CLAUDE.md 都附带一条系统提醒——此上下文可能与你的任务相关也可能不相关不相关时请勿响应。这意味着Claude 会主动忽略它认为与当前任务无关的段落文件里无关内容越多AI 忽略整个文件包括真正重要的规则的概率就越高improve-claude-md 的解法很巧妙把条件相关的内容包进important ifcondition标签——这正是 Claude Code 自身系统提示词使用的 XML 信号模式等于给模型一个明确的相关性提示让该看的规则穿透可能不相关的框架。完整重写策略定义在 SKILL.md。一键安装 improve-claude-md 技能安装只需一行命令npx skills add humanlayer/skills --skill improve-claude-md安装完成后在你的项目里直接运行/improve-claude-md技能会读取你的现有 CLAUDE.md按下面的 5 大原则完成重写。原则一基础上下文裸写领域指导才包裹不是所有内容都要包进important if这是一个常见误区内容类型示例处理方式项目身份、目录地图、技术栈Express API React 前端裸写在文件顶部领域规则测试模式、API 约定、状态管理用精准条件包裹 判断标准很简单如果一条规则对 90% 以上的任务都相关就裸写只对特定类型的工作相关就包裹。原则二条件必须具体拒绝万能触发宽泛的条件等于没有条件。❌ 反面示例important ifyou are writing or modifying any code - 使用绝对导入 - 使用函数式组件 - 文件用 camelCase 命名 /important✅ 正面做法每条规则拥有自己的窄触发条件——添加或修改导入时创建新组件时创建新文件或目录时各成一组互不混杂也绝不把不相关的规则塞进同一个宽泛条件完整对照见 SKILL.md 原则 2。原则三保持简短谨慎拆分文件不要把 CLAUDE.md 拆成一堆小文件、再让 Agent 靠额外工具调用去逐个发现——important if的价值恰恰在于全部内容内联、按条件加权Agent 看得到全部规则但只关注命中的那部分。除非内容极其冗长复杂否则尽量保持单文件简洁。原则四Less is More删掉工具和代码能替代的指令前沿模型能可靠遵循的指令数量有限Claude Code 系统提示词已占用约 50 条CLAUDE.md 必须尽量精简✂️删掉 linter 辖区缩进、命名、格式等能被 linter / formatter / pre-commit 钩子强制执行的规则全部移除✂️删掉可自发现的规则LLM 是上下文学习者代码库里已有的稳定模式Agent 搜索几次自然就会遵循✂️删掉代码片段片段会过期且撑大文件改用文件路径引用如模式参见src/utils/example.ts原则五保留所有命令命令表是基础参考一条都不许删。即使某些命令很少用Agent 也需要知道有什么可用。做法是把全部命令整体包进一个条件块important ifyou need to run commands to build, test, lint, or generate code [完整的命令表格] /important重写后的标准结构技能产出的 CLAUDE.md 遵循固定结构详见 输出结构说明一行项目身份裸写—— 这是什么、用什么构建Project map裸写—— 目录清单及简述命令表单个包裹块全量保留逐条规则块—— 每条规则独立条件领域分区—— 测试、API、状态管理、i18n 各占一个块9 步执行流程识别身份 → 提取目录地图 → 拆规则 → 删 linter 辖区 → 删代码片段……在 How to Apply 章节 中有完整定义文末还附了一个 Express React Monorepo 的完整前后对比示例Example 章节非常适合照着理解每一处删改的原因。同一个仓库里的其他实用技能技能用途design-control-loop通过访谈帮你设计并构建定制化的 AI 控制回路传感器/控制器/执行器以小而可审查的变更按节奏推进代码库show-me用简明图示、代码结构草图和 HTML 制品帮你直观理解当前话题narrow-react-prop-types收窄 React 组件 prop 类型使其匹配真实代码路径而非 Storybook 或测试状态各技能的安装命令与调用方式汇总在 README.md。总结一句话记住 5 大原则基础裸写、条件收窄、保持简短、大胆删减、命令全留—— 让 CLAUDE.md 从AI 爱答不理的说明书变成条件精准加权的指令集这是提升 Claude Code 指令遵循率最简单有效的一步。【免费下载链接】skills项目地址: https://gitcode.com/GitHub_Trending/skills53/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考