HumanLayer Skills 深度指南references 目录如何组织技能参考资料【免费下载链接】skills项目地址: https://gitcode.com/GitHub_Trending/skills53/skillsHumanLayer Skills 是一个 Claude Code 技能包仓库skills53/skills收录了 improve-claude-md、design-control-loop 等可直接安装的 AI 编程代理技能。本文将拆解其中被公认设计最规范的design-control-loop技能带你快速看懂 references 目录的组织方式帮你轻松写出结构清晰的技能。先认识项目一个技能由什么组成每个技能都遵循统一的目录结构一个SKILL.md主文件 一个references/参考资料目录。以本仓库 README.md 中列出的四个技能为例技能作用references 目录improve-claude-md用important if块重写 CLAUDE.md无narrow-react-prop-types收窄 React 组件 props 类型有design-control-loop设计并构建智能体控制回路有10 个文件show-me用图表可视化解释当前话题无规律很清晰技能越复杂references 目录越丰富。简单技能如 improve-claude-md把所有指令写在一个 SKILL.md 里就够了复杂技能则把长模板和示例拆进 references主文件只留骨架。核心理念渐进式披露主文件保持精简references 目录背后的设计原则是渐进式披露progressive disclosureSKILL.md只写有序的工作步骤、核心规则、可检查的完成标准references/放长模板、完整示例、可运行的代码片段——代理走到对应阶段时才读取。design-control-loop 的 SKILL.md 中明确写道把有序行为写成带完成标准的步骤长的模板和示例移到同级 reference 文件。这样主文件保持几百行以内不会撑爆上下文窗口。案例解剖design-control-loop 的 10 个参考文件references/ 目录下共 10 个文件按职责可分为四类1️⃣ 概念教学类control-loop-taxonomy.md — 控制回路术语表设定值/传感器/控制器/执行器/扰动用于教用户理解概念example-control-loop.md — 一个完整走通的示例回路是说明不是模板2️⃣ 可复用模板类skill-template.md — 生成新技能时的骨架含 Core Requirements、Workflow、Review Checklist 标准结构workflow-template.yml — CI 定时工作流的骨架prompt-template.md — 嵌入 CI 的提示词结构memory-template.md — 跨运行记忆文件的骨架response-template.md — 代理最终输出的 PR 正文格式3️⃣ 完整示例类example-skill.md — 一个格式规范的成品技能示例agent-runner-templates.md — 各编码代理Claude Code、Codex 等的无头命令与密钥配置4️⃣ 可安装代码类agent-iteration.ts — 支持/iterate交互的辅助脚本直接放进目标仓库即可用精华技巧按工作阶段点名引用这个技能最巧妙的一点每个工作阶段开头都写明该读哪些 references。例如Phase B设计回路→ 读 taxonomy、示例、runner 模板Phase C构建执行器技能→ 读 skill-template、example-skill、response-templatePhase E接入 CI→ 读 workflow-template.yml、prompt-template这种到点才读的方式避免了代理一次性吞下全部资料。SKILL.md 末尾 还附了一份完整索引每个文件用一句话说明是什么、何时读——相当于一张自文档化的地图。对比narrow-react-prop-types 的精简版做法该技能的 references 只有 3 个文件体现了按需拆分的克制agent-narrow-component-props.yml — 示例 CI 工作流narrow-component-props-memory.md — 示例记忆文件response-template.md — PR 正文模板含 Summary、Changes Made 表格、Risk Assessment 等固定结构主 SKILL.md 则完整保留 11 步工作流和 180 行的核心规则——因为它本身就是需要逐步执行的流程型技能。给你的实践清单 ✍️主文件只放步骤和判据每个步骤配一条可观测的完成标准参考 skill-template.md 的结构长内容外置模板、示例、CI 配置一律进 references/文件名用类型-用途命名如memory-template.md按阶段点名引用在工作流的相应步骤写明Read: references/xxx避免全量加载模板与示例分开*-template.md是可填充的骨架example-*.md是填好的成品两者各司其职只保留单一事实源同一条规则不要同时写在技能、提示词和记忆文件里掌握了这套 references 组织法你写出的技能会像 HumanLayer 的官方技能一样主文件清爽、资料可检索、代理执行时随用随取。【免费下载链接】skills项目地址: https://gitcode.com/GitHub_Trending/skills53/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考