用途:为创建或更新 Codex 技能提供指导,把专门知识、工作流和工具封装成模块化、自包含的技能文件夹,使 Codex 从通用智能体变为特定领域的专用智能体。
主要能力:讲解技能结构(必需的 SKILL.md,含 name 与 description 的 YAML frontmatter 及 Markdown 正文;推荐的 agents/openai.yaml;可选的 scripts、references、assets);说明渐进式披露三级加载机制(元数据常驻、SKILL.md 触发时加载、资源按需加载);给出自由度设置、命名规范(小写字母、数字、连字符,64 字符内,动词开头)与内容精简原则。
使用方式:按流程执行——用具体示例理解技能、规划可复用内容、运行 scripts/init_skill.py <skill-name> --path <output-directory> [--resources scripts,references,assets] [--examples] 初始化、编辑 SKILL.md 与资源、运行 quick_validate.py 校验、根据实际使用迭代。agents/openai.yaml 可通过 scripts/generate_openai_yaml.py <path/to/skill-folder> --interface key=value 生成。
适用场景:需要为 Codex 添加领域工作流、工具集成、公司专属知识或可复用脚本与模板时。
限制:技能内不应包含 README、安装指南、变更日志等冗余文档;SKILL.md 建议控制在 500 行以内,引用保持一层深度;具体收费、平台与效果信息暂未提供。