用途:为当前代码仓库识别有用的 Codex 技能,并把选定的想法转化为高质量的 SKILL.md 草稿。成功标准是建议的技能能解决重复性工作、不与现有技能重复、具有清晰的触发描述,并包含正确的项目本地或全局放置位置。
主要能力:先阅读最近的 AGENTS.md 获取项目规则、命令和约定;扫描 flake.nix、package.json、Cargo.toml、pyproject.toml、Makefile、justfile、Dockerfile 及 CI 工作流等顶层文件;查看 .codex/skills//SKILL.md 中的项目已有技能,以及 config/codex/skills//SKILL.md 中相关的全局技能;从脚本、测试、CI、文档和配置布局中识别重复出现的痛点。若用户指定关注领域,则优先该领域,同时仍检查是否重复。
技能想法字段:每个想法包含技能名($skill-name)、类型(Reference/Task/Background Knowledge)、调用方式(User-only/Codex-only/Both)、原因、功能、触发关键词、复杂度(Simple/Advanced)、范围(项目本地 .codex/skills/ 或全局 config/codex/skills/)。可考虑与仓库匹配的类别:代码生成与脚手架、测试与验证、代码审查与项目特定质量检查、CI/部署与发布工作流、文档工作流、调试与日志分析、重构与迁移、DevOps/基础设施与配置管理、依赖管理、仓库特定领域工作流。只建议满足以下条件的技能:解决可见的重复需求、受益于 Codex 跨文件读取编辑生成验证、未被现有项目或全局技能覆盖、有具体触发条件和有界结果、编辑文件时可用明确命令或检查验证。
展示结果:按类别分组呈现前 5-8 个想法,并为前 3 个提供基于仓库证据的简要理由(如重复脚本、配置族、CI 作业或现有文档)。在写文件前询问用户想创建哪些技能,除非用户已要求实现。
起草选定技能:为每个选定技能起草带 name 和 description frontmatter 的完整 SKILL.md。仓库特定工作流选项目本地范围 .codex/skills/<name>/;可移植工作流选全局范围 config/codex/skills/<name>/。仅当能减少上下文负载或让工作流更可靠时,才添加 references/、scripts/、assets/ 或 agents/openai.yaml。全局技能需更新预期清单并验证完整目录:./tests/test-codex-skills.sh。项目本地技能需核对其 frontmatter name 与目录是否一致,并运行最窄范围的相关仓库测试;已跟踪的全局验证器故意不盘点项目本地技能。
编写注意:description 前置触发关键词;保持 SKILL.md 聚焦,将详细材料移入 references/;优先使用 $skill-name 示例进行显式调用;写明智能体应运行的真实命令,而不是依赖斜杠命令参数替换;当技能需要显式调用或暴露 UI 元数据时使用 agents/openai.yaml。
限制:资料未提供具体收费、价格、平台或效果信息。