用途
该技能为创建有效的 Skill(技能)提供指导。当用户想要创建新技能(或更新已有技能)以扩展 Claude 的能力时,应使用该技能。技能是模块化、自包含的软件包,通过提供专门的知识、工作流和工具来扩展 Claude 的能力。可以将其视为针对特定领域或任务的"入职指南"——它们把通用型 Claude 转变为装备了程序性知识的专用智能体,而这些知识是任何模型都无法完全具备的。
技能能提供什么
- 专门工作流:针对特定领域多步骤流程。
- 工具集成:如何操作特定文件格式或 API 的说明。
- 领域专业知识:公司专属知识、模式(schema)、业务逻辑。
- 捆绑资源:用于复杂及重复性任务的脚本、参考资料和资产。
核心原则
简洁至上:上下文窗口是一种公共资源。技能需要与 Claude 所需的其他所有内容共享上下文窗口:系统提示、对话历史、其他技能的元数据,以及实际用户请求。默认假设是 Claude 已经非常聪明,只需添加 Claude 尚不具备的上下文。对每一条信息都应提出疑问:"Claude 真的需要这个解释吗?"以及"这一段是否值它的 token 成本?",倾向于使用简洁示例而非冗长解释。
设置适当的自由度:让具体程度匹配任务的脆弱性和可变性。高自由度(基于文本的指令)适用于存在多种有效方法、决策依赖上下文或由启发式引导方法的情况。中自由度(伪代码或带参数的脚本)适用于存在首选模式、允许一定变化或配置会影响行为的情况。低自由度(具体脚本、少量参数)适用于操作脆弱易错、一致性至关重要或必须遵循特定顺序的情况。
技能的结构
每个技能由一个必需的 SKILL.md 文件和可选的捆绑资源组成。SKILL.md 由 YAML frontmatter(包含 name 和 description 字段)和 Markdown 正文指令组成。可选的捆绑资源包括:scripts/(可执行代码,如 Python/Bash)、references/(按需加载进上下文的文档)和 assets/(用于产出成果的文件,如模板、图标、字体)。
SKILL.md 中的 frontmatter 是 Claude 判断技能何时被使用的唯一字段,因此清晰、全面地描述该技能是什么以及何时应使用它非常重要。正文仅在技能触发后加载。
渐进式披露设计原则
技能采用三级加载系统来高效管理上下文:元数据(名称 + 描述)始终在上下文中(约 100 词);SKILL.md 正文在技能触发时加载(少于 5k 词);捆绑资源按 Claude 的需要加载。
应保持 SKILL.md 正文精简,控制在 500 行以内,接近此限制时拆分为单独文件,并从 SKILL.md 中引用它们,清楚说明何时阅读。文档中给出了若干组织模式,包括:带引用的高层指南、按领域组织、条件式细节,并建议避免深度嵌套引用、为超过 100 行的文件添加目录。
技能创建流程
- 用具体示例理解技能(仅在已清楚理解使用模式时可跳过)。
- 规划可复用的技能内容(脚本、参考资料、资产)。
- 初始化技能(运行 init_skill.py)。
- 编辑技能(实现资源并撰写 SKILL.md)。
- 打包技能(运行 package_skill.py)。
- 基于实际使用进行迭代。
按顺序执行这些步骤,仅在明确理由表明不适用时才跳过。
初始化命令:scripts/init_skill.py <skill-name> --path <output-directory>;打包命令:scripts/package_skill.py <path/to/skill-folder>,可选指定输出目录,例如 scripts/package_skill.py <path/to/skill-folder> ./dist。
不应包含的内容
技能应只包含直接支持其功能的基本文件。不要创建无关的文档或辅助文件,包括 README.md、INSTALLATION_GUIDE.md、QUICK_REFERENCE.md、CHANGELOG.md 等。
限制
资料未提供该技能的收费、价格、平台兼容性及具体效果等信息,暂未提供。