人人都会AI编程

Codex桌面开发工具接入Claude标准Skill完整教程

更新时间：2026-07-18

适配React/React Native+ mattpocock-typescript-skills）

一、两种接入Skill方式（全自动一键安装 / 手动本地部署）

你的核心需求是接入 mattpocock-typescript-skills 这套React/TS专用技能，Codex完全兼容Claude标准.claude/skills目录结构，两种方案任选，一键安装更省事。

方式1：一键命令安装（推荐，30秒搞定）

  1. 打开电脑终端（Windows PowerShell / Mac终端），直接执行安装指令
npx skills@latest add mattpocock/skills
  1. 弹出选择列表时，勾选Codex作为目标工具，同时必须选中 setup-matt-pocock-skills 初始化技能
  2. 等待自动拉取仓库、生成合规Skill文件夹，自动同步到Codex全局技能目录
  3. 打开Codex桌面端，在对话框输入 $setup-matt-pocock-skills，完成React/TS环境初始化（填写文档目录、代码规范标签）

方式2：手动部署（适合离线、自定义修改Skill规则）

  1. 克隆源码仓库到本地
git clone https://github.com/mattpocock/skills.git
  1. 区分全局技能（所有项目生效）、项目专属技能（仅当前React/RN项目生效）
  • 全局路径（Windows）：C:\Users\你的用户名\.codex\skills\
  • 全局路径（Mac）：~/.codex/skills/
  • 项目专属路径：你的React项目根目录下新建 .codex/skills/
  1. 把仓库内 skills/ 文件夹完整复制到上面路径，每个子文件夹内部必须存在SKILL.md（Codex识别Skill的核心文件）
  2. 完全关闭Codex软件，重新打开，软件启动时会自动扫描全部Skill目录加载技能

二、核心配置：确保每次提问自动调用这套TS/React Skill

很多人装完Skill只会手动$ts-react触发，做不到全程自动生效，下面4步配置完成后，只要你写React、React Native、TS相关需求，Codex会强制优先加载这套技能，不用手动输入指令。

步骤1：开启Codex全局自动加载开关

  1. 打开Codex桌面端 → 右上角设置 → 工具 → AI助手 → 技能管理
  2. 勾选两个核心选项：
  • 「自动扫描本地Skill目录」
  • 「匹配场景自动触发对应技能」
  1. 选中 mattpocock-typescript-skills，勾选全局启用，不要禁用

步骤2：修改Skill内部SKILL.md，强化React/RN自动匹配规则

打开mattpocock-typescript-skills里的SKILL.md，修改头部描述块，增加强匹配关键词，让Codex一看到React、RN、TS、组件、hooks就自动调用： @@SNAPSHOT_BLOCK_2@@

保存文件，重启Codex。

步骤3：配置Codex预加载，会话启动直接注入技能上下文

  1. 找到Codex全局配置文件
  • Windows：C:\Users\用户名\.codex\config.yaml
  • Mac：~/.codex/config.yaml
  1. 添加预加载配置，每次新开对话自动载入TS技能：
skills:
  auto_load: true
  preload:
    - mattpocock-typescript-skills
  whitelist:
    - mattpocock-typescript-skills
  • preload：每次对话初始化自动加载技能，不用等匹配才调取
  • whitelist：白名单锁定，不会被其他Skill覆盖优先级

步骤4：项目根目录添加引导文件，强化React项目专属约束

在你的React/RN项目根目录新建 .codex/CLAUDE.md，写入固定前置规则，Codex读取项目文件时会强制绑定TS技能：

本项目为React/React Native + TypeScript技术栈，所有代码生成、重构、Bug修复、组件编写必须使用mattpocock-typescript-skills技能，严格遵循TS强类型规范，杜绝any、类型缺失、不规范Hooks写法。

三、两种调用方式（自动+手动兜底）

1. 自动调用（配置完成后默认生效）

只要你的提问包含React、RN、TS、组件、页面、hooks等关键词，Codex会自动加载Skill执行整套规则，不用额外输入任何指令，比如直接提问：

  • “写一个用户列表React组件”
  • “重构这个React Native页面，修复类型报错”
  • “封装通用请求hooks”

AI会自动套用Matt Pocock的TS编码规范输出代码。

2. 手动强制调用（兜底，自动失效时用）

Codex手动触发Skill前缀是 $，对话开头输入：

$ts-react 帮我开发一个RN登录页面

不管提问内容是什么，都会强制加载这套TypeScript技能，适合复杂重构、批量代码整改场景。

四、验证Skill是否正常加载（排查不生效问题）

  1. 在Codex聊天框输入指令查看全部已加载技能
$skills list

列表出现 mattpocock-typescript-skills 代表安装成功

  1. 测试自动触发：直接提问「写一个React函数组件」

观察AI输出代码：不会出现any、自动生成Props接口、规范useState/useRef泛型，代表自动调用生效

  1. 不生效常见排查点
  • 文件夹结构错误：每个Skill必须独立文件夹，内部存在SKILL.md
  • 配置文件修改后没有完全关闭重启Codex
  • 关键词匹配不足：补充SKILL.md的match_keywords
  • 路径含中文：Skill存放目录不能有中文、空格

五、React/React Native用户专属优化技巧

  1. 和Superpowers工程Skill搭配使用：Superpowers管控开发流程、代码评审，mattpocock-typescript-skills管控TS代码规范，两者互不冲突，同时预加载
  2. 做RN项目时，在SKILL.md补充 react-native、View、TouchableOpacity、StyleSheet 匹配关键词，提升移动端代码约束力度
  3. 批量重构旧TS项目：输入 $ts-react 批量重构项目全部组件，清理所有any类型，一键标准化全部历史代码