Codex技能（Skills）完整教程：打造可复用AI工作流，让Codex变成你的专属开发助手

Codex技能（Skills）完整教程：打造可复用AI工作流，让Codex变成你的专属开发助手

SEO关键词： Codex技能教程、Codex Skills、Codex工作流、Codex插件、Codex技能配置、Codex AI助手、OpenAI Codex技能、Codex SKILL.md、Codex自动化工作流

文章摘要： 本文详细讲解 OpenAI Codex Skills（技能）功能的使用方法，包括技能创建、SKILL.md配置、技能目录结构、触发机制、插件分发、技能安装与管理等内容。通过技能系统，可以将提示词、参考文档和脚本封装为可复用工作流，大幅提升Codex在开发、运维、测试和团队协作中的效率。

在这里插入图片描述

大家好 这里是「代码简单说」,欢迎大家关注同名公众号,不定时更新更多实用有趣的教程 也欢迎大家在评论区一起讨论交流!~

Codex除了强大的代码生成能力之外，还有一个很多开发者容易忽略的功能——Skills（技能）。

很多人把Codex当成聊天工具使用，但实际上，通过技能系统，可以把常用开发流程、项目规范、运维脚本、测试流程等内容封装成可重复调用的工作流。

简单理解：

Prompt只能解决一次问题，而Skill可以永久复用解决方案。

本文带大家深入了解Codex技能系统的工作原理与使用方法。

Codex客户端下载

官方中文教程站：

什么是Codex Skill

官方定义：

Skill 是一种可复用工作流格式。

一个Skill可以包含：

• 指令
• 参考资料
• 脚本
• 模板文件
• MCP工具依赖

然后统一打包给Codex使用。

例如：

前端开发Skill

包含：

• Vue开发规范
• Pinia状态管理规范
• Element Plus组件规范
• Git提交规范

当Codex调用该技能时：

创建一个用户管理页面

Codex会自动按照团队规范输出代码。

运维Skill

包含：

• Docker部署流程
• Nginx配置规范
• PM2启动命令
• 故障排查步骤

输入：

部署Node项目

Codex即可自动执行对应流程。

Skill与插件有什么区别

很多人容易混淆。

Skill

本质：

工作流

解决：

怎么做

Plugin

本质：

安装包

解决：

如何分发

关系如下：

Skill
 ↓
Plugin
 ↓
分享给其他开发者

推荐流程：

先开发Skill
↓
验证工作流
↓
再封装Plugin

Skill目录结构

一个标准技能目录如下：

my-skill/
├── SKILL.md
├── scripts/
├── references/
├── assets/
└── agents/
    └── openai.yaml

其中：

核心文件SKILL.md

这是整个技能的核心。

示例：

---
name: vue-developer
description: 用于Vue项目开发、组件创建、Pinia状态管理和Element Plus页面开发
---

创建代码时遵循以下规范：

1. 使用Composition API
2. 使用TypeScript
3. 优先使用Pinia
4. 使用Element Plus组件

参数说明

name

技能名称

name: vue-developer

用于：

$vue-developer

显式调用。

description

技能描述。

description: Vue3项目开发助手

Codex会根据描述自动判断：

什么时候调用这个技能

因此非常重要。

Codex如何加载Skill

很多人担心：

安装100个Skill会不会占满上下文？

实际上不会。

Codex采用：

按需加载

启动时仅加载：

技能名称
技能描述
技能路径

例如：

vue-developer
NodeJS-Deploy
DockerOps

只有真正被调用时：

$vue-developer

或者：

创建一个Vue3后台管理系统

Codex判断匹配成功后才会读取完整：

SKILL.md

因此上下文利用率非常高。

Skill触发机制

Codex支持两种触发方式。

方法1：显式调用

直接指定技能。

$vue-developer

或者：

$docker-deploy

CLI中：

/skills

即可选择技能。

方法2：隐式调用

根据description自动匹配。

例如：

帮我部署一个Node项目

Codex发现：

docker-deploy

描述最匹配。

自动触发。

创建Skill

官方推荐使用：

$skill-creator

创建向导。

执行：

$skill-creator

界面会询问：

这个技能干什么？

什么情况下触发？

是否需要脚本？

随后自动生成：

SKILL.md

结构。

手动创建Skill

创建目录：

my-skill

创建：

SKILL.md

内容：

---
name: code-review
description: 用于代码审查和质量检查
---

检查以下内容：

1. 代码规范
2. 性能问题
3. 安全风险
4. 可维护性

保存即可使用。

Skill存放位置

Codex支持多个层级。

仓库级

当前项目：

.agents/skills

例如：

project/
└── .agents/
    └── skills/

适合：

项目规范

用户级

全局目录：

~/.agents/skills

适合：

个人开发规范

管理员级

Linux：

/etc/codex/skills

适合：

企业统一配置

系统级

Codex内置技能：

skill-creator
planner

等。

安装官方精选Skill

Codex内置安装器：

$skill-installer

例如安装Linear技能：

$skill-installer linear

安装完成后：

自动加入技能列表

重启Codex即可使用。

禁用Skill

有些技能不想删除。

可以在：

~/.codex/config.toml

配置：

[[skills.config]]
path = "/path/to/skill/SKILL.md"
enabled = false

效果：

保留技能
但不加载

修改后：

重启Codex

生效。

openai.yaml高级配置

如果希望在Codex App中展示更丰富的信息。

可以增加：

agents/openai.yaml

示例：

interface:
  display_name: "Vue开发助手"

  short_description: "Vue项目开发规范"

  icon_small: "./assets/logo.svg"

  brand_color: "#3B82F6"

效果：

显示名称
显示图标
显示简介

更加友好。

MCP工具依赖

Skill还可以声明依赖。

例如：

dependencies:
  tools:
    - type: "mcp"
      value: "openaiDeveloperDocs"

表示：

该Skill依赖OpenAI文档MCP

使用时自动关联。

禁止自动触发Skill

默认：

allow_implicit_invocation: true

自动触发。

如果改成：

allow_implicit_invocation: false

则：

不会自动触发

只能：

$skill-name

显式调用。

实战案例：构建Vue开发技能

创建：

~/.agents/skills/vue3-helper

目录：

vue3-helper
└── SKILL.md

内容：

---
name: vue3-helper
description: Vue3、Pinia、Element Plus开发助手
---

要求：

1. 使用Vue3
2. 使用Composition API
3. 使用Pinia
4. 使用Element Plus
5. 使用TypeScript

之后直接输入：

创建一个用户管理页面

Codex便会自动按照规范生成代码。

Skill最佳实践

官方推荐：

一个Skill只做一件事

不要把：

Vue
Docker
Python
运维
测试

全部塞进一个技能。

优先使用纯指令

优先：

SKILL.md

而不是脚本。

这样：

• 更稳定
• 更容易维护
• 更容易迁移

描述写清触发条件

好的：

用于Vue3组件开发

差的：

开发助手

用真实场景测试

测试：

创建后台管理页面

是否正确触发。

总结

Codex Skills本质上是一个AI工作流封装系统。

相比传统Prompt，它具备：

• 可复用
• 可维护
• 可共享
• 可版本管理
• 支持脚本扩展
• 支持MCP集成
• 支持插件分发

对于个人开发者来说，可以沉淀自己的开发规范；对于团队来说，可以统一编码风格、部署流程和协作标准，让Codex真正成为团队级AI开发助手。

未来随着插件生态完善，Skill很可能会成为Codex最重要的能力之一。

相关阅读：

• Codex配置文件详解
• Codex高级配置教程
• Codex插件开发指南
• Codex MCP Server接入教程
• Codex Computer Use使用教程
• Codex Skills与Plugin区别详解

软件下载：

欢迎在评论区分享正在使用的Codex Skill方案，一起交流更高效的AI开发工作流。