SuperAPI AI 工具集

create-skill

智能体与模型

查看项目

更新于 10-16 07:27

技能介绍

用途:create-skill 用于按照 Agent Skills 开放标准(agentskills.io)创建新的智能体技能,帮助把一项任务整理成可被智能体加载和触发的技能文件。

主要能力:该技能以五个阶段推进。第一阶段是访谈,围绕技能覆盖的任务、要解决的具体问题、范围边界(明确不该做什么)、输入输出与格式、边界情况与常见错误、成功标准、哪些操作可脚本化、是否需要参考资料、可借鉴的既有模式以及跨平台约束(macOS、Windows、Linux 的路径分隔符、临时目录与 shell 差异)逐一提问,每次只问一个问题,能通过查看代码库回答的就去查看,用户确认范围完整后才进入下一阶段。第二阶段起草 SKILL.md,包含 frontmatter(name 为小写、连字符、最多 64 字符;description 最多 1024 字符,是唯一的触发机制)和正文,正文遵循渐进式披露:元数据约 100 tokens 在启动时加载,指令少于 500 行在技能激活时加载,references/、scripts/、assets/ 等资源按需加载。写作上使用祈使句、模板定义输出格式、给出输入到输出的具体示例、加入常见错误提示、用清单处理多步流程,并明确说明何时读取每个参考文件。第三阶段优化 description,通过编写 5 条应触发和 5 条不应触发的查询来验证区分度,必要时放宽或收窄,并确认不超过 1024 字符。第四阶段编写脚本,倾向把确定性操作(校验、模板生成文件、数据提取与转换、结构化 API 调用、环境检查、输出格式化)写成脚本,只把判断、创意推理和决策留给指令;脚本可用仅标准库的 Python 加 argparse,或使用 PEP 723 内联元数据配合 uv run,并应具备结构化输出、清晰退出码和描述性 --help。第五阶段按清单审查名称、描述、正文行数、祈使句、参考文件指针、脚本规范、避免时效性信息、术语一致性和示例。

使用方式:资料未提供具体安装命令或调用方式,仅说明其流程与规范。

适用场景:需要为智能体新增可复用技能、并希望技能描述能被正确触发时。

限制:资料未提供收费、价格、平台支持范围或实际效果等信息;正文行数、描述长度等为规范要求,非保证结果。