企业官网建设流程全解析

HumanLayer Skills 完整指南：黄金模式 Golden Patterns 如何塑造 Agent 行为

【免费下载链接】skills项目地址: https://gitcode.com/GitHub_Trending/skills53/skills

HumanLayer Skills 是一套面向 Claude Code 的开源技能包，它的核心方法论是用**黄金模式（Golden Patterns）**塑造 coding agent 的行为：在自动化之前，先弄清代码库里"一次好改动"长什么样，再把这些既有约定写进SKILL.md，让 Agent 每次自动改动都符合团队习惯。本文带你快速理解这套思路，并看懂 4 个开箱即用的技能。

1 🧭 项目概览：4 个开箱即用的 Claude Code 技能

这个项目提供 4 个可独立安装的 skill，各自解决一类"让 Agent 更听话"的问题：

技能清单与安装方式见 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 <错误来源>

配套的编写纪律包括：

1. 行为按步骤写，每一步带可核查的完成标准；长模板放引用文件，正文保持精简；
2. 每条规则只有一个出处——不要在同一条规则上同时出现在技能、提示词和记忆文件里，避免 Agent 收到互相矛盾的指令；
3. 附响应模板（如 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 下评论/iterate，Agent 加载 PR 上下文后更新记忆和 PR，实现"人留在回路里掌舵"。
• 响应模板：response-template.md 规定 PR 描述必须包含"改动摘要、变更表、真实调用点证据、验证结果、风险评估"，让每次自动 PR 都自带审阅指引。

整个回路的角色划分，参考分类学文档 control-loop-taxonomy.md——其中第 5 个设计问题正是："执行器是哪个 coding agent、需要什么凭据、应遵循哪些黄金模式？"

6 🚀 快速上手：3 步安装 HumanLayer Skills

1. 选择技能：从 README.md 的技能清单中挑一个，比如improve-claude-md；

2. 一行安装：

   npx skills add humanlayer/skills --skill improve-claude-md

3. 在项目里调用：在 Claude Code 中输入/improve-claude-md，技能即开始按黄金模式重写你的CLAUDE.md。

💡 提示：design-control-loop更适合作为"总入口"——它会访谈你的代码库现状，帮你设计并搭建出包含黄金模式技能的完整控制回路。

7 ✅ 小结

一句话总结 HumanLayer Skills 的设计哲学：Agent 的行为质量，取决于你给了它多清晰的"好"的标准；标准越来自真实代码，Agent 就越可靠。

【免费下载链接】skills项目地址: https://gitcode.com/GitHub_Trending/skills53/skills