用途:在 config/codex/skills/ 下创建可移植的全局 Codex 技能(SKILL.md 加可选资源),完成创建或更新、校验通过并给出调用示例即达成目标。
主要能力与做法:先读取会话中当前的 Codex 技能编写说明,查看现有已跟踪技能与 tests/test-codex-skills.sh;不要依赖被 gitignore 的系统目录 config/codex/skills/.system。随后询问技能的复用目的、触发场景以及是否需要 references、scripts、templates 或 assets。创建 config/codex/skills/<skill-name>/ 目录,SKILL.md 的 frontmatter name 需匹配;描述文字应简洁并把关键任务与触发词前置;详细文档放 references/,确定性辅助脚本放 scripts/,输出资源放 assets/。当需要 UI 元数据或显式调用策略时,可添加 agents/openai.yaml,但只保留现有技能支持的接口与策略字段。新增技能需登记到 tests/test-codex-skills.sh 的预期清单,并运行 ./tests/test-codex-skills.sh;每次全局技能变更都运行 make test-pre。
仓库背景:该仓库在 config/codex/skills 跟踪全局 Codex 技能,scripts/link-config.sh 会把该目录链接到 ${CODEX_HOME:-~/.codex}/skills。全局技能应保持与具体项目无关;只在 dotfiles 仓库内有意义的工作流应放在 .codex/skills。
限制:资料未提供技能具体功能细节、收费与价格、平台支持范围或效果数据。