Anthropic刚刚官方发布了33页的Claude Skills构建指南，这是全文中文译版

简介

技能（Skill）其实就是一套指令——打包成一个简单的文件夹——用来教Claude怎么处理特定任务或工作流程。这是你自定义Claude最有力的方式之一。

什么时候用技能最合适？就是当你有可以重复执行的工作流程时，比如：

  • 根据设计稿生成前端界面

  • 用固定的方法论做研究调查

  • 按照团队风格指南写文档

  • 协调多个步骤的复杂流程

这份指南适合谁读？

  • 想让Claude按固定流程工作的开发者

  • 想让Claude遵循自己习惯的高级用户

  • 想在团队/组织内统一Claude使用方式的管理者

第一章：基础知识

技能到底是什么？

技能就是一个文件夹，里面放着：

文件/文件夹

是否必须

作用

SKILL.md

✅ 必须

带YAML前置信息的Markdown格式指令

scripts/

可选

可执行代码（Python、Bash等）

references/

可选

按需加载的参考文档

assets/

可选

输出用的模板、字体、图标等

三个核心设计理念

  1. 渐进式披露（Progressive Disclosure）

    • 第一层（YAML前置信息）：精简的核心信息

    • 第二层（SKILL.md正文）：完整指令

    • 第三层（链接文件）：专业深度内容

  2. 可组合性（Composability） Claude可以同时加载多个技能

  3. 可移植性（Portability） 在Claude.ai、Claude Code和API里工作方式相同

第二章：规划与设计

第一步：从用例出发

用例：项目冲刺规划

触发条件：用户说"帮我规划这个冲刺"或"创建冲刺任务"

步骤：

  1. 通过MCP获取Linear的当前项目状态

  2. 分析团队速度和容量

  3. 建议任务优先级

  4. 在Linear里创建带标签和估算的任务

结果：冲刺计划规划完毕，任务全部创建好

三类常见用例

  1. 文档和素材创建

    • 示例：frontend-design技能

    • 关键做法：

      • 嵌入风格指南和品牌规范

      • 用模板结构保证输出一致

  2. 工作流程自动化

    • 示例：skill-creator技能

    • 关键做法：

      • 带验证节点的分步工作流

      • 内置审查和改进建议

  3. MCP增强

    • 示例：sentry-code-review技能

    • 关键做法：

      • 按顺序协调多个MCP调用

      • 嵌入领域专业知识

第三章：测试与迭代

推荐测试方法

  1. 触发测试

    • 目标：确保技能在对的时机加载

    • 测试用例：

     应该触发：
     - "帮我设置一个新的ProjectHub工作区"
     不应该触发：
     - "旧金山今天天气怎么样？"

  1. 功能测试

    • 测试：创建包含5个任务的项目

    • 验证：

      • ProjectHub里创建了项目

      • 5个任务属性都正确

      • 没有API报错

第四章：发布与分享

当前分发方式（2026年1月）

  1. 个人用户：

    • 下载技能文件夹→压缩成zip→通过Claude.ai上传

  2. 组织级技能：

    • 管理员可以在工作区范围内部署技能

第五章：模式与故障排查

五大设计模式

  1. 顺序工作流编排

    工作流：引导新客户

    第1步：创建账户

    调用MCP工具：create_customer

  1. 多MCP协调

  2. 迭代式优化

  3. 情境感知工具选择

  4. 特定领域智能

常见故障排查

问题：技能上传失败 错误："Could not find SKILL.md in uploaded folder" 解决：文件名必须精确写成SKILL.md

第六章：资源与参考

官方文档

示例技能仓库

  • GitHub：anthropics/skills