SuperAPI AI 工具集

create-skill

智能体与模型

查看项目

更新于 10-15 08:42

技能介绍

用途

create-skill 用于将一个可重复使用的 AI 提示词或工作流,转化为结构化、可分享的技能,供 affiliate-skills GitHub 仓库使用。其输出是一个完整的 SKILL.md 文件,可在任意 AI 智能体中运行,并通过 npx skills add Affitor/affiliate-skills 分享,任何人都可以安装。

该技能属于 Stage S8: Meta。

何时使用

  • 用户有一个反复使用的提示词,想把它变成可分享的技能
  • 用户想为 affiliate-skills 仓库创建一个新技能
  • 用户想按标准格式编写 SKILL.md 文件
  • 用户说“把这个做成一个技能”或“为 X 写一个技能”
  • 用户想打包一个 AI 工作流,以便他人复现

输入结构

输入字段包括:

  • raw_prompt(必填):提示词、工作流描述,或对技能功能的详细说明
  • failure_modes(可选):输出不佳时会出现什么问题,有助于编写更好的 Instructions 和 Error Handling
  • niche(可选):类别提示,例如 "content"、"research"、"seo"
  • examples(可选):用户已有的示例输入/输出对

工作流程

  1. 理解提示词实际做什么:分析任务类型、可变输入、固定结构、质量差异点、失败模式。如果用户描述模糊,询问他们通常粘贴到 ChatGPT/Claude 的内容、输出良好时的样子、以及出问题时的表现。
  2. 确定技能元数据:包括 name、slug、category(research、content、seo、landing、distribution、analytics、automation、meta 之一)、level(beginner/intermediate/advanced)、stage(S1-Research 至 S8-Meta)、tags、tools。
  3. 编写 SKILL.md:按指定结构包含 frontmatter、标题与简介、When to Use、Input Schema、Workflow、Output Schema、Output Format、Error Handling、Examples、Flywheel Connections、Quality Gate、References。
  4. 编写 README 描述:面向社区,用于 GitHub 和 affiliate-skills 注册表,包含开头、When to Use、差异点、指令摘要、所需输入、输出格式、示例、提示。
  5. 组装输出:分别呈现 SKILL.md 和 README 描述。
  6. 自校验:检查所有必需部分、工作流步骤质量、输出格式占位符、示例数量、错误处理、质量门可测试性、描述具体性、frontmatter 名称与 slug 一致。

输出结构

输出字段包括 output_schema_version、skill_md(完整 SKILL.md 内容)、listing(name、slug、description、content、category、level、tags)、metadata(stage、tools_needed、estimated_time)。

输出格式

技能产生两个输出:

  1. SKILL.md 文件:包含 frontmatter、标题、Stage、When to Use、Input Schema、Workflow、Output Schema、Output Format、Error Handling、Examples、Flywheel Connections、Quality Gate、References。
  2. README / 注册表描述:包含技能信息表格(Name、Slug、Category、Level、Tags、Install)和面向社区的描述。

错误处理

  • 用户给出模糊描述而非提示词:要求提供实际粘贴到 AI 的提示词,或具体输入与预期输出示例。
  • 提示词过于简单:如果只是单句且无可变输入,告知用户这不需要做成技能。
  • 提示词功能过多:如果工作流有 10 个以上不同步骤,建议拆分为 2-3 个聚焦技能。
  • 没有清晰输出格式:要求提供 1-2 个示例,据此构建 Output Format。
  • 用户想复制现有技能:检查仓库中是否已有类似技能,建议改进而非重复创建。

适用场景

适用于把反复使用的 ChatGPT 提示词转化为技能、打包跨多个工具的工作流、以及为 affiliate-skills 仓库贡献新技能。示例包括将比较类博客文章提示词转化为 comparison-post-writer 技能,或将产品研究加评论写作工作流打包为 product-review-writer 技能。

限制

对于过于简单、没有可变输入和结构化输出的提示词,该技能会建议不创建技能。对于步骤过多、跨领域的工作流,会建议拆分。具体收费、价格、平台效果等信息暂未提供。