OpenAI Codex 技能指南 2026：构建可重用的 AI 工作流

AI Perks

AI Perks 提供 AI 工具、云服务和 API 的独家折扣、积分和优惠，帮助初创企业和开发者节省开支。

查看所有 AI Perks

什么是 OpenAI Codex 技能？

Codex 技能是可重用的工作流包，它们通过特定于任务的功能来扩展 OpenAI Codex。 技能打包了指令、脚本和引用，以便 Codex 每次都以相同的方式执行重复性任务。作为一项实验性功能于 2025 年 12 月推出，技能可在 Codex CLI、IDE 扩展和 Web 应用程序之间使用。

如果您正在使用 Codex 构建代理工作流，技能可以消除提示漂移并使 Codex 的行为具有可预测性。如果您想在不直接向 OpenAI 付费的情况下为 Codex 提供支持，AI Perks 通过大多数开发人员不知道存在的计划提供价值 500 美元至 50,000 美元以上的免费 OpenAI API 积分。

在AI积分上节省您的预算

搜索优惠

OpenAI,

Anthropic,

Lovable,

Notion

Changelog

全部免费合作关系

搜索优惠

OpenAI,

Anthropic,

Lovable,

Notion

Changelog

全部免费合作关系

Software	预估积分	条件	审批指数	操作

推广您的 SaaS

覆盖全球 90,000+ 寻找类似您工具的创始人

立即申请

Codex 技能实际做什么

技能解决了 AI 编码代理的三个痛点：

技能本质上是“代理宏”——您定义一次工作流，然后在需要时调用它。Codex 会严格遵循技能的指令，而不是即兴发挥。

AI Perks

AI Perks 提供 AI 工具、云服务和 API 的独家折扣、积分和优惠，帮助初创企业和开发者节省开支。

查看所有 AI Perks

如何创建 Codex 技能

技能是一个包含 SKILL.md 文件以及可选脚本和参考文档的目录。

最低技能结构

my-skill/
├── SKILL.md       # 必需：指令和元数据
├── scripts/       # 可选：辅助脚本
│   └── helper.sh
└── references/    # 可选：文档、示例
    └── docs.md

SKILL.md 格式

---
name: deploy-to-staging
description: Deploys the current branch to staging environment with health checks
---

## 何时使用此技能

当用户要求部署代码到暂存环境、推送到暂存环境或在暂存环境中测试某个分支时使用。

## 步骤

1. 运行 `git status` 以验证工作树是否干净
2. 使用 `npm run build` 构建项目
3. 使用 `git push origin HEAD:staging` 推送到暂存分支
4. 使用 `./scripts/deploy.sh` 触发暂存部署
5. 等待健康检查返回 200
6. 向用户报告部署 URL

## 输入

- 当前分支名称（自动检测）
- 可选：功能标志覆盖

## 输出

- 部署 URL
- 健康检查状态
- 任何部署错误

必需的前置字段

描述是关键——Codex 使用它来决定是否自动调用该技能。

如何调用 Codex 技能

有两种调用方法：

显式调用

使用 $ 前缀键入技能名称：

$.deploy-to-staging

或浏览所有可用技能：

/skills

这将强制 Codex 使用指定的技能，无论提示如何。

隐式调用

当您给 Codex 提供一个与技能描述匹配的自然语言提示时，Codex 会自动选择它：

您：“将此分支部署到暂存环境”
Codex：[检测到 deploy-to-staging 技能匹配 → 调用它]

之所以有效，是因为 Codex 的渐进式披露首先加载技能名称和描述，然后在选择相关技能时才加载完整的 SKILL.md。

Codex 技能最佳实践

1. 保持每个技能只专注于一项任务

一项做太多事情的技能会变得不可预测。将复杂的工作流拆分成多个更小的技能。

差：

name: full-release-pipeline
description: Builds, tests, deploys, monitors, and notifies for releases

好：

name: build-and-test
description: Builds the project and runs the test suite

name: deploy-to-staging
description: Deploys to staging after build/test passes

name: notify-team
description: Sends deploy notifications to Slack

2. 从 2-3 个具体用例开始

根据您实际重复执行的工作流编写技能。不要为假设的场景创建技能。

常见的入门技能：

• deploy-to-staging
• run-database-migration
• generate-pr-description
• update-changelog
• create-feature-branch

3. 定义清晰的输入和输出

准确说明技能需要什么以及它产生什么：

## Inputs
- target-environment: "staging" or "production"
- skip-tests: optional boolean (default: false)

## Outputs
- deploy-url
- deploy-duration-seconds
- error-message (if failed)

4. 编写与用户语言相匹配的描述

描述决定了 Codex 何时自动调用技能。使用开发人员实际使用的词语。

差：

description: Initiates CI/CD orchestration with branch promotion

好：

description: Deploys current branch to staging - use when user says "deploy", "push to staging", or "test on staging"

Codex 技能为何收费（以及如何使其免费）

每次调用 Codex 技能都会像任何其他 Codex 提示一样消耗 OpenAI API 令牌。技能并不能降低每次调用的成本——它们只是使工作流保持一致。

典型 Codex 技能成本

一个团队每天每位开发人员调用 20 次技能，仅在 Codex 技能执行方面每月就花费每位开发人员 50-200 美元。

AI Perks 提供免费 OpenAI 积分，可以完全覆盖此成本。

获取免费 OpenAI 积分以支持 Codex 技能

总计潜力：4,000 美元至 206,000 美元以上的免费积分

以每月 50 美元/开发人员的技能成本计算，即使是 5,000 美元的积分赠款，也可以为一个开发人员提供8 年以上的 Codex 技能使用，或者为一个 8 人团队提供 1 年的使用。

Codex 技能 vs 自定义函数 vs 工具

技能是编码重复开发者工作流的最灵活选项。函数更简单但功能较弱。工具用于外部集成。

分步：构建你的第一个 Codex 技能

步骤 1：获取免费 OpenAI 积分

订阅 AI Perks 以访问免费的 OpenAI 积分计划。这将零成本地为您的 Codex 技能使用提供资金。

步骤 2：识别重复性工作流

选择一个您每周至少执行一次的任务。常见的候选者：

• 部署到暂存环境
• 运行数据库迁移
• 根据提交生成 PR 描述
• 根据提交更新更改日志
• 运行安全扫描

步骤 3：创建技能目录

mkdir -p ~/.codex/skills/my-skill
cd ~/.codex/skills/my-skill

步骤 4：编写 SKILL.md

使用之前的模板。具体说明步骤、输入和输出。

步骤 5：测试技能

在 Codex CLI 中，运行：

$.my-skill

迭代 SKILL.md，直到 Codex 能够一致地执行工作流。

步骤 6：与团队共享

将您的 ~/.codex/skills/ 文件夹（或其子集）提交到 git。团队成员可以克隆并即时访问您的技能。

常见问题解答

Codex 技能与普通提示有什么区别？

技能是版本化的、可重用的工作流包；提示是一次性指令。技能确保在运行和团队成员之间的一致性。对您重复执行的任何任务都使用技能。通过 AI Perks 提供的免费 OpenAI 积分可以覆盖技能执行的 API 成本。

Codex 技能可以在 IDE 和 CLI 中使用吗？

是的。 技能是版本控制的、可跨团队共享的，并且可以在所有 Codex 表面上使用——Codex CLI、IDE 扩展（VS Code、JetBrains）和 Codex Web 应用程序。相同的 SKILL.md 在所有地方都可以工作。

Codex 技能需要额外付费吗？

不，技能可以免费创建和存储。 它们在调用时会消耗普通的 OpenAI API 令牌，就像任何其他 Codex 提示一样。要消除该成本，请使用 AI Perks 提供的价值 500 美元至 50,000 美元以上的免费 OpenAI 积分。

如何与我的团队共享 Codex 技能？

将您的技能目录提交到 git。 大多数团队维护一个共享的技能存储库（例如 team-skills/），所有开发人员都可以克隆并链接到他们的 ~/.codex/skills/ 文件夹。技能将成为您工程工具的一部分。

Codex 技能可以包含 shell 脚本吗？

是的。 技能目录可以包含 shell 脚本、Python 辅助脚本、参考文档或任何其他文件。SKILL.md 指令可以在工作流中引用这些文件并调用它们。

Codex 技能在 2026 年可用吗？

是的，Codex 技能作为一项实验性功能于 2025 年 12 月推出，并在 2026 年继续可用。该功能正在积极开发中——请查看 官方 Codex 更新日志 以获取更新。

学习 Codex 技能的最佳方法是什么？

从为您最重复的工作流创建一个技能开始（例如，“部署到暂存环境”）。根据 Codex 的行为进行迭代。然后扩展到 5-10 个核心团队工作流。通过 AI Perks 提供的免费 OpenAI 积分，您可以进行实验，而不必担心令牌成本。

以零 API 成本构建 Codex 技能

Codex 技能使 AI 编码代理具有可预测性和可共享性——但每次技能调用都会消耗 OpenAI 令牌。AI Perks 消除了该成本：

• 500 美元至 50,000 美元以上的免费 OpenAI 积分
• 堆叠策略可获得超过 100,000 美元的组合积分
• 除了 AI 积分之外，还有 200 多项额外的初创企业福利
• 每月更新的计划

在 getaiperks.com 订阅 →

Codex 技能非常强大。通过 getaiperks.com 的积分使其免费。