整理时间：2026-10-12
核心标签：#Codex #AgentSkills #AI编程 #效率工具
资料来源
- [S1] 视频：《Codex Skill 到底是什么？10分钟入门使用、安装、自建》，Bilibili。
- [S2] 官方文档：Build skills（OpenAI），
本篇速览
- Skill 是把一类任务的规则、流程与可选资源封装起来的可复用能力，不是单纯的一段提示词，也不等同于模型本身。[S2]
- 使用 Skill 的基本闭环是：发现或编写 → 安装到合适范围 → 由描述匹配或显式调用 → 根据真实任务迭代。
- 实战示例覆盖 Codex 技能列表、查看/启用技能、skills.sh 搜索和安装、调用
find-skills、通过skill-creator自建技能。
一、Skill 是什么，适合解决什么问题
可以把 Skill 理解为“面向某类工作的操作手册”。它把原本每次都要重复写给模型的背景、步骤、约束和检查方式，整理成可复用目录；当任务匹配时，Codex 可读取这些说明并按流程工作。
官方格式中，Skill 至少包含带name和description的SKILL.md，也可以附带脚本、参考资料和模板等资源。[S2] 因此它的价值不在于“提示词更长”，而在于把可靠的任务流程做成可以复用、维护和分发的单元。
Skill、MCP 与插件的区别
| 组件 | 主要职责 | 直观理解 |
|---|---|---|
| Skill | 描述何时做、按什么步骤做、如何处理结果 | 工作方法和流程 |
| MCP / 工具 | 提供模型可调用的外部数据或操作能力 | 工具和数据接口 |
| 插件 | 可打包并分发 Skills、连接器等 | 可安装的能力包 |
一个 Skill 可以指导 Codex 如何组合工具，但它本身不自动等于一个新工具或权限。权限和工具可用性仍受当前产品、配置和授权范围控制。
二、Skill 如何被发现和使用
Codex 可通过两种方式启用 Skill：
显式调用：在支持的界面里使用
$选择 Skill，或在技能选择器中挑选后说明任务。之后的截图会演示先输入$、选择find-skills，再描述需求的方式。隐式匹配：系统依据 Skill 的
description判断当前请求是否符合其适用范围。因此描述应清楚写明任务边界和触发场景，避免过宽或含糊。
Skill 使用渐进式披露：启动时先呈现名称和描述；任务需要时再读取完整SKILL.md，并按需使用目录中的其他资源。这有助于避免每轮都把全部说明塞进上下文。
三、查找、安装和启用现有 Skill
1. 在 Codex 界面检查已安装技能并进行试用
- 操作路径：进入侧边栏的“自定义”区域 — 选择“技能”— 查看已安装列表 — 打开单个 Skill
- 可检查完整说明，也可以在界面中启用/停用或卸载。
- 不同版本的 Codex UI 可能略有差异。
2. 从社区目录发现候选技能
skills.sh 的搜索/排行榜：排行榜和安装量只能作为发现线索，并不代表安全或适合当前项目。安装前应审查来源仓库、SKILL.md、脚本内容和所需权限。
示例的安装命令如下：
npx skillsaddhttps://github.com/vercel-labs/skills--skillfind-skills命令形式可能随skillsCLI 更新而变化；执行前请以技能页面当前给出的安装命令为准。不要把来源不明的脚本直接安装到常用环境。
3. 使用 Skill Installer 安装
通过 Codex 自带的$skill-installer，把skills.sh页面地址交给安装器；安装器检查来源后，将find-skills安装到本机用户技能目录。官方文档也说明可以用内置$skill-installer安装精选 Skill 或其他仓库中的 Skill；新安装技能通常可自动发现，如未出现可重启 Codex。
安装范围要看目标位置：用户级技能适用于个人多个项目；仓库级技能可与项目一起维护和共享。避免误把只适用于个人的工作流提交进仓库，或把含项目机密的内容放入可分享技能中。
4. 调用已安装的 Skill
安装后，在对话输入$并选择目标技能，再清晰描述任务、输入材料和期望输出。例如截图中使用find-skills搜索前端设计相关技能，并让它用中文汇总候选项。
显式调用时仍要给出具体目标；Skill 提供流程，不会替代用户对本次任务的需求描述。
四、从零创建自己的 Skill
1. 先定义边界和验收标准
在创建前，先回答四个问题：
- 它解决哪一类重复任务？
- 何时应该触发，何时不应该触发？
- 需要哪些输入，必须产出什么？
- 哪些步骤或结论不能猜测，如何验证结果？
例如本文使用的study-notes-distiller，任务边界是把学习截图、视频/文章来源和随记整理为结构化中文 Markdown；它还明确要求保留图片、来源和不确定项。
2. 用skill-creator起草
截图演示在 Codex 中显式调用$skill-creator，给出新技能名称及完整要求，然后检查生成计划和文件（图 09）。创建器的价值是规范化结构和检查流程；生成后仍需要人工核对内容是否完整、准确、边界是否明确。
3. 最小目录结构
my-skill/ ├── SKILL.md # 必需：名称、描述和工作指令 ├── scripts/ # 可选：需要确定性执行时放脚本 ├── references/ # 可选：较长的背景资料 └── assets/ # 可选：模板、示例及其他资源一个最小的SKILL.md示例：
--- name: study-notes description: 将技术学习材料整理成中文 Markdown 笔记；适用于用户提供截图、教程链接或随记并要求归纳时。 --- # 学习笔记整理 1. 按文件名顺序检查输入截图，不遗漏重点标注。 2. 只总结可读取到的资料；无法访问的来源明确说明。 3. 按核心概念、实操步骤、注意事项组织内容。 4. 对不确定的文字和结论标记“待确认”，不猜测补全。 5. 输出可发布的中文 Markdown，并核对链接和附件路径。官方文档强调name与description是必要元数据；描述应具体、简洁、边界清楚。技能应聚焦一个工作，指令使用明确的动作和输入输出要求。
4. 选择合适的安装/分发范围
| 目标 | 建议位置/方式 | 适用场景 |
|---|---|---|
| 个人本机复用 | 用户级 Skills 目录或安装器 | 多个项目共用的个人工作流 |
| 项目团队共用 | 仓库中的.agents/skills/ | 与代码项目一起版本管理 |
| 面向更多人分发 | 打包为插件 | 需要统一分发一个或多个 Skill，或配套连接器 |
Codex 的本地发现路径包括仓库级.agents/skills、用户级$HOME/.agents/skills、管理员级和内置系统级位置；官方还指出可通过插件分发可复用技能。 路径和功能会因运行环境而异，Windows 用户应以当前 Codex 版本和官方文档列出的路径为准。
5. 验证与迭代
创建成功不代表技能质量已经达标。至少检查：
SKILL.md是否存在，frontmatter 是否含name和description；- 技能是否会在预期任务触发，而不会被无关请求误触发；
- 操作步骤是否可执行，输出格式是否能复现；
- 路径、命令、脚本及示例是否真实有效；
- 失败、权限和不确定情形是否有明确处理方式。
五、使用与维护中的注意事项
- 先看内容，再安装：Skill 文件属于可执行工作指令；若含脚本，更要审查具体行为、网络访问、文件操作和凭据处理。
- 不要只看热度：安装量、Stars 或排行榜无法证明代码安全、内容准确，也无法保证适配你的环境。
- 描述决定可发现性：写清楚目标任务、触发条件和边界，避免“处理所有事情”这类宽泛描述。
- 用户级与仓库级不要混淆：按复用范围选择位置，确认是否要将技能随项目提交和共享。
- 禁用与卸载是不同操作：禁用通常是保留文件但暂不使用；卸载会移除技能。截图显示了两类管理入口（图 01、图 02），具体行为以当前 UI 提示为准。
- 版本差异要复核：UI、CLI 命令和发现路径可能演进；社区技能的安装说明尤其应以来源页面当前版本为准。
六、总结
Codex Skill 的核心是把可重复的任务流程变成结构化、可发现、可维护的能力。入门时先安装并实际调用一个成熟 Skill，理解它如何通过SKILL.md约束工作；随后选择一个边界清晰的重复任务，用skill-creator起草，通过真实任务测试，再根据失败案例迭代。
一句话记忆：Skill 负责告诉模型“这类事应该怎么做”，工具负责提供“能做什么”，插件则可以把能力组织起来分发。
