要在codex中让skill真正执行自动化操作,必须将脚本置于scripts/子目录、赋予可执行权限、并在skill.md中明确声明调用指令,三者缺一不可。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在Codex中让Skill真正执行自动化操作,必须将脚本与SKILL.md声明的流程绑定,否则技能只能描述任务而无法动手做事。
确认脚本存放位置是否合规
进入你的Skill目录(例如~/.codex/skills/my-first-skill/),检查是否存在scripts/子目录。Codex只识别该路径下的可执行文件——放错位置(比如直接丢在根目录或assets/里)会导致脚本完全不被加载。
【脚本路径必须严格为 scripts/ 子目录下】
赋予脚本可执行权限(Linux/macOS)
打开终端,进入Skill的scripts/目录:
cd ~/.codex/skills/my-first-skill/scripts
对目标脚本(如helper.sh)运行:
chmod +x helper.sh
这一步漏掉,脚本会被Codex跳过执行,且不会报错提示——它只是静默忽略。
在SKILL.md中声明脚本调用方式
打开SKILL.md,在“## 执行步骤”下方添加明确的脚本调用指令行:
```markdown
## 执行步骤
1. 运行 git diff --cached 获取待提交变更
2. 提取修改的文件路径与关键改动行
3. 调用 scripts/helper.sh 生成结构化 commit message
```
Codex会逐行解析这里的命令,遇到scripts/xxx格式时自动匹配并执行对应脚本。不写这句,即使脚本存在且有权限,也不会触发。
验证脚本能否被Codex正确识别
方法一:重启Codex App后,在对话框中输入$skill list,查看目标Skill状态栏是否显示“✅ 已加载脚本”;
方法二:直接触发该Skill,观察日志输出里是否出现Executing script: scripts/helper.sh字样;
方法三:在脚本第一行插入echo "script started" >&2,再运行Skill,看终端或Codex日志窗口是否有该输出——这是最直接的执行证据。










