技能发展

工程开发 社区 v0.1.0

技能解读

当前原文的自动摘译,尚未人工审校。

关于技能

技能是模块化、独立的包,通过提供专业知识、工作流程和工具来扩展 Claude 的能力。将它们视为特定领域或任务的“入门指南”——它们将 Claude 从通用智能体转变为配备了任何模型都无法完全拥有的程序知识的专业智能体。

提供什么技能

专业工作流程 - 针对特定领域的多步骤过程 工具集成 - 使用特定文件格式或 API 的说明 领域专业知识 - 公司特定的知识、模式、业务逻辑 捆绑资源 - 用于复杂和重复任务的脚本、参考和资产

技能剖析

每个技能都包含必需的 SKILL.md 文件和可选的捆绑资源: SKILL.md(必需) 元数据质量:YAML frontmatter 中的 name 和 description 决定 Claude 何时使用该技能。具体说明该技能的作用以及何时使用它。使用第三人称(例如“该技能应在...时使用”而不是“在...时使用该技能”)。捆绑资源(可选) 脚本 (scripts/)

渐进式披露设计原则

技能使用三级加载系统来有效管理上下文: 元数据(名称 + 描述) - 始终在上下文中(~100 个单词) SKILL.md 主体 - 当技能触发时(<5k 个单词) 捆绑资源 - 根据 Claude 的需要(无限制*) *无限制,因为可以在不读入上下文窗口的情况下执行脚本。

技能创造过程

要创建技能,请按顺序遵循“技能创建流程”,仅当有明确原因不适用时才跳过步骤。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
工程开发
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
92 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@anthropics · v0.1.0 · 未声明许可证
上下文用量评级
较高消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
未声明(默认跨平台)
运行环境要求
Python
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第一步:通过具体例子理解技能

仅当已经清楚地了解技能的使用模式时才跳过此步骤。即使使用现有技能,它仍然很有价值。要创建有效的技能,请清楚地了解如何使用该技能的具体示例。这种理解可以来自直接的用户示例,也可以来自通过用户反馈验证的生成示例。例如,在培养图像编辑技能时,相关问题包括:

02
第二步:规划可重复使用的技能内容

要将具体示例转化为有效的技能,请通过以下方式分析每个示例: 考虑如何从头开始执行示例 确定重复执行这些工作流程时哪些脚本、引用和资源会有所帮助 示例:当构建`pdf-editor` 技能来处理“帮我旋转此 PDF”之类的查询时,分析显示:旋转 PDF 需要每次重新编写相同的代码

03
第 3 步:创建技能结构

对于 Claude Code 插件,创建技能目录结构: 注意:与使用 `init_skill.py` 的通用技能创建器不同,插件技能直接在插件的 `skills/` 目录中创建,具有更简单的手动结构。

04
第四步:编辑技能

编辑(新创建的或现有的)技能时,请记住该技能正在创建供另一个 Claude 实例使用。重点关注包括对克劳德有益且非显而易见的信息。考虑哪些程序知识、特定领域的细节或可重用资产可以帮助另一个 Claude 实例更有效地执行这些任务。从可重复使用的技能内容开始

05
第 5 步:验证和测试

对于插件技能,验证与通用技能不同: 检查结构:`plugin-name/skills/skill-name/`中的技能目录 验证 SKILL.md:具有名称和描述的前题 检查触发短语:描述包括特定用户查询 验证写作风格:正文使用命令式/不定式形式,而不是第二人称

06
第 6 步:迭代

测试技能后,用户可以请求改进。通常,这种情况会在使用该技能后立即发生,并提供该技能如何执行的新背景。迭代工作流程:在实际任务中使用该技能 注意困难或效率低下 确定应如何更新 SKILL.md 或捆绑资源

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。