扩展 Claude Code

Skills 和 subagents 解决不同的问题：

• Skills 是可重用的内容，可以将其加载到任何上下文中
• Subagents 是与主对话分开运行的隔离工作者

Skills 可以是参考或操作

• 参考 skills 提供 Claude 在整个会话中使用的知识

  如您的 API 风格指南
  

• 操作 skills 告诉 Claude 执行特定操作

  如运行您的部署工作流的 /deploy
  

当需要 上下文隔离或上下文窗口变满 时，使用 subagent

• Subagent 可能读取数十个文件或运行广泛的搜索，但主对话仅接收摘要
• 由于 subagent 工作不消耗您的主上下文，当您不需要中间工作保持可见时，这也很有用
• 自定义 subagents 可以有自己的说明并可以预加载 skills

它们可以结合

• Subagent 可以预加载特定的 skills skills: 字段
• Skill 可以使用 context: fork 在隔离的上下文中运行

两者都存储说明，但它们的加载方式和用途不同

如果 Claude 应该始终知道它，请将其放在 CLAUDE.md 中

编码约定、构建命令、项目结构、“永远不要执行 X” 规则

如果它是 Claude 有时需要的参考材料（API 文档、风格指南）或使用 /<name> 触发的工作流（部署、审查、发布），请将其放在 skill 中

经验法则： 保持 CLAUDE.md 在 200 行以下

如果它在增长，将参考内容移到 skills 或拆分为 .claude/rules/ 文件

所有三者都存储说明，但它们的加载方式不同：

对于每个会话需要的说明，使用 CLAUDE.md

构建命令、测试约定、项目架构

使用 rules 来保持 CLAUDE.md 专注

带有 paths frontmatter 的 rules 仅在 Claude 处理匹配文件时加载，节省上下文

对于 Claude 有时只需要的内容，使用 skills

如 API 文档或使用 /<name> 触发的部署清单

两者都并行化工作，但它们在架构上不同：

• Subagents 在会话内运行并将结果报告回您的主上下文
• Agent teams 是相互通信的独立 Claude Code 会话

当您需要一个快速、专注的工作者时，使用 subagent

研究一个问题、验证一个声明、审查一个文件

Subagent 完成工作并返回摘要。您的主对话保持清洁

当队友需要共享发现、相互质疑和独立协调时，使用 agent team

Agent teams 最适合具有竞争假设的研究、并行代码审查以及每个队友拥有单独部分的新功能开发

过渡点：如果运行并行 subagents 但遇到上下文限制，或者 subagents 需要相互通信，agent teams 是自然的下一步

MCP 将 Claude 连接到外部服务。Skills 扩展 Claude 的知识，包括如何有效地使用这些服务

这些解决不同的问题，可以很好地协同工作：

• MCP: 给予 Claude 与外部系统交互的目的构建的工具，连接和身份验证由服务器处理
• Skills: 给予 Claude 关于如何有效使用这些工具的知识，以及可以使用 /<name> 触发的工作流
  • Skill 可能包括您团队的数据库架构和查询模式
  • 或带有您团队消息格式规则的 /post-to-slack 工作流

示例：MCP 服务器将 Claude 连接到您的数据库

Skill 教导 Claude 您的数据模型、常见查询模式以及用于不同任务的表

Hook 在生命周期事件上触发；skill 被加载到上下文中供 Claude 应用

• 当操作必须每次都以相同方式发生且不需要 Claude 思考时，使用 hook

  例如：保存时格式化、拒绝 rm -rf /、在会话结束时发布 Slack 消息
  

• 当 Claude 应该决定如何应用步骤或内容是知识而不是脚本时，使用 skill

  例如：/release 清单、您的 API 风格指南、调试剧本
  

• 将防御步骤放在 hooks 中

  CLAUDE.md 或 skill 中的”永远不要编辑 .env”之类的说明是请求，而不是保证
  
  阻止编辑的 PreToolUse hook 是强制执行
  
  如果规则必须每次都成立，将其作为 hook 而不是提示说明
  

• Hook 输出进入上下文

  运行您的 linter 的 PostToolUse hook 将结果作为 Claude 读取的文本反馈
  
  /fix-lint skill 告诉 Claude 如何解决它们
  

• 何时： 会话开始
• 加载内容： 所有 CLAUDE.md 文件的完整内容（托管、用户和项目级别）

• 继承： Claude 从工作目录读取 CLAUDE.md 文件直到根目录，并在访问这些文件时发现子目录中的嵌套文件

  有关详细信息，请参阅 CLAUDE.md 文件如何加载
  
  https://code.claude.com/docs/zh-CN/memory#how-claude-md-files-load
  

Skills 是 Claude 工具包中的额外功能。它们可以是参考材料（如 API 风格指南）或可调用的工作流，可以使用 /<name> 触发（如 /deploy）

Claude Code 包括 捆绑的 skills，如 /code-review、/batch 和 /debug，可以开箱即用

也可以创建自己的

Claude 在 适当时 使用 skills，或者可以直接调用一个

• 何时： 取决于 skill 的配置
  • 默认情况下，描述在会话开始时加载，完整内容在使用时加载
  • 对于仅用户 skills（disable-model-invocation: true），在调用它们之前不加载任何内容
• 加载内容： 对于模型可调用的 skills，Claude 在每个请求中看到名称和描述。当您使用 /<name> 调用 skill 或 Claude 自动加载它时，完整内容加载到您的对话中。

• Claude 如何选择 skills： Claude 将任务与 skill 描述相匹配，以决定哪些相关

  如果描述模糊或重叠，Claude 可能加载错误的 skill 或错过会有帮助的 skill
  

  • 要告诉 Claude 使用特定的 skill，请使用 /<name> 调用它
    • 带有 disable-model-invocation: true 的 Skills 对 Claude 不可见，直到您调用它们
• 上下文成本： 低，直到使用。仅用户 skills 在调用前成本为零

• 在 subagents 中： Skills 在 subagents 中的工作方式不同。不是按需加载，而是在 subagent 的 skills 字段中列出的 skills 在启动时完全预加载到其上下文中

  Subagents 仍然可以通过 Skill 工具发现和调用未列出的项目、用户和插件 skills
  

• 何时： 会话开始
• 加载内容： 来自连接的服务器的工具名称。完整的 JSON 架构保持延迟，直到 Claude 需要特定工具
• 上下文成本： 工具搜索默认启用，因此空闲 MCP 工具消耗最少的上下文

• 何时： 文件编辑后，以及当 Claude 导航代码时按需
• 加载内容： 每次文件编辑后的类型错误和警告。当 Claude 查找符号时的定义、引用和类型信息
• 上下文成本： 低。符号查找通常替代广泛的文件读取，因此净上下文使用可能会下降

• 何时： 按需，当您或 Claude 为任务生成一个时
• 加载内容： 新鲜、隔离的上下文，包含：
  • agent 的自己的系统提示，而不是完整的 Claude Code 系统提示
  • agent 的 skills: 字段中列出的 skills 的完整内容
  • CLAUDE.md 和 git 状态，除了内置的 Explore 和 Plan agents 省略两者
  • 主 agent 在提示中传递的任何上下文
• 上下文成本： 与主会话隔离。Subagents 不继承对话历史或调用的 skills

• 何时： 触发时。Hooks 在特定的生命周期事件上触发

  如工具执行、会话边界、提示提交、权限请求和压缩
  
  有关完整列表，请参阅 Hooks
  
  https://code.claude.com/docs/zh-CN/hooks
  

• 加载内容： 默认情况下无。Hooks 在主对话外执行
• 上下文成本： 零，除非 hook 返回作为消息添加到您的对话中的输出