Skills、Agents 与工具设计

TL;DR

这页回答的是：Skills、Agents、Subagents、Hooks、MCP、Plugins 这些机制到底怎么分工，什么时候该用哪一个。核心判断是：Skills 正在从“提示词附件”变成可复用流程与工具治理单元；但确定性行为必须交给 Hooks、脚本或权限系统，不能靠模型自觉。[[raw/2026-06-13/TriAi/掌控 Claude Code：CLAUDE.md、Skills、Hooks、Subagents… 七种指令方式，一张表说清楚.md|来源: TriAI 确定性执行]] [[raw/2026-06-17/程序员Carl/Claude Skills实战：Anthropic用了几百个Skill，总结出9大分类和写好Skill的全部经验.md|来源: Anthropic Skills 实践]]

什么时候读这页

要设计或清理 Skill、Subagent、Plugin、Hooks、MCP 分层时。
要判断某条规则该进 CLAUDE.md、Skill、路径规则还是确定性脚本时。
要查渐进式披露、Skill 触发、Skill 管理、安全扫描和负迁移风险时。
要比较“工具能力扩展”和“工作流治理”两类资产时。

核心判断

CLAUDE.md 放高频稳定事实，Skills 放低频成套流程，Subagents 做隔离执行，Hooks/Permissions 做确定性边界。
成熟系统共同走向渐进式披露：启动只加载索引，执行时按需加载细节。
Skill 不是越多越好；容量、触发精度、负迁移、安全扫描和管理成本都会反过来吃掉收益。
Skill 的最高价值不是“会一个工具”，而是把验证、回归、审查、交付这些工程步骤固化成可复用流程。

证据地图

主题	先读段落	代表来源
分层治理	`CLAUDE.md 分层治理与 Skill 准入判断`	[[raw/2026-06-19/吴师兄/面试官皱眉：-Claude Code 你用了半年，CLAUDE.md 多少行了？-我说两千多，他：那今天就到这吧.md
七种机制	`七种定制机制全景比较`	[[raw/2026-06-12/Anthropic/调教 Claude Code 的七种方法.md
渐进式披露	`渐进式披露：所有成熟 Agent 系统不约而同的方向`	[[raw/2026-05-15/三元同学/做 Agent，请必须学会渐进式披露.md
Skill 安全与管理	`2026-07 更新：Skill 触发、管理与安全`	[[raw/2026-07-01/火山引擎 AI 安全/一文了解｜SkillScan 智能体技能安全扫描最佳实践.md
生产级实践	`淘宝企业购：面向 Skills 编程的端到端实践`	[[raw/2026-06-17/行业运营技术/面向Skills编程-淘宝企业购端对端研发提效实践.md

待拆分观察

Skill 触发、管理与安全 可独立成 Skill 治理参考页，承接 SkillScan、触发预算和负迁移案例。
MCP、CLI 与 Skills 已经重复出现多次，后续可合并成一张机制选择表。
Matt Pocock Skills 相关材料可保留为案例段，暂不单独拆页，避免把本页变成社区项目索引。

新增资料把 Skills、Agents 与工具设计这条线补得更完整了。从规范格式、设计模式、渐进式披露，到 Skill 容量上限的隐蔽机制、工程化天花板、以及社区爆款背后的方法论。本轮摄入的核心贡献集中在三个方向：CLAUDE.md 分层治理与配置全景、Skill 设计系统方法论、工业级 Skill 基础设施架构。

子页导航

本页已按主题拆分为四个子页（2026-07-03），下方各节仅保留指向链接：

[[wiki/concepts/Skill 设计方法论与实战案例]] — Skill 设计模式、方法论、Anthropic 内部实践、Matt Pocock 体系、生产级案例
[[wiki/concepts/Skill 治理、进化与安全]] — Skill 基础设施、自进化闭环、容量上限、负迁移、管理与安全扫描
[[wiki/concepts/Agents 编排与 Loop Engineering]] — Subagent/Agent Teams 选型、Dynamic Workflows、Loop Engineering
[[wiki/concepts/机制分层与工具设计]] — CLAUDE.md 分层、七种定制机制、Hooks、工具设计原则、MCP/CLI/Skills 三层分工

CLAUDE.md 分层治理与 Skill 准入判断

→ 已迁移至 [[wiki/concepts/机制分层与工具设计#CLAUDE.md 分层治理与 Skill 准入判断]]

七种定制机制全景比较

→ 已迁移至 [[wiki/concepts/机制分层与工具设计#七种定制机制全景比较]]

渐进式披露：所有成熟 Agent 系统不约而同的方向

→ 已迁移至 [[wiki/concepts/Skill 设计方法论与实战案例#渐进式披露：所有成熟 Agent 系统不约而同的方向]]

Skill 设计模式（Google ADK 五种）

→ 已迁移至 [[wiki/concepts/Skill 设计方法论与实战案例#Skill 设计模式（Google ADK 五种）]]

Skill 设计系统方法论（2026-06 新增）

→ 已迁移至 [[wiki/concepts/Skill 设计方法论与实战案例#Skill 设计系统方法论（2026-06 新增）]]

工业级 Skill 基础设施架构（2026-06 新增）

→ 已迁移至 [[wiki/concepts/Skill 治理、进化与安全#工业级 Skill 基础设施架构（2026-06 新增）]]

Skill Creator 的价值与局限

→ 已迁移至 [[wiki/concepts/Skill 设计方法论与实战案例#Skill Creator 的价值与局限]]

Skill 工程化的天花板：把 Agent 当算法用

→ 已迁移至 [[wiki/concepts/Skill 设计方法论与实战案例#Skill 工程化的天花板：把 Agent 当算法用]]

Hooks 机制深度解析（2026-06 新增）

→ 已迁移至 [[wiki/concepts/机制分层与工具设计#Hooks 机制深度解析（2026-06 新增）]]

Anthropic 内部 Skills 实践：九类框架与四大最佳实践（2026-06 新增）

→ 已迁移至 [[wiki/concepts/Skill 设计方法论与实战案例#Anthropic 内部 Skills 实践：九类框架与四大最佳实践（2026-06 新增）]]

Skill Listing Budget：隐蔽的 1% 截断机制

→ 已迁移至 [[wiki/concepts/Skill 治理、进化与安全#Skill Listing Budget：隐蔽的 1% 截断机制]]

Skill Factory：面向 Harness 的技能工厂

→ 已迁移至 [[wiki/concepts/Skill 设计方法论与实战案例#Skill Factory：面向 Harness 的技能工厂]]

Matt Pocock 现象：心法→招式

→ 已迁移至 [[wiki/concepts/Skill 设计方法论与实战案例#Matt Pocock 现象：心法→招式]]

Skills 管理：两派方法

→ 已迁移至 [[wiki/concepts/Skill 治理、进化与安全#Skills 管理：两派方法]]

工具设计原则（保留原有）

→ 已迁移至 [[wiki/concepts/机制分层与工具设计#工具设计原则（保留原有）]]

Skills 已经进入流程治理层

→ 已迁移至 [[wiki/concepts/Skill 治理、进化与安全#Skills 已经进入流程治理层]]

Agents 正在从角色模板升级为协作单元

→ 已迁移至 [[wiki/concepts/Agents 编排与 Loop Engineering#Agents 正在从角色模板升级为协作单元]]

Skills 的容量上限与选择策略

→ 已迁移至 [[wiki/concepts/Skill 治理、进化与安全#Skills 的容量上限与选择策略]]

Skills 管理踩坑实录

→ 已迁移至 [[wiki/concepts/Skill 治理、进化与安全#Skills 管理踩坑实录]]

Skills + SubAgent 的协同效应

→ 已迁移至 [[wiki/concepts/Agents 编排与 Loop Engineering#Skills + SubAgent 的协同效应]]

生产级 Skills 参考

→ 已迁移至 [[wiki/concepts/Skill 设计方法论与实战案例#生产级 Skills 参考]]

Claude Code 的设计基础设施

→ 已迁移至 [[wiki/concepts/机制分层与工具设计#Claude Code 的设计基础设施]]

Agent Skills 生态四层格局与 npm 时刻

→ 已迁移至 [[wiki/concepts/Skill 治理、进化与安全#Agent Skills 生态四层格局与 npm 时刻]]

Matt Pocock Skills 完整体系

→ 已迁移至 [[wiki/concepts/Skill 设计方法论与实战案例#Matt Pocock Skills 完整体系]]

三器合一：OpenSpec + Superpowers + gstack

→ 已迁移至 [[wiki/concepts/Agents 编排与 Loop Engineering#三器合一：OpenSpec + Superpowers + gstack]]

Skill 自我进化闭环

→ 已迁移至 [[wiki/concepts/Skill 治理、进化与安全#Skill 自我进化闭环]]

设计哲学路线分歧：全自动 vs 人机协作（2026-06 新增）

→ 已迁移至 [[wiki/concepts/Skill 治理、进化与安全#设计哲学路线分歧：全自动 vs 人机协作（2026-06 新增）]]

子代理 vs Agent Teams 选型

→ 已迁移至 [[wiki/concepts/Agents 编排与 Loop Engineering#子代理 vs Agent Teams 选型]]

Claude Code 官方配置插件

→ 已迁移至 [[wiki/concepts/机制分层与工具设计#Claude Code 官方配置插件]]

Skill 25% 负迁移率：最大的警告信号（2026-05 新增）

→ 已迁移至 [[wiki/concepts/Skill 治理、进化与安全#Skill 25% 负迁移率：最大的警告信号（2026-05 新增）]]

SkillOpt：像训练神经网络一样训练 Skill

→ 已迁移至 [[wiki/concepts/Skill 治理、进化与安全#SkillOpt：像训练神经网络一样训练 Skill]]

Dynamic Workflows 与 Skill 的关系

→ 已迁移至 [[wiki/concepts/Agents 编排与 Loop Engineering#Dynamic Workflows 与 Skill 的关系]]

MCP、CLI 与 Skills：三层分工框架

→ 已迁移至 [[wiki/concepts/机制分层与工具设计#MCP、CLI 与 Skills：三层分工框架]]

Skill 的 HTTP 底层交互流（协议映射）

→ 已迁移至 [[wiki/concepts/机制分层与工具设计#Skill 的 HTTP 底层交互流（协议映射）]]

Chromium AI Coding 体系参考

→ 已迁移至 [[wiki/concepts/机制分层与工具设计#Chromium AI Coding 体系参考]]

AgentBuff Skill 选型指南

→ 已迁移至 [[wiki/concepts/Skill 设计方法论与实战案例#AgentBuff Skill 选型指南]]

MCP/CLI/Skills：三层分工框架嵌入

→ 已迁移至 [[wiki/concepts/机制分层与工具设计#MCP/CLI/Skills：三层分工框架嵌入]]

2026-07 更新：Skill 触发、管理与安全

→ 已迁移至 [[wiki/concepts/Skill 治理、进化与安全#2026-07 更新：Skill 触发、管理与安全]]

工具治理四类体系

→ 已迁移至 [[wiki/concepts/机制分层与工具设计#工具治理四类体系]]

生产级 verify-data Skill 全貌

→ 已迁移至 [[wiki/concepts/Skill 设计方法论与实战案例#生产级 verify-data Skill 全貌]]

淘宝企业购：面向 Skills 编程的端到端实践（2026-06-17 新增）

→ 已迁移至 [[wiki/concepts/Skill 设计方法论与实战案例#淘宝企业购：面向 Skills 编程的端到端实践（2026-06-17 新增）]]

Anthropic 内部九大 Skill 分类与编写经验（2026-06-17 新增）

→ 已迁移至 [[wiki/concepts/Skill 设计方法论与实战案例#Anthropic 内部九大 Skill 分类与编写经验（2026-06-17 新增）]]

Matt Pocock：Skill 描述 Token 成本降 63% 的架构拆分（2026-06-18 新增）

→ 已迁移至 [[wiki/concepts/Skill 设计方法论与实战案例#Matt Pocock：Skill 描述 Token 成本降 63% 的架构拆分（2026-06-18 新增）]]

Loop Engineering：第四次抽象跃迁及其对 Skill/工具设计的启示

→ 已迁移至 [[wiki/concepts/Agents 编排与 Loop Engineering#Loop Engineering：第四次抽象跃迁及其对 Skill/工具设计的启示]]