Windows版Codex添加自定义Skill有两种方式：一是通过客户端「Skill开发」新建项目并本地发布；二是手动解压技能包至C:\Users\【用户名】.codex\skills\目录，确保含SKILL.md文件，重启后启用并用${skill_name}语法触发。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Windows版Codex中添加自定义Skill，核心路径是让客户端识别并加载你写的技能逻辑，不依赖云端发布也能立即生效。官方支持两种主流方式：一种是通过客户端图形界面新建项目并打包部署，另一种是直接将技能文件夹扔进指定目录，后者更轻量、调试更快。
用客户端图形界面新建并部署Skill
打开Codex Windows客户端，确保已登录且处于主工作区界面。
点击左下角「Skill开发」→ 选择「新建Skill」→ 填写名称（如git-clean-branch）、描述、选择本地保存路径（建议选空文件夹，避免混入其他文件）。
客户端会自动生成基础项目结构，包括main.py和manifest.json。打开manifest.json，确认input_schema字段已正确定义输入格式，比如必须含query字符串字段；【若此处schema格式错误或缺失，技能将无法被识别，后续测试必失败】。
编辑main.py，实现处理逻辑。最简示例只需返回固定字符串：def handle(input_data): return {"response": "Hello from skill!"}。保存后回到客户端，点击「测试」按钮发送模拟请求，观察输出面板是否显示预期响应。
测试通过后，点击「发布」→ 选择「本地部署」→ 等待打包完成，生成的.skill文件会自动注册进系统。
手动解压技能到skills目录（推荐快速验证）
关闭Codex客户端，防止文件被占用。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
进入你的用户目录：C:\Users\【你的用户名】\.codex\skills\。如果该路径不存在，手动创建skills文件夹。
将准备好的Skill压缩包（如my_formatter.zip）解压到skills目录下，形成完整子路径：C:\Users\【你的用户名】\.codex\skills\my_formatter\SKILL.md。注意：【SKILL.md必须存在且位于根级，否则客户端无法扫描到该技能】。
重新启动Codex客户端，等待约3秒——技能管理页会自动刷新列出新技能。
启用并触发Skill
在Codex主界面右上角点击「技能」→ 找到刚添加的技能名称 → 点击右侧开关按钮启用它。
切换到聊天窗口，输入触发语法：${my_formatter} 格式化这段JSON：{"name":"Alice","age":30}。注意$符号和花括号不可省略，中间无空格。
若响应延迟超过5秒，检查main.py中是否包含阻塞操作（如未设超时的网络请求），这类代码会导致整个Skill线程卡死。
