用途:该技能为创建、更新和打包 AgentSkills 提供指导,帮助把 Codex 从通用智能体扩展为具备特定领域流程知识的专用智能体。技能是模块化、自包含的包,可提供专用工作流、工具集成、领域专长和捆绑资源。
主要能力与结构:每个技能必需 SKILL.md,包含 YAML frontmatter(name、description)与 Markdown 指令;可选捆绑 scripts/(可执行代码)、references/(按需载入的参考文档)、assets/(输出中使用的模板、图标、字体等文件)。frontmatter 的 name 与 description 是 Codex 判断技能何时被使用的唯一依据。
使用方式与流程:技能创建依次为理解具体使用示例、规划可复用内容、初始化技能(运行 scripts/init_skill.py <skill-name> --path <output-directory> [--resources scripts,references,assets] [--examples])、编辑 SKILL.md 与资源、打包(运行 package_skill.py)、按真实使用迭代。命名使用小写字母、数字与连字符,文件夹名与技能名一致,长度小于 64 字符。
设计原则:保持简洁,只补充模型不具备的信息;按任务脆弱度设置自由度;采用三级渐进式披露(元数据、SKILL.md 主体、捆绑资源);SKILL.md 主体控制在 500 行以内,超出则拆分到 references/ 并明确引用时机;不要创建 README、安装指南等额外文档。
限制:资料未提供具体安装命令、定价、平台支持范围以及完整示例代码,相关内容暂未提供。