SuperAPI AI 工具集

skill-creator

智能体与模型

查看项目

更新于 10-16 04:53

技能介绍

用途:为 Codex 创建或更新技能(skill)提供指导。技能是模块化、自包含的包,扩展 Codex 能力,提供专门知识、工作流与工具。

主要能力与核心原则:强调简洁,上下文窗口是公共资源,只补充 Codex 原本没有的内容;按任务脆弱程度设置自由度:高自由度用文本说明,中自由度用伪代码或带参数脚本,低自由度用固定脚本与少量参数。

技能结构:每个技能包含必需的 SKILL.md(含 YAML frontmatter 的 name 与 description,以及 Markdown 指令)和可选资源:scripts/ 可执行代码、references/ 按需加载的文档、assets/ 用于输出的文件。SKILL.md 中 description 是主要触发机制,需写清技能做什么以及何时使用。

渐进式披露:分三级加载——元数据始终在上下文、SKILL.md 正文在触发后加载、资源按需加载。正文建议少于 500 行,大型内容拆分到引用文件,引用保持一层深度,超过 100 行的文件加目录。

创建流程:理解技能与具体示例;规划可复用内容;运行 scripts/init_skill.py <skill-name> --path <output-directory> 初始化;编辑技能与 SKILL.md(正文用祈使式);运行 scripts/package_skill.py <path/to/skill-folder>(可加输出目录)打包并校验;依据真实使用迭代。

不应包含:README.md、INSTALLATION_GUIDE.md、QUICK_REFERENCE.md、CHANGELOG.md 等多余文档。

限制:上述流程依赖所提供脚本,资料未说明其运行环境、依赖或平台;未提及收费、价格与效果数据。