OpenAI 秘密武器曝光!Codex Skills 深度拆解:让 AI 像专家一样进化的核心逻辑-夜雨聆风

OpenAI 秘密武器曝光!Codex Skills 深度拆解:让 AI 像专家一样进化的核心逻辑

PART 01

AI 进化的新拐点

在过去的两年里，我们习惯了通过不断调优 Prompt（提示词）来让 AI 完成任务。但这种方式存在明显的天花板：不稳定、难以复用、无法处理极其复杂的工作流。

近日，OpenAI 开发者文档中悄然更新了 Agent Skills（代理技能）的规范。这不仅仅是一个功能更新，它更像是在为未来的 AI 智能体建立一套“技能插件标准”。

简单来说，如果将大模型比作大脑，那么 Skills 就是大脑能够随时调用的“专家手册”和“工具箱”。

PART 02

什么是 OpenAI Skills？底层逻辑全拆解

OpenAI Skills 是一套标准化的文件夹结构和指令规范，它允许开发者为 Codex（OpenAI 的代码与逻辑增强模型）定义特定的能力。

核心定义

一个 Skill 是一个包含指令、资源和可选脚本的封装包。它解决的核心痛点是： “如何让 AI 能够可靠地、可重复地执行一套复杂的专业流程？”

“渐进式披露”机制（Progressive Disclosure）

这是 Skills 最精妙的设计之一。为了节省 Token 并提高处理效率，Codex 不会一开始就加载所有技能的全部内容。

初选阶段： Codex 只读取技能的（名称）和（描述）。

name

description

加载阶段：只有当用户的需求与描述高度匹配时，Codex 才会加载完整的指令。

SKILL.md

这种机制保证了即使你为 AI 装备了一百种技能，它依然能保持飞快的响应速度。

PART 03

拆解一个 Skill 的标准结构

一个标准的技能文件夹通常包含以下四个部分，这种高度结构化的设计是其专业性的保障。

1. SKILL.md (核心指令)

这是技能的灵魂。它必须包含元数据（名称、描述）和详细的操作指令。

元数据：告诉 Codex 什么时候该用这个技能，什么时候不该用。

指令：类似于 SOP（标准作业程序），规定了 AI 执行任务的每一个具体步骤。

2. scripts/ (执行脚本)

如果某些任务需要确定性的计算或外部工具调用（例如：调用 API、查询数据库），开发者可以在这里放置 Python 或 Bash 脚本。AI 会根据指令自动运行这些脚本。

3. references/ (参考文档)

这里存放的是该领域的专业文档、API 文档或技术规范。当 AI 需要更深层的背景知识时，可以随时查阅。

4. assets/ (静态资源)

包括图标、模板文件或预定义的 UI 组件。

PART 04

实战：如何从零创建一个 AI 技能？

OpenAI 为开发者提供了两种创建路径：

路径 A：交互式创建（推荐新手）

在 Codex 的终端中输入：

AI 助手会化身“导师”，通过询问你几个关键问题来生成技能：

这个技能是做什么的？

它在什么场景下被触发？

是否需要运行特定的脚本？

路径 B：手动创建（进阶版）

你需要手动创建一个文件夹，并编写文件。以下是一个标准的模板参考：

SKILL.md

PART 05

技能的存储与分发：它在哪里运行？

OpenAI 设计了一个非常严谨的技能搜索路径，这体现了对多层级协作的思考：

作用域 (Scope)	存放路径	适用场景
REPO (项目级)	`.agents/skills`	专门针对某个微服务或代码库的特定流程（如：自动部署脚本）。
USER (用户级)	`$HOME/.agents/skills`	用户个人的私人“绝招”，在任何项目中都可以调用。
ADMIN (管理员级)	`/etc/codex/skills`	企业级预设技能，供全公司员工共用。
SYSTEM (系统级)	Codex 内置	由 OpenAI 官方提供的基础技能（如：计划制定、技能安装）。

PART 06

核心亮点：隐式触发与显式调用

这是 Skills 区别于传统插件的另一个地方：

显式调用 ($ 符号)：你可以在对话中直接输入，强行命令 AI 使用这个技能。

$code-reviewer-pro

隐式触发 (AI 自行判断)：即使你只是说“帮我看看这段代码有没有漏洞”，Codex 也会通过匹配，发现最合适，从而自动加载并运行它。

description

code-reviewer-pro

这种“智能匹配”让 AI 变得越来越像一个经验丰富的老员工，他知道在什么时候该祭出哪套方案。

PART 07

最佳实践：如何写出 100 分的技能？

我总结了文档中的精髓，分享给各位开发者：

描述（Description）要写得极简且精准：明确告诉 AI “什么时候不该用这个技能”，可以大幅减少误触发。

偏好指令，而非脚本：除非需要非常确定性的操作，否则尽量用自然语言指令。因为 Codex 对逻辑的理解能力比直接运行脚本更具灵活性。

遵循 SOP 思路：每一个步骤都要有明确的输入和输出。

PART 08

行业影响：AI 智能体的新标准？

OpenAI 推出 Skills 标准，其野心显而易见：它想成为 AI 时代的“操作系统”。

对于开发者：你不再是写 Prompt，而是在编写“AI 软件”。

对于企业：企业的私有知识库（KB）可以封装成一个个 Skill，新员工入职只要安装了这些 Skill，就能获得“资深架构师”的加持。

对于生态：未来可能会出现“技能商店”，你可以一键下载顶级开发者封装好的“SEO 专家技能”、“深度研报技能”等。

PART 09

结尾：写在最后

OpenAI Skills 的出现，标志着我们正在从“调教 AI”转向“工程化 AI”。

当你拥有了第一个属于自己的 AI Skill，你就真正拥有了一个可以无限复制的数字化分身。未来的竞争，不再是比谁的 Prompt 写得好，而是比谁拥有的“技能库”更深厚。

仓库地址：https://github.com/openai/skills

如果让你给自己的 AI 智能体增加一个“必杀技”，你最希望它是什么？

自动处理报销流程

深度行业周报整理

24小时不间断的 Bug 巡检

欢迎在留言区聊聊你的想法！关注我，了解更多AI工具资讯

往期推荐

上交大出手！免费大模型教程爆火 GitHub，星标 30800+

Claude 使用全指南：从入门到精通，解锁 AI 助手的无限可能

微软开源 VibeVoice！让 AI 语音更有情感

救命！这套免费AI专家团队，覆盖全领域，开箱即用

星标 50k+！awesome-llm-apps：LLM 应用的 “百科全书”

星标 10k+！awesome-design-md：AI UI 设计的秘密武器