SuperAPI AI 工具集

skill-creator

编程与开发

查看项目

更新于 10-15 17:31

技能介绍

用途:skill-creator 用于指导创建有效的智能体技能(agent skills),并可在重构臃肿技能时参考。其核心观点是技能不等于文档,而是执行任务所需的工作流能力,目标是让合适的信息在合适的时间被加载。

主要能力:介绍三层架构。第一层为元数据(始终加载),仅含 YAML frontmatter,约 100 词,足以让模型判断相关性;第二层为 SKILL.md 入口点(激活时加载),最多约 200 行,包含概览、快速开始与导航,并指向引用文件而非直接包含;第三层为 references/ 目录(按需加载),每个文件约 200 至 300 行,聚焦单一主题。

使用方式:给出标准技能目录结构,包括 SKILL.md 入口点、references/ 详细内容、可选 scripts/ 可执行代码与 assets/ 模板。提供 SKILL.md 模板,包含 YAML frontmatter 的 name、description,可选 tools、model,正文含简要描述、快速开始、工作流与引用表。写作规范包括使用祈使语气、面向行动、渐进式细节与避免冗余。

适用场景:适合需要特定工作流知识、包含多步决策点、可跨项目复用的任务;详细实现细节、代码示例、边界情况与排障内容适合放入 references。

限制与重构:入口点必须低于 200 行,各引用 200 至 300 行,冷启动加载少于 500 行,相关信息占比高于 80%。当 SKILL.md 超过 200 行、加载 5 个以上技能引发上下文问题、或加载内容 90% 未被使用时,应进行重构:把详细段落移入 references/,SKILL.md 只保留概览,添加导航表,并测试冷启动。具体命令、完整示例与未在此列出的细节暂未提供。