Codex Agent Skills

在 AI 智能体（Agent）日益普及的今天，如何让 AI 不仅“能聊天”，更能“懂业务”、“会干活”？答案在于技能（Skills）。

Codex Agent Skills 是一套专为 Codex 智能体设计的标准化能力封装方案。它将复杂的指令、脚本和资源打包成独立的文件夹，使 AI 能够发现并调用这些技能来执行特定任务。无论是代码审查、数据清洗，还是项目规划，一旦定义，即可在团队内无限复用，真正实现“一次编写，随处可用”。

什么是 Codex Agent Skills？

Skills 是 Codex 智能体的“插件”或“工具箱”。它们不仅仅是简单的 Prompt 提示词，而是包含以下要素的完整模块：

• 系统指令：定义智能体在特定场景下的行为准则。
• 执行脚本：可运行的代码片段，用于处理文件、调用 API 等。
• 资源文件：模板、配置文件或参考数据。

通过 Skills，团队可以将最佳实践固化下来，确保不同成员在使用 AI 时，都能获得一致、高质量的结果。

核心优势：标准化与可复用

• 能力封装：将复杂的任务逻辑隐藏在后端，用户只需触发技能名称，无需重复编写冗长的提示词。
• 团队协作：一个人开发的技能，全团队共享。新员工入职即可直接使用成熟的自动化工具。
• 持续进化：技能库可随业务需求不断迭代，实验性想法验证后可快速转为精选技能。

安装与管理指南

Codex 提供了灵活的机制来管理技能，分为自动安装、精选技能和实验性技能三类。

1. 自动安装（系统内置）

位于 .system 目录下的技能是 Codex 的核心能力，会自动安装在最新版本的 Codex 中，无需用户干预。这些通常是最基础、最通用的功能。

2. 安装精选技能（Curated Skills）

精选技能是经过验证、稳定可靠的高频工具，存储在 skills/.curated 路径下。

• 安装方式：在 Codex 内部使用 $skill-installer 命令，直接输入技能名称。
• 示例：

  $skill-installer gh-address-comments
  

  执行后，Codex 将自动下载并配置该技能，使其可用于处理 GitHub 评论等任务。

3. 安装实验性技能（Experimental Skills）

实验性技能包含前沿功能或尚未完全稳定的工具，存储在 skills/.experimental 或通过 GitHub 远程引用。

• 方式 A：本地指定文件夹

  $skill-installer install the create-plan skill from the .experimental folder
  

• 方式 B：远程 GitHub 目录
  你可以直接引用 GitHub 上的技能仓库目录，实现即时共享：

  $skill-installer install https://github.com/openai/skills/tree/main/skills/.experimental/create-plan
  

⚠️ 重要提示：安装任何新技能后，必须重启 Codex，以便系统重新加载并识别新能力。

应用场景示例

• GitHub 协作：使用 gh-address-comments 技能，自动分析 PR 评论并生成修复代码。
• 项目规划：调用 create-plan 技能，根据模糊的需求描述，自动生成详细的项目执行路线图。
• 数据清洗：自定义技能，一键格式化杂乱的 CSV 数据，统一日期格式和字段命名。
• 合规检查：部署团队专用的代码规范检查技能，确保所有提交符合内部标准。