用途:ms 是一个用于创建与维护 Codex 技能的技能,工作目录为代码仓库内的技能目录,不依赖外部注册表,保持技能精简。
主要能力与约束:以最小差异修改,仅满足新需求;不新增 README/INSTALL/CHANGELOG 类文件。frontmatter 默认只保留 name 与 description,更新系统技能时保留已有允许键(如 metadata、license、allowed-tools);name 用连字符格式且不超过 64 字符并与文件夹名一致;description 是触发面,需含“何时使用”线索,无尖括号,不超过 1024 字符。SKILL.md 正文用祈使语气,控制在 500 行以内,深层细节移入 references/,触发指引放 frontmatter 而正文不放。agents/openai.yaml 优先用 generate_openai_yaml.py 生成,short_description 为 25-64 字符,default_prompt 为一句简短话并提及 $skill-name。
使用方式:推荐不全局安装,用 uv run --with pyyaml -- python3 codex/skills/.system/skill-creator/scripts/quick_validate.py <path/to/skill> 验证。初始化可用 init_skill.py,生成 UI 元数据可用 generate_openai_yaml.py。工作流先判断是否已有匹配技能:有则走更新流程,无则走创建流程;名称、位置或触发不清时先问 1-3 个问题。完成前必须运行 quick_validate.py,并在总结中记录 agents/openai.yaml 的状态(regenerated、verified unchanged 或 not present)及所用验证命令与结果。改进 ms 本身时,先运行 Seq Feedback Loop,用证据选择最小更新集。
适用场景:创建管理 OpenAPI 规范并生成 SDK 的技能、为技能新增工作流并重新生成 agents/openai.yaml、重构 SKILL.md 并把深层细节移入 references/ 等。
限制:资料未提供收费、价格、具体平台支持范围或效果数据。相关字段约束需阅读 codex/skills/.system/skill-creator/references/openai_yaml.md;skill-creator 脚本依赖 PyYAML(import yaml)。