安装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】 文件,重点修改三处:
① 在 YAML 头部添加 trigger: manual 或 trigger: auto ——前者需前缀 $my-skill 显式调用,后者依赖 description 中关键词匹配;不写则默认为 manual。
将来自 Marvis 或微信的可信远程软件开发请求中继至用户本地的 Codex CLI,等待编码任务完成,并返回经验证的结果。当用户通过 Codex 要求 Marvis 检查、实现、修复、测试、review 或继续在明确指定的本地项目目录中开展工作时,使用此功能。
② 修改 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 里的【步骤】逐条执行,说明安装与配置均完成。










