by 运行时依赖
安装命令
点击复制技能文档
技能创建者 本技能提供创建有效技能的指导。 关于技能 技能是模块化、自包含的包，它们通过提供专门的知识、工作流程和工具来扩展Claude的功能。可以将它们视为特定领域或任务的“入门指南”——它们将Claude从通用代理转变为具有程序化知识的专用代理，而这种知识是任何模型都无法完全具备的。 技能提供的内容 专门的工作流程 - 特定领域的多步骤程序 工具集成 - 使用特定文件格式或API的说明 领域专业知识 - 公司特定的知识、模式、业务逻辑 捆绑资源 - 复杂和重复任务的脚本、参考资料和资产 核心原则 简洁是关键 上下文窗口是一个公共资源。技能与其他一切共享上下文窗口：系统提示、对话历史、其他技能的元数据和实际用户请求。 默认假设：Claude已经非常智能。只添加Claude没有的上下文。 挑战每一条信息：“Claude真的需要这个解释？”和“这个段落是否证明了其令牌成本？” 更喜欢简洁的例子而不是冗长的解释。 设置适当的自由度 将具体程度与任务的脆弱性和可变性相匹配： 高自由度（基于文本的说明）：当多种方法有效、决策取决于上下文或启发式指导方法时使用。 中等自由度（带参数的伪代码或脚本）：当存在首选模式、允许一些变化或配置影响行为时使用。 低自由度（特定脚本、少量参数）：当操作容易出错、一致性至关重要或必须遵循特定顺序时使用。 可以将Claude视为探索一条路径：一座狭窄的桥梁需要特定的防护栏（低自由度），而一个开阔的场地允许许多路线（高自由度）。 技能的解剖结构 每个技能都由必需的SKILL.md文件和可选的捆绑资源组成： skill-name/ ├── SKILL.md（必需） │ ├── YAML前置元数据（必需） │ │ ├── 名称：（必需） │ │ ├── 描述：（必需） │ │ └── 兼容性：（可选，很少需要） │ └── Markdown说明（必需） └── 捆绑资源（可选） ├── 脚本/ - 可执行代码（Python/Bash等） ├── 参考/ - 计划加载到上下文中的文档 └── 资产/ - 用于输出的文件（模板、图标、字体等） SKILL.md（必需） 每个SKILL.md由以下组成： 前置元数据（YAML）：包含名称和描述字段（必需），以及可选字段，如许可证、元数据和兼容性。只有名称和描述被Claude读取以确定技能何时触发，因此请清楚地说明技能是什么以及何时使用它。兼容性字段用于记录环境要求（目标产品、系统包等），但大多数技能不需要它。 正文（Markdown）：使用技能的说明和指导。仅在技能触发后（如果触发）加载。 捆绑资源（可选） 脚本（脚本/） 用于需要确定性可靠性或反复重写的任务的可执行代码（Python/Bash等）。 何时包含：当相同的代码被反复重写或需要确定性可靠性时 示例：scripts/rotate_pdf.py用于PDF旋转任务 优点：令牌高效、确定性、可能在不加载到上下文的情况下执行 注意：脚本可能仍需要被Claude读取以进行修补或环境特定的调整 参考（参考/） 计划加载到上下文中的文档和参考资料，以告知Claude的流程和思维。 何时包含：当Claude应该参考文档时 示例：references/finance.md用于金融模式，references/mnda.md用于公司NDA模板，references/policies.md用于公司政策，references/api_docs.md用于API规范 使用案例：数据库模式、API文档、领域知识、公司政策、详细的工作流程指南 优点：保持SKILL.md精简，只在Claude确定需要时加载 最佳实践：如果文件很大（>10k字），请在SKILL.md中包含grep搜索模式 避免重复：信息应存在于SKILL.md或参考文件中，但不能同时存在于两者中。更喜欢参考文件用于详细信息，除非它真正是技能的核心——这保持SKILL.md精简，同时使信息可发现而不会占用上下文窗口。仅在SKILL.md中保留基本的程序化说明和工作流程指南；将详细的参考资料、模式和示例移到参考文件中。 资产（资产/） 不打算加载到上下文中的文件，而是用于Claude生成的输出。 何时包含：当技能需要文件时 注意：未完成的翻译，原始文本中还有一部分内容未被翻译。