SuperAPI AI 工具集

skill-development

智能体与模型

查看项目

更新于 10-15 21:49

技能介绍

用途:在当前本地环境中创建或修复 Claude 技能,而非套用抽象的插件模板。目标是产出易触发、SKILL.md 层精简、所提及的 references/、examples/、scripts/ 文件真实存在、且没有失效本地引用的技能。

核心规则:一个技能对应一项持久任务;把 frontmatter 的 description 当作主要触发面;SKILL.md 只聚焦工作流与边界;把详细目录、模板和长解释移入 references/ 或 examples/;不要提及不存在的文件;不要未经本地核实就沿用旧名称、agent 或同级技能引用。

默认工作流:

  1. 先检查当前环境:查看目标技能目录、已解决类似问题的邻近技能,核实哪些 agent、命令和同级技能真实存在,识别失效引用。以本地清单为准。
  2. 锁定技能契约:编辑前先定义技能做什么、由什么触发、明确不做什么、实际需要哪些捆绑资源。若只需短工作流就保持简短,不要因目录惯例而创建 references/、examples/、scripts/。
  3. 编写或修复 frontmatter:name 用真实技能标识符,description 用第三人称触发描述,包含用户会自然说出的具体短语,并保持简短。推荐形式:---\nname: skill-name\ndescription: This skill should be used when the user asks to "...", "...", or needs help with ....\n---\n4. 保持主文件精简:通常包含简短目标、角色边界、默认工作流、安全或质量规则、简短资源列表。模板、详尽清单、边界情况目录、示例输出和长示例应移出主文件。
  4. 只添加真实捆绑资源:references/ 放可选择性加载的详细指导,examples/ 放真实示例输出或脚手架,scripts/ 放确定性辅助逻辑。SKILL.md 提到的资源必须存在;存在但从未被引用或使用的资源应删除。
  5. 收尾前做完整性检查:frontmatter 可解析、被引用的本地文件存在、同级技能或 agent 引用真实、SKILL.md 未堆砌应放入 references 的内容、技能目录内未遗留临时日志、缓存和编辑器产物。

常见修复模式:技能过长时,把触发与工作流留在 SKILL.md,目录和深层细节移入 references/,并保留简短阅读顺序;技能过薄时,补充默认工作流、至少一个具体示例或清单,并明确边界;存在失效引用时,立即删除死路径,用当前本地名称替换历史名称,并对照实际目录重新检查邻近 agent/命令/技能。

推荐输出形态:创建或修复技能后,说明改了什么、创建或更新了哪些文件、运行了哪些完整性检查、是否还有需要人工跟进的事项。

参考资源(按需加载):references/checklist.md 为收尾前的精简质量清单;references/integrity-checks.md 为缺失文件、失效引用和漂移的具体本地检查;references/skill-creator-original.md 为旧版背景参考,仅作上下文,不作为实时事实来源。