SuperAPI AI 工具集

skill-creation-walkthrough

智能体与模型

查看项目

更新于 10-16 09:46

技能介绍

用途:这是一套引导式流程,帮助设计、编写和维护自己的 Claude Skills。适用情形包括:反复写同样的提示或指令、想把工作流或框架打包复用、已有 Skill 未能正常触发、要发布给他人使用、想教 Claude 某领域特定工作方式,或需要审核他人 Skill 的质量标准。

不适用:一次性提示、应放在系统上下文的信息、想改变 Claude 在所有对话中的通用行为(应改用 Claude.ai 设置或系统提示),以及想替代工具调用(Skill 是指令,不是工具)。

核心机制:Skill 是一个包含 SKILL.md 的文件夹,SKILL.md 有 YAML frontmatter(name 与 description)和指令正文,还可包含引用文件、脚本或模板。关键特性是渐进式披露:description 常驻系统提示,正文与引用文件仅在触发时加载,因此 description 决定能否触发,正文负责工作流本身,引用文件承载长清单、模板、示例等。

流程分六阶段:一、用重复次数、输出一致性、明确触发条件等标准判断是否该做成 Skill;二、定义具体触发场景和用户会说的原话;三、写 description,含做什么、何时使用、"Also triggers when..." 边缘情况、适用对象四部分;四、按标准结构组织 SKILL.md 正文(名称、何时用、何时不用、所需输入、框架、工作流、失败模式、输出格式、引用文件);五、为超长内容添加独立引用文件,如 references/[noun]-template.md、checklist.md、playbook.md;六、用触发、边缘、误触发、输出、长度五类测试反复迭代。

常见失败模式:描述过窄导致从不触发、过宽导致频繁误触发、缺少触发短语、SKILL.md 过长、引用与正文重复、缺少"何时不用"、缺少示例、只围绕单一用例、发布后不再维护。公开 Skill 应保持方法论纯粹,避免硬编码自有技术栈。资料未提供具体价格、平台支持范围或官方安装命令。