使用说明：这份教程怎么读

不同基础的读者走不同路线，不用从头读到尾：

你的情况	建议路径	预计耗时
完全零基础，想尽快做出第一个 Skill	Part 0 → Part 2 → Part 7（照抄）→ 附录 C 清单	约 40 分钟
想真正理解原理、做出高质量 Skill	按顺序通读全文	约 2.5 小时
已写过 Skill，想优化触发率和质量	Part 3 → Part 6 → 附录 A 自查清单	约 30 分钟
想找现成案例直接改	Part 7 + Part 8（五个完整案例）	约 25 分钟
想了解进阶（版本管理/团队/安全/性能）	Part 10 + 附录 E/F	约 30 分钟

版本说明（2026 年 8 月更新版）：保留原有入门教程，并依据 OpenAI 官方 Codex 文档补充和修正 Skills 路径、自动安装、Skill Creator、Plugins、Goal/Plan、显式调用、隐式调用和安全边界。本文面向个人学习使用；平台界面和功能仍可能变化，涉及 Codex 的内容以 Part 11 和官方文档为准。

Part 0：先搞懂什么是 Skill

前因：你不知道 Skill 是什么，就无法理解后续操作的意义。这一部分用最简单的话让你快速建立认知。

0.1 你可能遇到过这个问题

场景一：你是一位老师，每次让 AI 帮你做教案，都要重复说：

"请按布鲁姆分类法设计教学目标，先认知层再应用层，每个层次至少 1 个目标，使用动词开头，符合 SMART 原则……"

场景二：你是一位行政，每周整理会议纪要，都要交代：

"按会议信息、讨论要点、决议事项、行动项四段整理，行动项要带负责人和截止时间，用表格，别写空话……"

场景三：你是一位程序员，每次提交代码都让 AI 帮写 commit message，都要强调：

"用 conventional commits 规范，类型在前，描述不超过 50 字，关联 issue 号……"

三个场景的痛点一模一样：重复劳动、容易遗漏、无法复用。每次都要从头说明要求，不仅浪费时间，还容易漏掉关键步骤。

0.2 Skill 怎么解决这个问题

Skill 的定义：把专业知识和工作流程封装成一个文件夹（一个 SKILL.md 文件 + 可选的脚本/资源），AI 在需要时自动识别并使用。

类比：Skill 就像给 AI 安装一个"专业 APP"——一次编写，永久复用。你不需要每次都从头教 AI 怎么做，只需说一句"帮我写教学目标"，AI 就会自动加载你的规范并按照执行。

Skill 能解决 / 不能解决什么：

能解决	不能解决
把"重复说的工作规范"固化下来自动加载	一次性的、再也不会做的任务
让输出格式每次都一致	需要 AI 实时联网查最新数据（那是 MCP 的活）
把领域专业知识喂给 AI	替代 AI 本身的推理能力
团队共享统一标准	修复 AI 模型本身的 bug

记住这条边界：Skill 是"知识封装层"，不是"工具连接层"（那是 MCP），也不是"模型能力层"。

0.3 一个真实 Skill 长什么样

下面是一个真实教育类 Skill 的完整 SKILL.md，用注释标注每部分作用：

---                                     # ← YAML 前置元数据区域开始

name: bloom-objective-generator         # ← Skill 的唯一标识（小写+连字符）

description: 根据布鲁姆分类法生成教学目标。  # ← 灵魂字段：AI 靠它判断是否激活

  当用户需要编写课程目标、教案目标时触发。

---                                     # ← 前置元数据结束

# 布鲁姆分类法教学目标生成器              # ← 正文指令（Body）开始

## 角色定义                              # ← 告诉 AI 它是谁

你是一位经验丰富的教学设计专家。

## 执行流程                              # ← 分步骤告诉 AI 怎么做

步骤1：确定教学主题和学习者水平

步骤2：按布鲁姆6个层次生成目标

步骤3：为每个目标提供活动建议

## 示例                                  # ← 输入输出示例

输入：数学课 / 初中 / 二次函数

输出：认知层目标 + 理解层目标 + 应用层目标……

整个 Skill 就是上面这些。入门真的只需要这么多——一个文件、几行字。

0.4 Skill 和 Prompt / MCP / Rules 有什么区别

理解四者的区别，能帮你知道什么时候该用 Skill：

对比项	Prompt（提示词）	Rules（规则）	Skill（技能）	MCP（工具连接器）
本质	临时对话指令	全局常驻偏好	可复用的领域知识包	外部工具/服务连接器
持久性	单次对话有效	跨对话常驻	跨对话持久可用	持久连接
加载方式	手动输入	启动即全量加载	匹配时才加载	按需调用
占上下文	用完即弃	始终占用	仅触发时占用	调用时占用
适合场景	一次性任务	轻量偏好（代码风格、语言）	反复使用的专项工作流	接入外部数据/服务

一句话总结：Prompt 是"临时便签"，用完即弃；Rules 是"墙上贴的便条"，一直占地方；Skill 是"书架上的专业手册"，要用才取；MCP（Model Context Protocol，模型上下文协议）是"外部插座"，负责连接其他服务。Trae 官方建议：Rules 文件臃肿时，把工作流类指令迁到 Skill 里——Skill 按需加载，能省上下文。

0.5 Agent Skills 开放标准简介

Agent Skills 是 Anthropic 发起的开放标准，任何 AI 平台都可采用。关键时间线：

日期	事件	含义
2025-10-16	Anthropic 正式发布 Agent Skills	同周上线 Claude.ai、Claude API、Claude Code
2025-12-18	发布为开放标准（agentskills.io）	不再绑定 Claude，任何平台可采用
2025-12 下旬	48 小时内微软/OpenAI/GitHub 跟进	从产品功能升级为行业标准
2026-01	社区技能 20 天内从约 2 千增长到约 4 万	生态爆发
2026 年中	各平台支持范围、仓库数量和 Star 数会变化；不要把数量和平台列表当作永久事实，请以对应平台官方文档和仓库为准。	基础格式已被多个平台采用，但路径、工具和插件能力并不完全兼容。

基础 SKILL.md 结构可以在部分平台之间复用，但实际路径、触发机制、脚本权限、MCP 配置和插件能力必须按平台验证。

0.6 想直接用现成的？官方和社区已有海量技能

学"怎么写"之前先知道一个事实：很多常见需求已经有人写好了，可直接安装：

资源	内容	怎么用
anthropics/skills（官方仓库）	18 个官方技能：PDF 处理、Word/Excel/PPT 生成、前端设计、skill-creator 等	克隆到对应平台 skills 目录
obra/superpowers	14 个开发方法论技能（TDD、系统调试等），11 万+ Star	同上
社区技能市场	数万个社区技能（写作、开发、办公、设计）	搜索后下载复制
skills CLI 工具	一行命令安装技能集	$skill-installer linear（Codex 当前内置安装入口；第三方 skills CLI 仅作为其他平台的替代方案）

建议：先装几个官方技能用一用，感受"好 Skill 长什么样"，再动手写自己的——这是最快的学习路径。