Claude Code 模板：Skills、Agents、Hooks 等

什么是 Claude Code 模板？

Claude Code 模板是可复用的配置文件，用于自定义 Claude Code 在某个项目或您的本地环境中的行为。

关键在于：模板是基于文件的。您不是通过传统的图形化设置界面安装并逐页点选配置。相反，Claude Code 会自动发现特定的文件和文件夹，将相关元数据加载进上下文，并据此决定如何行动。

在实践中，它们通常是存放于项目级文件夹（如 .claude/）中的 Markdown、JSON 或基于 Shell 的文件，或被打包成插件式目录以便共享。

一个典型的项目级结构可能如下：

my-app/
├── CLAUDE.md
├── .mcp.json
└── .claude/
    ├── skills/
    │   └── database-migration/
    │       └── SKILL.md
    ├── agents/
    │   └── security-auditor.md
    ├── commands/
    │   └── summarize-pr.md
    └── settings.json

Claude 代码模板 vs CLAUDE.md

CLAUDE.md 仍然重要，但扮演的是不同的角色。可以将 CLAUDE.md 视为项目简报：项目做什么、哪些命令重要、适用的编码规范，以及 Claude 应牢记的架构约定。

如需更深入的讲解，请参阅我们的 CLAUDE.md 写作指南。

模板更具模块化：

• 一个 skill 可以编码迁移工作流。
• 一个 agent 可以限定安全审查的角色设定。
• 一个 hook 可以在文件编辑后运行。
• 一个 MCP 配置可以将 Claude 连接到 GitHub、SQLite 或其他外部系统。

这也是模板与更广泛的 Claude Code 工作流设计相结合的地方。优秀的模板搭配良好的规划、测试与上下文交接习惯，效果最佳。

更多实践建议详见我们的 最佳实践指南。

自定义命令 也包含在 skills 体系中，尽管旧的 .claude/commands/ 格式仍可使用。推荐的新格式是 .claude/skills/<name>/SKILL.md，既支持斜杠命令调用，也支持 Claude 自动调用。

我可以使用哪些类型的 Claude Code 模板？

Claude Code 模板生态通常分为六类：skills、agents、commands、hooks、MCP 集成以及 plugins。

前五类会直接改变 Claude 的行为。Plugins 略有不同：它们是一种分发形式，可将 skills、agents、hooks、commands、MCP 服务器和其他组件打包成可复用的安装包。

下面我们逐一介绍这些类别。

1. Skills

Skills 是用于可重复、多步骤任务的指令集合。一个 skill 通常是包含 SKILL.md 的文件夹，该文件以 YAML frontmatter 加 Markdown 正文的形式组织。

frontmatter 描述该 skill 的用途与行为方式；正文告诉 Claude 应遵循的步骤。想要深入了解，可阅读这篇 Claude Skills 指南。

Claude 会根据 skill 的描述来判断其相关性。默认情况下，用户和 Claude 都可以触发一个 skill：您可以输入 /skill-name，或当当前任务匹配该描述时由 Claude 自动加载。对于需要手动控制的流程（如部署），您也可以关闭模型的自动调用。

以下是一个简短示例文件：.claude/skills/database-migration/SKILL.md

---
name: database-migration
description: Use when creating, reviewing, or modifying database migrations. Ensures migrations are reversible, tested, and checked before and after execution.
allowed-tools:
  - Read
  - Write
  - Bash
---

# Database Migration Skill

When working on a database migration:

1. Inspect the existing schema and migration history before writing changes.
2. Confirm whether the migration is additive, destructive, or data-transforming.
3. Create a reversible migration whenever the framework supports rollback.
4. Run the project’s migration check command before applying the migration.
5. Run tests that cover the affected models, queries, or API endpoints.
6. After writing the migration, summarize:
   - schema changes
   - rollback behavior
   - affected tables
   - test commands run

这类指令的价值在于其具备流程性。您不只是让 Claude “注意数据库迁移”，而是提供了一份可复用的清单。

Skills 最适合那些您会在 Claude 中粘贴两次以上的内容：生成 API 端点、撰写变更日志、搭建测试、创建发布说明、审查 Pull Request，或执行迁移检查。

想获得更广泛的灵感，可参阅我们的 Agent Skills 列表，了解开发者正在如何将工作转化为可复用的 AI 工作流。

2. Agents

Agents（更准确地说是 Claude Code 中的自定义子代理）是具备独立 Markdown 定义、YAML frontmatter、工具限制、模型选择与系统提示的专用 AI 助手。

它们既可以放在 .claude/agents/（项目范围），也可以放在 ~/.claude/agents/（个人范围）。您可以通过向 Claude 发起请求创建，或直接在 .claude/agents/ 文件夹中编辑 Markdown 文件。

Skills 与 agents 存在差异：skill 定义“如何做一项任务”，而 agent 定义“Claude 在执行任务时应扮演谁”——包括其角色、关注点、权限与边界。

来看一个 agent 示例：

---
name: security-auditor
description: Reviews code for security vulnerabilities and produces a findings report without modifying files.
tools: Read, Glob, Grep, Bash
model: sonnet
---

You are a security auditor.

Your task is to inspect the codebase for vulnerabilities, risky patterns, and missing safeguards.

Rules:
- Do not edit files.
- Do not suggest broad rewrites unless directly tied to a security issue.
- Focus on authentication, authorization, input validation, secrets, dependency risk, and unsafe shell or SQL usage.
- Produce a findings report with severity, affected files, evidence, and recommended next steps.

该 agent 的价值在于为 Claude 设定了清晰的边界。在通用会话中，Claude 可能一发现问题就尝试修复；而安全审计 agent 只被要求检查与报告，避免修改。

Agents 最适合安全审计、文档审阅、架构评审、数据工程或代码质量检查等专业领域，在这些场景中，隔离上下文与限定权限尤为重要。

当 agents 与专用 skills 搭配时也很有用。例如，安全审计 agent 可以调用审计报告的 skill，而前端审阅 agent 可以使用组件测试的 skill。

3. Commands

Commands 是通过斜杠触发的快捷操作，如 /generate-tests、/check-deps 或 /summarize-pr。历史上，自定义命令以 Markdown 文件形式存放在 .claude/commands/ 下，文件名即命令名。

Claude Code 仍支持这一旧格式，但我建议对新的“命令式工作流”使用 skills，因为它们同样支持以 /name 方式调用，并可在合适情境下自动触发。

当您希望触发动作“必须明确”时，commands 最为合适。一个 skill 可能会在 Claude 侦测到匹配任务时自动激活，而命令只会在您选择时运行。这让 commands 很适合作为检查点：“现在生成测试”、“现在总结这个 PR”、“现在检查依赖”或“现在准备提交信息”。

4. Hooks

Hooks 是随 Claude Code 生命周期事件触发的自动化规则。它们是在 Claude Code 生命周期的特定时间点执行的用户自定义 Shell 命令，为行为提供可预测的控制。

与前面介绍的模板不同，hooks 不是由您提出的请求触发，而是由 Claude 的动作触发。

通俗地说，您无需指望 Claude 在编辑文件后“记得”格式化；一个 hook 可以自动完成。

当前的 hook 事件名称包括 PreToolUse、PostToolUse、Notification 和 Stop 等。

示例：在 Claude 编辑或写入文件后运行格式化器：

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  }
}

Example: block risky shell commands before Claude runs them:
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python3 .claude/hooks/block-dangerous-bash.py"
          }
        ]
      }
    ]
  }
}

Hooks 最适合那些 Claude 不应绕过的规则：运行 linter、格式化被编辑的文件、阻止受保护文件的修改、检查生成的代码，或在 Claude 需要输入时发送通知。

想要深入教程，请阅读我们的 Claude Code Hooks 指南。

5. MCP 集成

MCP 集成通过 Model Context Protocol 将 Claude Code 连接到外部工具、数据源和 API。MCP 充当 AI 系统与外部工具之间的连接层。在 Claude Code 中，这意味着 Claude 不再局限于本地文件与 Shell 命令。

借此，Claude 能与外部服务交互，例如 GitHub、数据库、文档系统、云平台或内部 API，具体取决于您配置了哪些 MCP 服务器。完整说明与演示项目见我们的 Model Context Protocol 教程。

一个 MCP 服务器大致可以暴露三类能力：

• Tools（工具）：Claude 可调用的可执行函数，如创建 GitHub Issue 或运行数据库查询。
• Resources（资源）：只读的上下文来源，如文件、数据库行或文档。
• Prompts（提示模板）：由服务器暴露的可复用任务模板。

项目级的 .mcp.json 可以并列配置多个服务器：

{
  "mcpServers": {
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "sqlite": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sqlite",
        "./data/app.db"
      ]
    }
  }
}

这很重要，因为 Claude 只能基于它可访问的上下文与工具进行推理。没有 MCP，它也许能检查本地文件，但无法访问您的问题跟踪器、数据库、云环境或内部 API。

当 Claude 需要操作真实技术栈而非静态代码快照、并需要访问外部数据时，MCP 是最佳选择。

6. Plugins

Plugins 是打包的集合。它们可以在一个可安装的结构中包含 skills、agents、hooks、MCP 配置、commands 以及其他组件。

在 Claude Code 中，一个插件通常包含 .claude-plugin/plugin.json 清单，以及 skills/、agents/、hooks/ 等组件文件夹和位于插件根目录的 .mcp.json。

插件结构示例：

frontend-workflow-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── component-test/
│       └── SKILL.md
├── agents/
│   └── frontend-reviewer.md
├── hooks/
│   └── hooks.json
└── .mcp.json

插件 json 示例：

{
  "name": "frontend-workflow",
  "displayName": "Frontend Workflow",
  "version": "1.0.0",
  "description": "Frontend development workflow with review agents, test skills, and formatting hooks",
  "author": {
    "name": "Your Team"
  }
}

Plugins 并不会引入一种全新的行为类型，它们让其他类型变得可移植。当您想在团队间共享完整配置、在多个项目中复用相同工作流，或安装一个由社区维护的整套方案而不是逐个创建文件时，请使用插件。

如需从零开始构建，请参阅 DataCamp 的 Claude Code 插件分步指南。

我该选择哪种模板类型？

完全理解——这些类型的确容易混淆。它们都会改变 Claude 的行为，主要区别在于触发方式与控制力度。

为便于理解，下面进行一组对比：

一个简单的决策规则：

• 若您希望 Claude 每次接触代码都自动执行规则，请使用 hook。
• 若您希望 Claude 在特定任务中具备深入的领域专长，请使用 agent。
• 若您希望 编码一套可重复的工作流 供 Claude 稳定执行，请使用 skill。
• 若您希望 在合适时机由自己触发动作，请使用 command 或类命令的 skill。
• 若 Claude 需要 外部服务或实时数据，请使用 MCP。
• 若您希望安装或共享一套 完整的工作流配置，请使用 plugin。

在真实项目中，这些类型通常组合使用。比如，一个安全插件可能打包一个 security-auditor agent、一个 audit-findings skill、一个依赖检查命令，以及一个 pre-commit hook。Agent 定义角色，skill 定义报告结构，command 充当显式检查点，hook 则提供强制护栏。

对于需要 Claude 在实施前遵循正式方案的工作流，规范驱动开发（spec-driven development）往往比临时提示更合适。

在哪里可以找到 Claude Code 模板？

主要有三种来源：Anthropic 官方、社区合集，以及您自己。

首先，从 Anthropic 官方资源与文档开始。Anthropic 的 Claude Code 文档涵盖 skills、subagents、hooks、MCP 与 plugins，是在发布任何生产级配置前核对最新文件格式与行为的最佳来源。

其次，使用 社区合集。目前较为知名的社区枢纽是 aitmpl.com，自称是 Claude Code 项目的即用型配置目录。其导航目前包含 Skills、Agents、Commands、Settings、Hooks、MCPs 与 Plugins。

当前的交互式安装命令为：

npx claude-code-templates@latest

项目文档还展示了一个更短的别名：

npx cct@latest

对于具体组件，GitHub 上的实时 README 展示了如下安装命令：

npx claude-code-templates@latest --agent development-tools/code-reviewer --yes
npx claude-code-templates@latest --command performance/optimize-bundle --yes
npx claude-code-templates@latest --hook git/pre-commit-validation --yes
npx claude-code-templates@latest --mcp database/postgresql-integration --yes

它还展示了使用多个标志在一条命令中批量安装整套栈的方法。

评估社区模板时，请关注以下质量信号：

• description 是否足够具体，以便 Claude 正确触发该 skill 或 agent？

• allowed-tools 的范围是否收敛，是否不必要地请求了广泛的写入与 bash 权限？

• 代码库是否近期仍在维护？

• 模板是否说明了它会带来哪些变化？

• 是否包含您尚未审查就会执行代码的 hooks 或 MCP 服务器？

第三，自己编写。当工作流与您的技术栈高度耦合时，这通常是正确答案。社区模板能提供有用的基线，但不了解您内部的迁移策略、命名约定、数据模型或部署风险偏好。

结语

Claude Code 模板让 Claude Code 从“按会话使用的助手”升级为“持久的开发环境”。

本文提到的六类其实是分层的：skills 编码工作流，agents 定义角色，commands 提供显式操作，hooks 强制护栏，MCP 连接外部系统，plugins 将一切打包复用。

起步不必追求庞大的插件栈。我会先为您最常用的工作流构建一个 skill。等您发现 Claude 的默认行为仍有摩擦点时，再为专门审阅添加 agent、为强制执行添加 hook，或通过 MCP 服务器获取实时系统访问。

想进一步学习 Claude Code，请查看我们的 Claude Code 101 与 Claude Code in Action 课程。