SuperAPI AI 工具集

skill-creator

智能体与模型

查看项目

更新于 10-16 01:37

技能介绍

用途:Skill Creator 是一份指导,用于在用户想要创建新技能或更新已有技能、以扩展 Codex 能力时使用。技能是模块化、自包含的文件夹,为 Codex 提供特定领域或任务的专业知识、工作流与工具。

主要能力:说明技能可提供专业工作流、工具集成(如特定文件格式或 API)、领域知识(公司特定知识、schema、业务逻辑)以及脚本、参考、资产等打包资源。核心原则包括简洁优先(技能与系统提示、对话历史共享上下文窗口)、按任务脆弱性设定自由度(高自由度文本指令、中自由度带参数伪代码或脚本、低自由度固定脚本),以及渐进式披露的三级加载:元数据始终在上下文、SKILL.md 正文在触发时加载、打包资源按需加载。

结构:每个技能包含必需的 SKILL.md(YAML frontmatter 含 name 与 description,以及 Markdown 指令正文)、推荐的 agents/openai.yaml(用于技能列表与标签的 UI 元数据),以及可选的 scripts/、references/、assets/。不应包含 README、安装指南、变更日志等多余文档。建议 SKILL.md 正文保持在 500 行以内,拆分内容时从 SKILL.md 引用并说明何时读取。

使用方式:流程为理解技能与具体示例、规划可复用内容、初始化技能、编辑技能、校验技能、基于真实使用迭代。命名使用小写字母、数字与连字符,文件夹与技能名一致。初始化命令:scripts/init_skill.py <skill-name> --path <output-directory> [--resources scripts,references,assets] [--examples]。生成界面元数据可运行 scripts/generate_openai_yaml.py <path/to/skill-folder> --interface key=value。校验运行 quick_validate.py。

限制:应只包含直接支持其功能的必要文件,避免嵌套过深的引用,较长参考文件顶部加目录。其余细节暂未提供。