SuperAPI AI 工具集

skill-creator

通用与其它

查看项目

更新于 10-15 19:58

技能介绍

用途:当用户想要创建新技能或更新已有技能以扩展 Codex 能力时使用,提供创建有效技能的指导。

主要能力:说明技能是什么——模块化、自包含的包,提供专用知识、工作流与工具;技能可提供专用工作流、工具集成、领域专长与打包资源。核心原则包括简洁优先(上下文窗口是公共资源,只补充 Codex 尚不具备的信息,优先用简洁示例而非冗长解释),以及设置适当的自由度:高自由度用文本指令,中自由度用伪代码或带参数脚本,低自由度用具体脚本和少量参数。

技能结构:每个技能包含必需的 SKILL.md 与可选打包资源。SKILL.md 含 YAML frontmatter(name 与 description 必填,description 不得含冒号,以免影响 GitHub Copilot CLI)和 Markdown 正文。可选资源包括 scripts/(可执行代码)、references/(按需加载的文档)、assets/(用于输出的模板、图标、字体等)。不应包含 README.md、INSTALLATION_GUIDE.md、QUICK_REFERENCE.md、CHANGELOG.md 等多余文档。

渐进式披露:采用三级加载——元数据始终在上下文,SKILL.md 正文在触发后加载,打包资源按需加载。SKILL.md 正文建议保持在 500 行以内,超出时拆分文件并从 SKILL.md 引用;引用保持一层深度,长文件加目录。

创建流程:理解技能的具体示例、规划可复用内容、初始化技能(运行 scripts/init_skill.py <skill-name> --path <output-directory> [--resources scripts,references,assets] [--examples])、编辑技能、打包技能(运行 package_skill.py)、根据实际使用迭代。命名使用小写字母、数字和连字符,长度 64 字符以内,优先动词开头短语,文件夹名与技能名一致。

限制:资料未提供具体收费、价格、平台支持范围与效果数据;脚本的具体实现细节与 package_skill.py 的完整用法暂未提供。