Codex 核心进阶玩法（技能/MCP/派生/分叉/Git/钩子/子智能体）

文章目录

• Codex 核心玩法全梳理（技能/MCP/派生/分叉/Git/钩子）
• 一、基础必懂：工作树（Work Tree）
• • 什么是工作树？
  • 作用
  • 常用操作
• 二、最常用：派生（Derive）
• • • 两个选项详细区别
    • • 1. 派到本地
      • 2. 派到新工作树
    • 核心对比表
    • 简单举例子
• 三、进阶：分叉（Fork）
• • 分叉 = 给当前工作树创建一个“可回溯的版本快照”
  • 用途
  • 用法
• 四、超级神器：Skills（技能）
• • 1. 什么是 Skills？
  • 2. 为什么强？
  • 3. 存放位置
  • 4. 最简单创建方式
  • 5. 使用
  • 6. 官方支持的技能类型
  • 7.推荐的skills
• 五、最强扩展：MCP（Model Control Protocol）
• • 1. MCP 是什么？
  • 2. 能做什么？
  • 3. 一句话理解
• 六、自动化：钩子（Hooks）
• • 1. 钩子 = 触发式自动化脚本
  • 2. 支持的钩子
  • 3. 用途示例
  • 4. 配置位置
• 七、codex子智能体
• • 0、什么是 Codex 子智能体（Subagent）
  • • 两大核心特性
  • 1、最通俗的比喻
  • 2、它和普通“新开页面”唯一的小区别（很重要）
  • • 总结
• 八、与 Git 深度集成（Codex 原生支持）
• • 1. 不用你手动敲 Git 命令
  • 2. Codex 会自动：
  • 3. 最强功能：AI 帮你写 commit 信息
  • 4. 最安全：AI 自动检查冲突
• 九、最常用组合 workflow（直接照抄用）
• • 1. 安全开发流
  • 2. 标准化开发流
  • 3. 全自动化流
  • 4. 多项目管理流

Codex 核心玩法全梳理（技能/MCP/派生/分叉/Git/钩子）

一、基础必懂：工作树（Work Tree）

什么是工作树？

= Codex 操作的“当前项目目录” 你每次打开 Codex，选的那个文件夹，就是一个工作树。

作用

• Codex 只会读写这个目录里的文件
• 切换工作树 = 切换项目
• 所有修改、历史、技能、配置都绑定当前工作树

常用操作

• 打开新目录 = 新工作树
• 切换已有目录 = 切换工作树
• 关闭 = 退出当前工作树

二、最常用：派生（Derive）

两个选项详细区别

1. 派到本地

• 工作空间：完全沿用你当前正在打开的本地文件夹/原有Git工作区，不会新建独立代码目录。
• 文件影响：新分支对话里AI后续生成、修改的代码，会直接改动你现在磁盘里的文件。如果之前轮次改动过文件系统，新分支内容会和当前磁盘文件存在不一致的风险。
• 适用场景：只想基于旧消息开一条新对话思路，继续在当前项目目录里迭代，不需要物理隔离代码文件。
• 还是在当前目录，只不过新开了一个分支对话

2. 派到新工作树

• 工作空间：会基于Git的worktree功能，创建一个全新、物理隔离的独立代码文件夹（共享同一个Git仓库版本库，但文件目录完全分开）。
• 文件影响：AI后续所有代码操作都在这个新目录里进行，完全不会干扰你原本打开的项目文件，天然规避新旧内容冲突的问题。
• 适用场景：想并行做两套完全独立的方案、做高风险实验性修改，需要两套代码互不干扰、可以同时查看编辑。
• 不在当前目录，默认会在codex的worktree里面复制新建一个与刚刚完全一样的环境

核心对比表

简单举例子

你现在在/project/main做开发，想基于3轮前的消息换思路：

• 选派到本地：新对话改的代码直接写进/project/main里；
• 选派到新工作树：会自动生成/project/new-fork新文件夹，新对话所有改动都在这个新文件夹里，原来的main文件夹内容纹丝不动。

三、进阶：分叉（Fork）

分叉 = 给当前工作树创建一个“可回溯的版本快照”

不是 Git 分叉，是 Codex 内部快照。

用途

• 改代码前先分叉
• 改错了可以一键切回去
• 相当于手动版本控制

用法

右键工作树 → Fork 改崩了 → 切回旧分叉

四、超级神器：Skills（技能）

1. 什么是 Skills？

= 你教给 Codex 的固定工作流 = 可复用的提示词模板 + 规则 + 自动化步骤

2. 为什么强？

你写一次规则，Codex 永远记住，以后一句话就能调用。 你可以通过codex里面的插件商城安装skil

3. 存放位置

你的项目目录/.codex/skills/

上面是我自己装的一些skills。

4. 最简单创建方式

在 .codex/skills/ 新建文件： vue3-component.md

内容示例：

# 技能：生成 Vue3 组件
规则：
– 必须用 script setup
– 必须定义 props
– 必须带注释
– 样式用 scoped
输出：一个完整单文件组件

5. 使用

直接在 Codex 里说：

使用技能 vue3-component 生成一个用户卡片组件

6. 官方支持的技能类型

• 代码规范
• 项目架构规则
• 接口开发模板
• 数据库建模模板
• 自动化流程
• 代码审查标准

Skills 是 Codex 效率提升最大的功能。

7.推荐的skills

github上有非常多好的skill，比如👆上面这些，可根据需求安装对应的skills使你的codex更上一层楼

五、最强扩展：MCP（Model Control Protocol）

1. MCP 是什么？

Codex 的插件系统 让 AI 能调用外部工具：浏览器、数据库、Redis、设计图、API 等。

2. 能做什么？

• 读取网页内容生成代码
• 连接数据库生成 CURD
• 读取 Figma 设计稿生成页面
• 调用 API 生成接口代码
• 读取 PDF/Excel 生成解析脚本

3. 一句话理解

MCP = 给 Codex 装上眼睛和手脚 让它不只写代码，还能读外部数据。

六、自动化：钩子（Hooks）

1. 钩子 = 触发式自动化脚本

Codex 在特定事件自动执行命令。

2. 支持的钩子

• 生成代码前
• 生成代码后
• 保存文件前
• 派生前/后
• 分叉前/后

3. 用途示例

• 代码生成后自动格式化
• 保存后自动运行 lint
• 派生后自动安装依赖
• 修改后自动运行测试

4. 配置位置

.codex/hooks/

写脚本即可自动触发。

七、codex子智能体

Subagent 子智能体 ≈ 就是在 Codex 里新开了一个独立页面

0、什么是 Codex 子智能体（Subagent）

你是项目经理，Codex 主 Agent 是总负责人，子智能体就是专门干活的程序员。

两大核心特性

1、最通俗的比喻

主对话 = 你的主微信窗口 Subagent（子智能体）= 你点开的一个单独聊天窗口**（分支对话）**

它们的关系就是：

• 独立聊天
• 独立记忆
• 独立干活
• 互相不干扰

2、它和普通“新开页面”唯一的小区别（很重要）

普通新开页面：

• 空白的
• 没有历史上下文
• 不知道你之前写了什么代码

Subagent（子智能体）新开的页面：

• 带着你之前的代码、历史、项目环境一起过去
• 相当于从当前对话“分叉”出去一个独立版本
• 可以单独改代码、单独跑命令、单独生成文件
• 不会影响主对话

你在 Codex 里看到：

• 主窗口
• Singer
• Dirac
• Bacon
• Dewey

每一个名字，就是一个 subagent，就是一个独立页面！

总结

Subagent 子智能体 = Codex 里的独立对话页面

八、与 Git 深度集成（Codex 原生支持）

关于这部分的内容有兴趣可以翻看本系列中我对git的详细讲解的相关博客。这里只大概介绍下

1. 不用你手动敲 Git 命令

你只需要说：

• 提交代码
• 撤销修改
• 切换分支
• 合并分支
• 查看改动

2. Codex 会自动：

• git add
• git commit
• git push
• git diff
• git checkout
• git merge

3. 最强功能：AI 帮你写 commit 信息

你只需要说：

提交本次修改，生成清晰的 commit 信息

4. 最安全：AI 自动检查冲突

Codex 会：

• 告诉你哪里冲突
• 帮你自动解决
• 不会乱覆盖代码

九、最常用组合 workflow（直接照抄用）

1. 安全开发流

Fork（分叉）→ 写代码 → 测试 → Derive（派生）→ Git 提交 永远不弄脏原项目

2. 标准化开发流

Skills（加载规范）→ 生成代码 → Hooks（自动格式化）→ Git 提交

3. 全自动化流

MCP（读取Figma/接口）→ Skills → 生成代码 → Hooks → Git 提交

4. 多项目管理流

工作树 1 → 派生 → 新工作树 2 工作树 A ↔ 工作树 B 自由切换