# Codex Skill 与插件

> Codex 的 Skill（固定工作方法）与插件（能力包）——概念辨析、创建使用与常见能力方向。

URL: https://docs.passion8.cc/docs/codex/skills
Language: zh-CN
Publisher: Passion8

Codex 有三个经常被混淆的概念：**插件**、**Skill** 和 **MCP**。下面先把三者说清楚，再分别介绍 Skill 和插件的用法。

## 三者关系

| | 一句话 | 解决什么 | 范围 | 类比 | 典型例子 |
|---|---|---|---|---|---|
| **插件** | 能力安装包 | 一键打包、分发能力 | 最大，可打包 Skill + MCP | 工具箱 | GitHub 插件、Figma 插件 |
| **Skill** | 固定工作方法 | 同类任务「怎么做」 | 单类任务流程 | 工具箱说明书 | README Skill、代码 Review Skill |
| **MCP** | 外部工具接口 | 「连什么工具 / 数据」 | 单个外部工具连接 | 工具箱的电源插座 | 数据库 MCP、文档 MCP |




插件可以把 Skill 和 MCP 打包成更易安装的能力包；Skill 管「怎么做」，MCP 管「连什么工具」。




---

## Skill

### 是什么

Skill 是给 Codex 预定义的一套工作流程。把常见任务（写 README、代码 Review、生成网页……）固化成 Skill，以后调用时直接按流程执行，不必每次重新解释规则。

**什么时候做成 Skill？**

- 同类任务经常重复，每次都要写一堆规则
- 想让输出更稳定，或团队多人共用同一套流程

**不适合的情形：** 一次性小任务、临时改文案、只是问个概念。

### 和普通提示词的区别

| | 普通提示词 | Skill |
|---|---|---|
| 输入方式 | 每次手动写 | 保存后直接调用 |
| 稳定性 | 易漏要求 | 流程固定，输出更一致 |
| 适合 | 临时任务 | 重复任务 |
| 复用性 | 低 | 高 |
| 可包含 | 文字描述 | 指令 + 模板 + 资料 + 脚本 |

### SKILL.md 最简结构

一个 Skill 至少需要一个 `SKILL.md`，frontmatter 写 `name` 和 `description`，正文描述工作流程：

```markdown title=".agents/skills/readme-skill/SKILL.md"
---
name: readme-skill
description: 当用户需要生成 README、项目说明、安装教程、启动步骤时使用。
---

你是一个 README 文档生成助手。

任务：根据当前项目生成适合新手阅读的 README。

工作流程：
1. 阅读项目结构
2. 查看 package.json / 入口文件
3. 判断项目类型
4. 生成项目介绍、安装步骤、启动命令、文件结构说明、常见问题
5. 不确定的内容不要编造

输出格式：Markdown
```




`description` 决定 Codex 何时自动触发这个 Skill，要写清楚触发场景，例如「当用户需要……时使用」，而不是含糊的「帮我写东西」。




完整目录结构（`scripts/`、`references/`、`assets/` 均可选）：

```
.agents/skills/
└── readme-skill/
    ├── SKILL.md          ← 必须
    ├── scripts/          ← 可选，自动化脚本
    ├── references/       ← 可选，参考资料 / 模板
    └── assets/           ← 可选，示例文件
```

### 创建与使用 Skill






### 桌面 App


**使用已有 Skill：** 打开插件页，已安装插件里的 Skill 会列出可用技能。

**创建新 Skill：**







### 新建 thread

在 App 里新建一个对话 thread。






### 调用 $skill-creator

输入 `$skill-creator`，这是内置的 Skill 创建助手。






### 描述需求

告诉它：用途是什么、何时触发、有哪些规则、期望的输出示例。






### 检查生成结果

确认生成的 SKILL.md 符合预期后保存即可使用。






![Codex App 中的 Skill](https://docs.passion8.cc/images/codex/image-046-d0b772835b.png)





### CLI


进入项目目录后运行 `codex`，有三种方式管理 Skill：

**① 查看并调用已有 Skill**

```bash
# 输入 /skills 或 $ 查看当前可用的 Skill 列表
/skills

# 按名字调用
$readme-skill
```

**② 用 $skill-creator 创建（推荐）**

```text
$skill-creator
```

同 App 的流程，告诉它触发场景和规则，它会帮你生成完整的 SKILL.md。

**③ 手动创建**

直接在项目里新建目录和文件，按上方结构编写 SKILL.md。








### Skill 放在哪里

| 位置 | 路径 | 适合 |
|---|---|---|
| 项目专属 | `<项目根>/.agents/skills/` | 只对本项目生效 |
| 用户级 | `~/.codex/skills/`（或同类用户目录） | 个人在所有项目通用 |
| 团队共享 | 团队 / 管理员统一下发 | 统一团队工作流 |
| 插件内 | 随插件打包 | 一键分发给他人 |

---

## 插件

### 是什么

插件是给 Codex 额外安装的「能力包」，可以让它连接更多外部工具、获得专项能力，或者把若干 Skill 和 MCP 打包成一个易于分发的单元。

### 安装与管理






### 桌面 App








### 打开插件页

在 App 侧栏找到插件 / Plugins 入口，搜索或浏览可用插件。






### 安装

点击目标插件 → 查看详情 → **Add to Codex**。






### 使用

新开一个 thread，插件能力即在当前会话中生效。



![Codex App 插件市场](https://docs.passion8.cc/images/codex/image-041-2ec5f4e518.png)








### CLI


进入项目目录后运行 `codex`，输入 `/plugins` 进入插件管理界面：

```text
/plugins
```

界面内可以搜索、查看详情、Install / Uninstall，以及用 `Space` 键启用或停用某个插件。








### 常见能力方向

| 方向 | 代表插件 |
|---|---|
| 浏览器与电脑操作 | Chrome、Computer Use |
| 代码与项目协作 | GitHub |
| 前端与设计 | Build Web Apps、Figma |
| 办公交付 | Documents、Presentations、Spreadsheets |
| 视频生成 | HyperFrames、Remotion |




以上列表以插件页当前上架内容为准，实际可用插件会持续更新。




---

## 接着看



- [CLI 配置](https://docs.passion8.cc/docs/codex/config): 接入 Passion8：认证文件与 config.toml。
- [桌面 App](https://docs.passion8.cc/docs/codex/app): 图形界面版 Codex 的接入与玩法。
- [高阶玩法](https://docs.passion8.cc/docs/codex/tips): AGENTS.md、MCP、Profile 与审批沙箱进阶。