安装Skill是将工作流文件包放入Codex技能目录使其被识别,配置Skill是在安装后调整触发方式、输入参数及脚本路径以适配环境。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

安装 Skill 是把一个外部定义好的工作流文件包放进 Codex 的技能目录,让它被系统识别;配置 Skill 是在已安装基础上,调整其触发方式、输入参数或关联脚本,让它适配你的具体开发环境和任务习惯。
安装 Skill:让 Codex “看见”这个能力
第一步:确认 Codex 已启动并进入工作区 → 点击左侧 Skills 标签页 → 确保右上角显示「Local Skills」或「Community Skills」可切换状态。
第二步:打开终端,执行命令:codex skill install https://github.com/yourname/my-skill.git。这会自动克隆仓库、校验 SKILL.md 结构,并将文件夹复制到 【~/.codex/skills/my-skill/】 目录下。
第三步:重启 Codex 或手动点击 Skills 页面右上角的「Reload Skills」按钮。此时新 Skill 名称会出现在列表中,但尚未激活——它只是“存在”,还不会自动响应任务。
配置 Skill:告诉 Codex “什么时候用、怎么用”
打开 【~/.codex/skills/my-skill/SKILL.md】 文件,重点修改三处:
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
① 在 YAML 头部添加 trigger: manual 或 trigger: auto ——前者需前缀 $my-skill 显式调用,后者依赖 description 中关键词匹配;不写则默认为 manual。
② 修改 input: 区块,明确限定用户必须提供的内容类型。例如写成 input: PR diff output from git diff --no-index,而不是模糊的“代码变更内容”。【若此处描述不清,Codex 可能误读输入,生成偏离预期的 SQL 或测试用例】
③ 若 Skill 含 scripts/ 目录,检查脚本路径是否指向本地真实位置。比如 Python 脚本里写 subprocess.run(["python", "check_style.py"]),但实际该文件在 scripts/linters/ 下,则必须同步更新路径,否则运行时报 FileNotFoundError。
验证是否生效
新建一个对话窗口(旧对话缓存不加载新 Skill)→ 输入触发词,如 Skill 描述中写了“当用户说‘生成 Git 提交信息’时自动调用”,就直接说这句话。
如果 Codex 开始按 SKILL.md 里的【步骤】逐条执行,说明安装与配置均完成。

















