SuperAPI AI 工具集

skill-creator

智能体与模型

查看项目

更新于 10-15 22:15

技能介绍

用途:skill-creator 用于指导创建或更新扩展 Claude 能力的技能。技能是模块化、自包含的包,为特定领域或任务提供专门知识、工作流与工具,相当于针对某类任务的“上手引导”,把通用代理变成掌握程序性知识的专用代理。

主要能力:技能可提供专门工作流(多步骤流程)、工具集成(特定文件格式或 API 的用法)、领域专长(公司特定知识、schema、业务逻辑)以及捆绑资源(脚本、参考文档、资产)。

结构:每个技能包含必需的 SKILL.md 和可选的捆绑资源。SKILL.md 需含 YAML frontmatter 元数据(name、description 必填)与 Markdown 指令;可选目录为 scripts/(可执行代码)、references/(按需载入上下文的文档)、assets/(用于输出的模板、图标、字体等)。

要求:技能应按主题合并,例如 cloudflare、cloudflare-r2、cloudflare-workers、docker、gcloud 合并为 devops。SKILL.md 应少于 200 行,并引用相关 markdown 与脚本;每个脚本或引用文件也应少于 200 行,可拆分(渐进披露原则)。元数据描述要简洁且包含足够用例,便于自动激活。引用 markdown 时可牺牲语法换取简洁,也可互相引用。脚本优先用 Node.js 或 Python 而非 bash(Windows 支持较差);Python 脚本需 requirements.txt;脚本读取 .env 的顺序为 process.env > .claude/skills/${SKILL}/.env > .claude/skills/.env > .claude/.env,并提供 .env.example;脚本应编写测试。

创建流程:1)用具体示例理解技能用途;2)规划可复用内容(脚本、参考、资产);3)运行 scripts/init_skill.py <skill-name> --path <output-directory> 初始化模板;4)编辑技能,先做可复用资源,再更新 SKILL.md,使用祈使句、客观说明性语言;5)运行 scripts/package_skill.py <path/to/skill-folder> 打包,可指定输出目录如 ./dist,脚本会先校验 frontmatter、命名、目录结构、描述质量与文件组织,通过后生成同名 zip;6)在真实任务中迭代改进。

限制:资料未提供收费、价格、平台支持范围或效果保证等信息。