SuperAPI AI 工具集

skill-creator

通用与其它

查看项目

更新于 10-15 22:41

技能介绍

用途:Skill Creator 提供创建有效 Codex 技能的指导,适用于用户想新建或更新一个扩展 Codex 能力的技能时。技能是模块化、自包含的包,为 Codex 补充特定领域的知识、工作流与工具,相当于针对某类任务的“上手引导”。

主要能力与结构:每个技能由必需的 SKILL.md 和可选资源组成。SKILL.md 含 YAML frontmatter(name、description 为必填,也是 Codex 判断何时使用技能的唯一依据)和 Markdown 正文。可选资源包括 scripts/(可执行代码,适合重复编写或需确定性可靠性的任务)、references/(按需加载的文档,如数据库 schema、API 文档、公司政策)、assets/(用于最终输出的文件,如模板、图标、字体)。

设计原则:强调简洁,只补充 Codex 尚不具备的上下文;按任务脆弱性设置自由度(高自由度用文本指令,中自由度用带参数的伪代码或脚本,低自由度用具体脚本)。采用三级渐进式披露:元数据始终在上下文中,SKILL.md 正文在触发后加载(建议 500 行以内),捆绑资源按需加载。多领域或多框架技能应按领域/变体拆分到独立引用文件,引用保持一层深度,长文件加目录。技能中不应包含 README、安装指南、变更日志等多余文档。

创建流程:1)用具体示例理解技能用途;2)规划可复用内容(脚本、引用、资产);3)运行 scripts/init_skill.py <skill-name> --path <output-directory> 初始化模板;4)编辑技能,实现资源并编写 SKILL.md,脚本需实际运行测试;5)运行 scripts/package_skill.py <path/to/skill-folder> 打包为可分发的 .skill 文件,可指定输出目录如 ./dist;6)根据真实使用迭代。

限制:资料未提供该技能的收费、价格、平台支持范围及具体效果数据;打包脚本的完整校验细节在资料中未完整给出。