---
title: "扩展与自动化"
description: "Claude Code 扩展与自动化：从扩展能力地图开始，逐章掌握 Skills、Subagents、Hooks、Commands 和 Agent SDK 的分工与组合。"
canonical: "https://xiangyugongzuoliu.com/tag/claude-code"
verifiedAt: "2026-05-05"
---

这一组解决“稳定使用之后，怎么把重复经验、隔离任务、确定性自动化和产品化能力沉淀下来”。先不要一上来写 SDK 或 Plugin；先判断问题属于规则、流程、连接、隔离、自动化、入口还是产品化。

> [!NOTE]
> **适合读这一组的人**：已经理解 settings、permissions、memory 和 MCP，想把重复流程做成 Skill，把大任务拆给 Subagents，把固定动作交给 Hooks，理解 `/` 命令体系，或把 Claude Code agent loop 接进自己的程序。

## 1. 这一组包含什么

扩展与自动化一共 6 章：

- 查看扩展能力地图：先分清 `CLAUDE.md`、Rules、Skills、MCP、Subagents、Hooks、Commands、Plugins、Agent SDK 的职责。
- 使用 Skills：把重复流程、参考资料和可调用工作流沉淀成 `SKILL.md`。
- 配置 Subagents：用隔离上下文处理探索、审查、并行验证和专门 worker。
- 使用 Hooks：在生命周期事件上做格式化、阻断、通知、审计和自动化。
- 使用 Commands：理解 built-in commands、bundled skills、自定义 Skill commands、legacy commands 和 MCP prompts。
- 使用 Agent SDK：把 Claude Code 的 agent loop、工具、上下文、权限和扩展能力放进 Python / TypeScript 程序。

```mermaid
flowchart TD
    Map["扩展能力地图"]
    Skills["Skills：流程和知识"]
    Subagents["Subagents：隔离 worker"]
    Hooks["Hooks：确定性自动化"]
    Commands["Commands：会话入口"]
    SDK["Agent SDK：程序化入口"]

    Map --> Skills
    Map --> Subagents
    Map --> Hooks
    Skills --> Commands
    Hooks --> Commands
    Subagents --> SDK
    Commands --> SDK

    style Map fill:#e0f2fe,stroke:#0284c7,stroke-width:2px
    style Hooks fill:#fef3c7,stroke:#f59e0b,stroke-width:2px
    style SDK fill:#dcfce7,stroke:#22c55e,stroke-width:2px
```

## 2. 章节入口

<Cards>
  <Card title="查看扩展能力地图" description="先判断问题属于记忆、流程、连接、隔离、自动化、入口、分发还是产品化。" href="/docs/claude-code/official/02-extensions-automation/extension-map" />
  <Card title="使用 Skills" description="用 SKILL.md 沉淀重复流程、参考资料、参数、动态上下文和 context fork。" href="/docs/claude-code/official/02-extensions-automation/skills" />
  <Card title="配置 Subagents" description="隔离大量探索和专项审查，控制 tools、MCP、skills、memory、background 和 worktree。" href="/docs/claude-code/official/02-extensions-automation/subagents" />
  <Card title="使用 Hooks" description="用 PreToolUse、PostToolUse、PermissionRequest、Notification、Stop 等事件做确定性自动化。" href="/docs/claude-code/official/02-extensions-automation/hooks" />
  <Card title="使用 Commands" description="看懂 / 命令背后的 built-in、bundled skill、自定义 Skill command 和 MCP prompt。" href="/docs/claude-code/official/02-extensions-automation/commands" />
  <Card title="使用 Agent SDK" description="把 Claude Code agent loop 接入 Python / TypeScript 程序，并处理权限、sessions、结构化输出和部署边界。" href="/docs/claude-code/official/02-extensions-automation/agent-sdk" />
</Cards>

## 3. 推荐阅读顺序

按能力演进顺序读：

1. 先读扩展能力地图，不要还没分清边界就开始写 Skill 或 Hook。
2. 再读 Skills，把重复出现的流程沉淀下来。
3. 然后读 Subagents，用隔离上下文处理大量探索和专项审查。
4. 再读 Hooks，把必须每次发生的动作变成确定性自动化。
5. 再读 Commands，理解会话内 `/` 入口背后的实现类型。
6. 最后读 Agent SDK。只有当交互流程跑稳并需要程序化时，再进入 SDK。

按问题跳转：

- 重复 prompt 太多：读 Skills。
- 主会话被大量搜索污染：读 Subagents。
- 必须每次格式化或阻断危险命令：读 Hooks。
- 不知道 `/debug`、`/batch`、`/mcp__...` 是什么：读 Commands。
- 要做后台 agent、CI agent、内部平台：读 Agent SDK。
- 想把能力分发给多个仓库：先读 extension map，再看 Plugins 相关边界。

## 4. 不要过早自动化

扩展能力越强，越需要前置边界。

不要过早做这些：

- 把一次性提示词做成 Skill。
- 把还不稳定的流程打包 Plugin。
- 用 Hook 自动执行生产发布。
- 让 Subagent 在不清楚权限时后台跑。
- 在 CLI 流程没跑通前写 Agent SDK。
- 接入大量 MCP 之后才想起来控制权限。

> [!IMPORTANT]
> **扩展是沉淀，不是装饰**：真实重复出现、边界清楚、可以验收的工作，才值得变成 Skill、Hook、Subagent 或 SDK agent。

## 5. 完成后的验收标准

读完这一组，你应该能做到：

- 能用扩展地图判断该用哪一层。
- 能把重复 checklist 做成 Skill。
- 能解释 Skill 和 Hook 的差别。
- 能让 Subagent 做隔离探索，并限制工具边界。
- 能写基本的 PreToolUse / PostToolUse Hook。
- 能理解 `/` 命令背后是 built-in、bundled skill、custom skill 还是 MCP prompt。
- 能判断 Agent SDK 与 Claude Code CLI、Client SDK、Managed Agents 的边界。
- 能在 SDK 里处理工具权限、sessions、structured output、MCP、Hooks 和观测。

## 6. 官方资料

- [Extend Claude Code](https://code.claude.com/docs/en/features-overview)
- [Extend Claude with skills](https://code.claude.com/docs/en/skills)
- [Create custom subagents](https://code.claude.com/docs/en/sub-agents)
- [Automate workflows with hooks](https://code.claude.com/docs/en/hooks-guide)
- [Commands](https://code.claude.com/docs/en/commands)
- [Agent SDK overview](https://code.claude.com/docs/en/agent-sdk/overview)

<Cards>
  <Card title="上一组：核心配置与能力" description="扩展前要先确认 settings、permissions、memory 和 MCP 边界已经清楚。" href="/docs/claude-code/official/01-core-capabilities" />
  <Card title="总入口：官方教程中文版" description="回到总览，查看 14 章完整学习路径。" href="/docs/claude-code/official" />
</Cards>
