skill-creation-guide

# 技能创建器 本技能提供创建高效技能的指南。 ## 关于技能 技能是模块化、自包含的包，通过提供专业知识、工作流和工具来扩展 Claude 的能力。可以将它们视为特定领域或任务的“入职指南”——它们将 Claude 从通用智能体转变为配备了模型本身无法完全具备的程序性知识的专业智能体。 ### 技能提供的内容 1. 专业工作流 - 针对特定领域的多步骤流程 2. 工具集成 - 使用特定文件格式或 API 的说明 3. 领域专长 - 公司特定知识、模式、业务逻辑 4. 捆绑资源 - 用于复杂和重复性任务的脚本、参考资料和资产 ## 核心原则 ### 简洁是关键 上下文窗口是一种公共资源。技能与 Claude 需要的所有其他内容共享上下文窗口：系统提示词、对话历史、其他技能的元数据以及实际的用户请求。 **默认假设：Claude 已经非常聪明。** 只添加 Claude 尚不具备的上下文。质疑每一条信息：“Claude 真的需要这个解释吗？”以及“这段文字是否值得消耗这些 Token？” 比起冗长的解释，更倾向于简洁的示例。 ### 设置适当的自由度 根据任务的脆弱性和可变性匹配具体程度： **高自由度（基于文本的指令）**：当多种方法都有效、决策取决于上下文或启发式方法指导方案时使用。 **中等自由度（带参数的伪代码或脚本）**：当存在首选模式、允许一定程度的变化或配置会影响行为时使用。 **低自由度（特定脚本，少量参数）**：当操作脆弱且容易出错、一致性至关重要或必须遵循特定顺序时使用。 将 Claude 想象成在探索路径：悬崖边的窄桥需要特定的护栏（低自由度），而开阔的田野允许许多路线（高自由度）。 ### 技能的解剖结构 每个技能都包含一个必需的 SKILL.md 文件和可选的捆绑资源： skill-name/ ├── SKILL.md (必需) │ ├── YAML 前置元数据 (必需) │ │ ├── name: (必需) │ │ └── description: (必需) │ └── Markdown 指令 (必需) └── 捆绑资源 (可选) ├── scripts/ - 可执行代码 (Python/Bash 等) ├── references/ - 意图文档