SuperAPI AI 工具集

skill-creator

智能体与模型

查看项目

更新于 11-06 16:21

技能介绍

用途

Skill Creator 是一个指导性技能,用于帮助用户创建新的技能或更新已有技能。技能是模块化、自包含的包,通过提供专门知识、工作流和工具来扩展 Agent 的能力,可将其从通用 Agent 转变为具备特定程序性知识的专业 Agent。该技能面向需要为 Agent 添加专业工作流、工具集成、领域专业知识或捆绑资源的场景。

主要能力

  • 说明技能的核心原则:简洁优先,只添加 Agent 尚不具备的上下文;根据任务的脆弱性和可变性设置适当的自由度(高自由度文本指令、中自由度伪代码或参数化脚本、低自由度特定脚本)。
  • 定义技能的结构:必需的 SKILL.md 文件(含 name、description 等 YAML frontmatter 和 Markdown 正文),以及可选的 scripts/、references/、assets/ 资源目录。
  • 指导资源目录的用途:scripts/ 存放可执行代码;references/ 存放按需加载的文档;assets/ 存放用于输出的模板、图标、字体等文件。
  • 强调不包含多余文档(如 README、安装指南、变更日志等)。
  • 介绍渐进式披露设计:元数据始终在上下文中(约 100 词),SKILL.md 正文在触发时加载(少于 5000 词),捆绑资源按需加载。
  • 提供渐进式披露的三种组织模式:高层指南加引用、按领域或变体组织、条件性细节。
  • 给出技能创建的完整流程:用具体示例理解技能、规划可复用内容、运行 init_skill.py 初始化、编辑技能、运行 package_skill.py 打包、基于实际使用迭代。
  • 提供初始化脚本用法:scripts/init_skill.py <skill-name> --path <output-directory>。
  • 提醒创建目录时避免 bash 花括号展开,应逐个创建或使用 Python 的 os.makedirs。
  • 建议参考 references/workflows.md 和 references/output-patterns.md 了解设计模式。
  • 要求添加的脚本必须实际运行测试;SKILL.md 正文使用祈使/不定式形式;description 中需包含技能做什么以及何时使用的具体触发条件。

使用方式

按照技能创建流程逐步操作:首先通过具体示例明确技能应支持的功能;然后分析每个示例,识别可复用的脚本、引用和资产;接着运行 init_skill.py 生成模板目录;随后编辑 SKILL.md 并实现资源文件;之后运行 package_skill.py 打包;最后根据实际使用迭代改进。创建新技能时应始终运行 init_skill.py。

适用场景

适用于用户希望创建新技能或更新已有技能以扩展 Agent 能力的场景,例如构建图像编辑技能、PDF 处理技能、前端网页应用构建技能、BigQuery 查询技能等需要专门工作流、工具集成或领域知识的任务。

限制

资料未提供具体的收费、价格、平台兼容性范围或效果保证信息。技能本身不包含多余文档,且部分步骤可能需要用户提供输入(如品牌资产或模板)。