HumanLayer Skills 入门指南：/improve-claude-md 让 AI 更听话的秘密
【免费下载链接】skills项目地址: https://gitcode.com/GitHub_Trending/skills53/skills
HumanLayer Skills 是 HumanLayer 开源的一套 Claude Code 技能（Skills）插件合集，其中的/improve-claude-md技能能用条件块改写你项目里的CLAUDE.md规则文件，专治 AI"不听话"的顽疾。这篇入门指南会带你从零看懂它的原理，3 分钟装好第一个技能。
什么是 HumanLayer Skills？为什么值得试
一句话概括：这是给 Claude Code 装的"超能力插件包"。
Claude Code 是跑在命令行里的 AI 编码助手，它靠读取项目根目录的CLAUDE.md来理解"这个项目该怎么写代码"。但很多开发者都撞过同一堵墙——规则写得越多，AI 反而越容易全部忽略。
这个仓库把解决经验做成了可安装的技能。插件清单 marketplace.json 中目前登记了 5 个技能：
| 技能 | 一句话介绍 |
|---|---|
improve-claude-md | 用条件块重写 CLAUDE.md，提升 AI 对指令的遵循度 |
narrow-react-prop-types | 收窄 React 组件 Props 类型，让类型贴合真实代码路径 |
design-control-loop | 面试式设计一个"智能体控制回路"并自动搭建 |
show-me | 用简洁图示和 HTML 可视化解释当前主题 |
build-iterated-agentic-loop | 构建仓库级技能 + 定期运行的编码代理工作流 |
📌 每个技能对应 plugins/ 下的一个目录，整体介绍见 README.md。
快速上手：3 步装好 /improve-claude-md
第 1 步：一条命令安装技能（需要 Node.js 环境）
npx skills add humanlayer/skills --skill improve-claude-md第 2 步：进入你的项目目录，启动 Claude Code。
第 3 步：输入斜杠命令，等待 AI 重写规则文件
/improve-claude-md💡 想看源码细节？可以克隆仓库：
git clone https://gitcode.com/GitHub_Trending/skills53/skills，核心规则全部写在 SKILL.md 这一个文件里。
让 AI 更听话的秘密：条件块<important if>
为什么 AI 会"装聋"？根源藏在系统提示里——Claude Code 每次注入CLAUDE.md时都会附带一句：
"this context may or may not be relevant to your tasks... You should not respond to this context unless it is highly relevant to your task."
翻译过来：文件里与当前任务无关的内容越多，AI 越可能整篇忽略——包括真正重要的部分。
解法是用<important if="条件">标签把"只在特定情况下才用得上"的规则包起来。这个写法借用了 Claude Code 系统提示自身的 XML 标签模式，等于给模型一个明确的"相关性信号"。看官方示例（节选自 SKILL.md）：
<important if="you need to run commands to build, test, lint, or generate code"> Run with `turbo` from the repo root. | `turbo build` | Build all packages | | `turbo test` | Run all tests | </important> <important if="you are creating new components"> - Use functional components with TypeScript interfaces for props </important>AI 接到"新建组件"任务时，第二个块立刻被"点亮"；命令表则只在跑命令时才相关。所有内容都摆在明面上，但模型只关注匹配当前任务的部分——这正是技巧的精髓。
5 条编写原则：高遵循度 CLAUDE.md 的关键
完整原则见 SKILL.md 的 Principles 章节，速记版：
- 基础内容保持"裸写"——项目定位、目录地图、技术栈对 90% 以上任务都相关，直接写在文件顶部。
- 条件要具体、要窄——"写任何代码时"是坏条件，"正在增删 import 时"是好条件，每条规则配专属触发器。
- 保持短小，别拆文件——内联条件块优于让 AI 额外读一堆文件。
- 少即是多——能被 linter 检查的规则、能从现有代码模式里"悟"出来的规则，统统删掉。
- 保留全部命令——命令表是 AI 的基础参考，哪怕低频命令也不能丢。
改写前后对比：到底改了什么
技能内置了一个完整的 Turborepo monorepo 实例（输入输出对照），改写结果非常直观：
被删掉的
- camelCase/PascalCase、
constvslet、严格相等……——全是 linter 和格式化工具的地盘； - "遵循最佳实践"这类模糊、不可执行的指令。
被保留的
- 项目定位与目录地图（顶部裸写，不包条件块）；
- 完整命令表（连
analyze这种低频命令都保留）； - API、测试、状态管理等领域规则——各自独立成块，配上专属条件。
一句话总结：把"一堆规则让 AI 一次性全读"，变成"一堆规则按任务逐个亮起"。
同仓库还藏着哪些宝贝
🧩 装完/improve-claude-md后，这三个技能也很值得看看：
- React 类型收窄：narrow-react-prop-types 专治"为了让测试/Storybook 方便而放宽的 Props"，把类型收窄回真实生产代码路径的契约，并坚持"让测试适应类型，而不是反过来"。
- 智能体控制回路：design-control-loop 借用控制论的"传感器—控制器—执行器"模型，让 AI 定期测量代码库与目标状态的差距，做出小而可评审的变更并提 PR。设计方法论在 control-loop-taxonomy.md。
- 可视化讲解：show-me 让 AI 用伪代码、调用树、Mermaid 图甚至 HTML 小页面解释当前话题，新手啃复杂逻辑时特别好用。
常见问题
Q：项目里还没有 CLAUDE.md，能用吗？可以。技能的触发条件是"提供一份 CLAUDE.md 或请求改进它"——先让 Claude Code 生成一份初稿，再跑/improve-claude-md做结构化改写即可。
Q：为什么命令表不删？命令太多不也"占位"吗？技能的原则是保留全部命令，因为命令属于高频基础参考，AI 需要随时知道"有什么可用"。真正拉低遵循度的不是篇幅，而是"永远用不上"的规则——那正是条件块要消灭的。
Q：需要是 Claude Code 老手吗？不需要。全程只有两条命令，唯一前提是项目里有 Node.js 环境。
写在最后：HumanLayer Skills 把"怎么写好 CLAUDE.md"沉淀成了可安装的标准流程。对新手来说，/improve-claude-md是最值得先装的一个——花 5 分钟，让 AI 从"选择性听话"变成"按任务精准听话"。
【免费下载链接】skills项目地址: https://gitcode.com/GitHub_Trending/skills53/skills
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
