HumanLayer Skills 完整指南黄金模式 Golden Patterns 如何塑造 Agent 行为【免费下载链接】skills项目地址: https://gitcode.com/GitHub_Trending/skills53/skillsHumanLayer Skills 是一套面向 Claude Code 的开源技能包它的核心方法论是用**黄金模式Golden Patterns**塑造 coding agent 的行为在自动化之前先弄清代码库里一次好改动长什么样再把这些既有约定写进SKILL.md让 Agent 每次自动改动都符合团队习惯。本文带你快速理解这套思路并看懂 4 个开箱即用的技能。1 项目概览4 个开箱即用的 Claude Code 技能这个项目提供 4 个可独立安装的 skill各自解决一类让 Agent 更听话的问题技能作用源码位置improve-claude-md用条件化指令块重写CLAUDE.md提升 Agent 对指令的遵循度improve-claude-md/SKILL.mdnarrow-react-prop-types把 React 组件的 props 类型收窄到线上真实代码路径所支持的契约narrow-react-prop-types/SKILL.mddesign-control-loop通过访谈式设计一个感知—控制—执行的 agent 控制回路并自动搭好 CI 工作流design-control-loop/SKILL.mdshow-me用精简图表、伪代码和 HTML 制品把当前话题画出来show-me/SKILL.md技能清单与安装方式见 README.md。2 什么是黄金模式一句话讲清楚黄金模式 代码库中已经被证明好的既有写法与约定比如惯用的目录结构、调用方式、命名风格。它不是凭空制定的规范而是从现有代码中发现出来的事实。在 design-control-loop/SKILL.md 中这条原则被明确列为执行器Actuator搭建前的必做动作Golden patterns first.在自动化之前先确立一次好改动长什么样询问用户是否应遵循代码库中的既有模式并检查代码以找到它们。换句话说先让 Agent 学会像团队里最好的工程师那样改代码再谈无人值守。3 ⚡ 黄金模式塑造 Agent 行为的 3 个机制机制一先读代码找模式再开始自动化design-control-loop的工作流分为 8 个阶段其中 Phase B设计与用户共创回路强制要求询问用户代码库中哪些既有模式应被遵循实际检查代码把找到的模式记录到执行器技能里Phase C 第 2 条Encode the golden patterns from Phase B4 so the agent follows established conventions见 SKILL.md#L86。这一步的价值在于Agent 自动提交 PR 时diff 看起来像是团队里某个熟练成员写的而不是外来机器人写的——审阅成本直接下降。机制二把模式编码进 SKILL.md但只留唯一真相技能模板 references/skill-template.md 甚至把黄金模式写进了 frontmatter 的描述句式description: 动词 任务 when 触发条件; use 真实来源 instead of 错误来源配套的编写纪律包括行为按步骤写每一步带可核查的完成标准长模板放引用文件正文保持精简每条规则只有一个出处——不要在同一条规则上同时出现在技能、提示词和记忆文件里避免 Agent 收到互相矛盾的指令附响应模板如 references/response-template.md规定 Agent 最终输出的格式该输出直接成为 PR 描述。机制三从现有代码学习而不是罗列规则improve-claude-md/SKILL.md 里有一条很朴素的原则删除 Agent 可以从既有代码模式中自行发现的指令——LLM 是上下文学习者只要代码库持续使用某个模式Agent 搜索几次就会跟随。这条与黄金模式一脉相承代码本身就是最好的规范文档。CLAUDE.md只保留代码学不会的东西项目身份、命令表、领域约定风格类规则交给 linter 和既有代码。4 实战案例narrow-react-prop-types 的黄金模式narrow-react-prop-types 是黄金模式最完整的落地案例。它的黄金模式定义非常锋利以线上真实代码路径非测试、非 Storybook 的调用点作为 props 契约的唯一事实来源。具体规则包括见 SKILL.md#L14改动类型前先找到所有真实调用点不能因为 Storybook/测试写起来方便就保留线上根本不进入的可选 prop类型尽量严格用不可能的状态逼出更简单的渲染逻辑偏好从既有 API 派生类型Parameters、ReturnType等而不是手写重复定义。这个技能还附带了一个可直接调度的 CI 示例工作流 agent-narrow-component-props.yml 和配套的 agent 记忆文件是黄金模式 定时自动化的完整样板。5 黄金模式的落地配套记忆文件与 PR 模板黄金模式写进技能只是第一步让它持续生效还需要两个配套件记忆/反馈文件版本化 markdown模板见 memory-template.md每次运行时确定性地注入执行器上下文。适合记录永久排除的范围、已知误报区域、审阅人偏好——这些是人对回路的长期调教。/iterate反馈通道维护者在 PR 下评论/iterateAgent 加载 PR 上下文后更新记忆和 PR实现人留在回路里掌舵。响应模板response-template.md 规定 PR 描述必须包含改动摘要、变更表、真实调用点证据、验证结果、风险评估让每次自动 PR 都自带审阅指引。整个回路的角色划分参考分类学文档 control-loop-taxonomy.md——其中第 5 个设计问题正是执行器是哪个 coding agent、需要什么凭据、应遵循哪些黄金模式6 快速上手3 步安装 HumanLayer Skills选择技能从 README.md 的技能清单中挑一个比如improve-claude-md一行安装npx skills add humanlayer/skills --skill improve-claude-md在项目里调用在 Claude Code 中输入/improve-claude-md技能即开始按黄金模式重写你的CLAUDE.md。 提示design-control-loop更适合作为总入口——它会访谈你的代码库现状帮你设计并搭建出包含黄金模式技能的完整控制回路。7 ✅ 小结要点说明黄金模式是什么从既有代码中发现的好改动标准何时确定自动化之前Phase B 必做动作写在哪里SKILL.md且每条规则只有一个出处如何保持记忆文件 /iterate持续调教效果Agent 的自动 PR 像团队成员写的审阅成本最低一句话总结 HumanLayer Skills 的设计哲学Agent 的行为质量取决于你给了它多清晰的好的标准标准越来自真实代码Agent 就越可靠。【免费下载链接】skills项目地址: https://gitcode.com/GitHub_Trending/skills53/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 HumanLayer Skills 完整指南：黄金模式 Golden Patterns 如何塑造 Agent 行为
HumanLayer Skills 完整指南黄金模式 Golden Patterns 如何塑造 Agent 行为【免费下载链接】skills项目地址: https://gitcode.com/GitHub_Trending/skills53/skillsHumanLayer Skills 是一套面向 Claude Code 的开源技能包它的核心方法论是用**黄金模式Golden Patterns**塑造 coding agent 的行为在自动化之前先弄清代码库里一次好改动长什么样再把这些既有约定写进SKILL.md让 Agent 每次自动改动都符合团队习惯。本文带你快速理解这套思路并看懂 4 个开箱即用的技能。1 项目概览4 个开箱即用的 Claude Code 技能这个项目提供 4 个可独立安装的 skill各自解决一类让 Agent 更听话的问题技能作用源码位置improve-claude-md用条件化指令块重写CLAUDE.md提升 Agent 对指令的遵循度improve-claude-md/SKILL.mdnarrow-react-prop-types把 React 组件的 props 类型收窄到线上真实代码路径所支持的契约narrow-react-prop-types/SKILL.mddesign-control-loop通过访谈式设计一个感知—控制—执行的 agent 控制回路并自动搭好 CI 工作流design-control-loop/SKILL.mdshow-me用精简图表、伪代码和 HTML 制品把当前话题画出来show-me/SKILL.md技能清单与安装方式见 README.md。2 什么是黄金模式一句话讲清楚黄金模式 代码库中已经被证明好的既有写法与约定比如惯用的目录结构、调用方式、命名风格。它不是凭空制定的规范而是从现有代码中发现出来的事实。在 design-control-loop/SKILL.md 中这条原则被明确列为执行器Actuator搭建前的必做动作Golden patterns first.在自动化之前先确立一次好改动长什么样询问用户是否应遵循代码库中的既有模式并检查代码以找到它们。换句话说先让 Agent 学会像团队里最好的工程师那样改代码再谈无人值守。3 ⚡ 黄金模式塑造 Agent 行为的 3 个机制机制一先读代码找模式再开始自动化design-control-loop的工作流分为 8 个阶段其中 Phase B设计与用户共创回路强制要求询问用户代码库中哪些既有模式应被遵循实际检查代码把找到的模式记录到执行器技能里Phase C 第 2 条Encode the golden patterns from Phase B4 so the agent follows established conventions见 SKILL.md#L86。这一步的价值在于Agent 自动提交 PR 时diff 看起来像是团队里某个熟练成员写的而不是外来机器人写的——审阅成本直接下降。机制二把模式编码进 SKILL.md但只留唯一真相技能模板 references/skill-template.md 甚至把黄金模式写进了 frontmatter 的描述句式description: 动词 任务 when 触发条件; use 真实来源 instead of 错误来源配套的编写纪律包括行为按步骤写每一步带可核查的完成标准长模板放引用文件正文保持精简每条规则只有一个出处——不要在同一条规则上同时出现在技能、提示词和记忆文件里避免 Agent 收到互相矛盾的指令附响应模板如 references/response-template.md规定 Agent 最终输出的格式该输出直接成为 PR 描述。机制三从现有代码学习而不是罗列规则improve-claude-md/SKILL.md 里有一条很朴素的原则删除 Agent 可以从既有代码模式中自行发现的指令——LLM 是上下文学习者只要代码库持续使用某个模式Agent 搜索几次就会跟随。这条与黄金模式一脉相承代码本身就是最好的规范文档。CLAUDE.md只保留代码学不会的东西项目身份、命令表、领域约定风格类规则交给 linter 和既有代码。4 实战案例narrow-react-prop-types 的黄金模式narrow-react-prop-types 是黄金模式最完整的落地案例。它的黄金模式定义非常锋利以线上真实代码路径非测试、非 Storybook 的调用点作为 props 契约的唯一事实来源。具体规则包括见 SKILL.md#L14改动类型前先找到所有真实调用点不能因为 Storybook/测试写起来方便就保留线上根本不进入的可选 prop类型尽量严格用不可能的状态逼出更简单的渲染逻辑偏好从既有 API 派生类型Parameters、ReturnType等而不是手写重复定义。这个技能还附带了一个可直接调度的 CI 示例工作流 agent-narrow-component-props.yml 和配套的 agent 记忆文件是黄金模式 定时自动化的完整样板。5 黄金模式的落地配套记忆文件与 PR 模板黄金模式写进技能只是第一步让它持续生效还需要两个配套件记忆/反馈文件版本化 markdown模板见 memory-template.md每次运行时确定性地注入执行器上下文。适合记录永久排除的范围、已知误报区域、审阅人偏好——这些是人对回路的长期调教。/iterate反馈通道维护者在 PR 下评论/iterateAgent 加载 PR 上下文后更新记忆和 PR实现人留在回路里掌舵。响应模板response-template.md 规定 PR 描述必须包含改动摘要、变更表、真实调用点证据、验证结果、风险评估让每次自动 PR 都自带审阅指引。整个回路的角色划分参考分类学文档 control-loop-taxonomy.md——其中第 5 个设计问题正是执行器是哪个 coding agent、需要什么凭据、应遵循哪些黄金模式6 快速上手3 步安装 HumanLayer Skills选择技能从 README.md 的技能清单中挑一个比如improve-claude-md一行安装npx skills add humanlayer/skills --skill improve-claude-md在项目里调用在 Claude Code 中输入/improve-claude-md技能即开始按黄金模式重写你的CLAUDE.md。 提示design-control-loop更适合作为总入口——它会访谈你的代码库现状帮你设计并搭建出包含黄金模式技能的完整控制回路。7 ✅ 小结要点说明黄金模式是什么从既有代码中发现的好改动标准何时确定自动化之前Phase B 必做动作写在哪里SKILL.md且每条规则只有一个出处如何保持记忆文件 /iterate持续调教效果Agent 的自动 PR 像团队成员写的审阅成本最低一句话总结 HumanLayer Skills 的设计哲学Agent 的行为质量取决于你给了它多清晰的好的标准标准越来自真实代码Agent 就越可靠。【免费下载链接】skills项目地址: https://gitcode.com/GitHub_Trending/skills53/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考