
如果你正在使用 **Codex CLI**，却发现自己一遍又一遍地重复编写相同的指令，那么你很可能没有充分发挥这个工具的潜力。Codex 提供了一项强大的功能——**Skills（技能）**，它允许你将可复用的工作流打包封装，并按需赋予 AI 代理新的能力。本文将带你全面了解 Codex Skills 的原理、结构和使用方法。

## 什么是 Codex Skills？

**Codex Skill** 是一个封装了可复用工作流的文件夹。你只需将常用指令写入一次，保存在 Skill 中，之后每次调用即可自动执行，无需重复输入。

Skills 的核心价值在于：
- **扩展 Codex 的能力**：为 AI 代理注入特定领域的专业知识。
- **提升效率**：避免重复劳动，节省时间。
- **保持上下文干净**：只在需要时加载相关内容，减少 token 消耗。

## Skills 如何工作？——渐进式披露（Progressive Disclosure）

Codex Skills 采用一种称为 **渐进式披露（Progressive Disclosure）** 的机制，以优化性能和资源使用：

- **启动阶段（Startup）**：Codex 仅加载所有技能的名称和描述。
- **按需加载（On Demand）**：当你请求某个技能时，Codex 才会完整加载其 `SKILL.md` 文件。
- **高效运行（Efficient）**：仅在实际使用时消耗 tokens，保持上下文简洁、响应迅速。

## 技能的存储位置（Skill Scopes）

Skills 可以存放在多个层级，适用于不同范围的使用场景：

| 范围 | 说明 |
|------|------|
| **系统级（System Level）** | Codex 内置的默认技能 |
| **全局级（Global Level）** | 对所有项目生效 |
| **用户级（User Level）** | 仅对当前用户可用 |
| **仓库级（Repository Level）** | 仅限于当前项目目录 |

这种分层设计让你可以灵活管理技能的可见性和复用性。

## 如何安装现有技能？

在安装或创建技能前，请确保你的 **Codex CLI 已更新至最新版本**。旧版本可能不支持 `Skill Creator` 或 `Skill Installer` 功能。

### 安装步骤：

1. 在终端中启动 Codex。
2. 输入 `$`。
3. 选择 **Skill Installer**。
4. 输入技能名称，或粘贴 GitHub 仓库 URL。
5. Codex 将自动完成安装。
6. **重启 Codex**。
7. 再次输入 `$`，即可看到新安装的技能。

> 💡 提示：安装完成后务必重启 Codex，否则新技能不会生效。

## 如何创建自定义技能？

Codex 提供两种创建技能的方式：

### 方法 A：使用 CLI 创建器（Skill Creator）

1. 启动 Codex，输入 `$`。
2. 选择 **Skill Creator**。
3. 输入技能名称。
4. 输入主指令（instruction）。
5. Codex 会通过交互式问答帮你完善技能结构。

> ⚠️ 注意：如果生成的技能未保存在 `.codex/skills/` 目录下，你需要手动安装（参考上一节“安装现有技能”的流程）。

### 方法 B：手动创建（推荐）

手动创建能让你完全掌控技能结构，适合高级用户。一个标准的 Skill 目录结构如下：

```
my-skill/
├── skill.md          # 必需：主指令文件
├── scripts/          # 可选：用于执行逻辑的脚本（如 Python、Shell）
├── references/       # 可选：参考文档、模板等
└── assets/           # 可选：图片、配置文件等资源
```

#### `skill.md` 模板示例：
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-11859176/904f97bbcae3c7f8854d32b77d38d9c6.png)
如果觉得自己写的skill不好，请遵循以下指南：

一技一能。每个技能应专注于单一任务。  
零上下文假设。技能不应依赖之前的消息，必须自成一体。  
优化描述。若技能未被触发，需调整其描述和示例。  
优先使用指令而非脚本。在复杂代码脚本前，优先采用文本说明。
## 结语

Codex Skills 是提升开发效率、实现提示工程自动化的关键工具。通过封装常用工作流，你不仅能减少重复劳动，还能构建可共享、可维护的 AI 工作单元。无论是安装社区技能，还是创建自己的专属技能，Codex 都为你提供了灵活而强大的支持。

立即升级你的 Codex CLI，开始构建你的第一个 Skill 吧！

---


如果你正在使用 Codex CLI，却发现自己一遍又一遍地重复编写相同的指令，那么你很可能没有充分发挥这个工具的潜力。Codex 提供了一项强大的功能——Skills（技能），它允许你将可复用的工作流打包封装，并按需赋予 AI 代理新的能力。本文将带你全面了解 Codex Skills 的原理、结构和使用方法。

Codex Skill详解：自动化提示词

人工智能

开发工具

CodexSkills是提升开发效率的AI工具，可将重复工作流封装为可复用技能。支持按需加载、分层管理，通过渐进式披露机制优化性能。本文详解技能原理、安装方法及创建技巧，助你实现提示工程自动化，减少重复劳动，构建可共享的AI工作单元。

Python

GitHub

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Codex Skill详解：自动化提示词-腾讯云开发者社区-腾讯云

Codex Skill详解：自动化提示词

Codex Skill详解：自动化提示词

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐