CODEX 指南 · SKILL 上下文

Codex Skills 装多少个合适?上下文预算与精简组合

官方没有“最多安装 N 个 Skill”的规定。真正需要理解的是 Codex 初始发现列表的预算,而不是误以为每个已安装的 SKILL.md 都会进入每次对话。

发布于 原创 · 来源感知
01

文档中的上下文预算具体限制什么?

Codex 会先读取一个精简的 Skill 列表,其中包含名称、描述和文件路径。OpenAI 文档说明,默认预算最多为模型上下文窗口的 2%;如果上下文窗口未知,列表最多 8,000 个字符。这两种单位不同,不要把 8,000 个字符误读成 8,000 个 token。

已安装 Skill 较多时,Codex 会先缩短描述;集合很大时,初始列表可能省略部分 Skill 并显示警告。这是发现列表的预算,并不是已安装 Skill 数量的公开上限。

02

已安装、可发现、被选中,是三个不同阶段

安装 Skill 是把它的文件夹放进 Codex 支持的位置。Codex 会先根据 Skill 元数据判断是否相关;选中某个 Skill 后,再读取该 Skill 完整的 SKILL.md 指令。被选中的指令会影响当前任务的上下文和行为,但不会因为文件夹存在,就自动把所有 Skill 的完整内容都加载进每次对话。

你可以通过 /skills 查看并显式选择,也可以在任务中用 $skill-name 指定。自动匹配依赖 description,因此描述应简短、具体,并把触发任务和适用边界写在前面;列表被缩短时这一点尤其重要。

按三个阶段理解
阶段Codex 需要什么对你的实际影响
已安装支持位置中的 Skill 文件夹它可供使用,但不会因此参与每一个任务。
初始列表受预算限制的名称、描述和路径列表很长时,职责重复或描述过长的 Skill 更难被发现。
为任务选中该 Skill 的完整指令当前选中 Skill 的指令会影响这次运行的上下文与行为。
03

实用起点:一到三个职责不同的角色

这是编辑建议,不是 OpenAI 限制,也不是经过对照测试得出的性能基准:先为一个经常重复的工作流选一个 Skill;只有当不同阶段确实需要不同职责时,再考虑组成两到三个的小集合。以前端任务为例,可以分别是视觉方向、设计规范检查和浏览器行为验证。

不要因为示例列出三个就把三个都装上。合适的组合取决于项目、你对来源的信任程度,以及是否有人检查产物。很少使用、和其他 Skill 职责重复,或要求超出任务需要的访问权限,都可能是暂不安装的理由。

04

列表出现警告,或找不到某个 Skill 时

先确认 Skill 位于 Codex 支持的位置,且名称和描述元数据有效。然后检查是否有重复职责、特别冗长的描述,或已经不再使用的 Skill。把核心触发词和任务边界写在描述开头,让描述被缩短时仍有用。

Codex 还提供 skills.max_context_tokens 配置,用于调整初始列表预算,上限为 10,000 tokens。这属于进阶选项,不代表应该保留每个包:增大预算会占用更多会话上下文;移除重复项通常能让列表更清晰。修改前请查阅当前配置文档。

05

一个简单的精简规则

只有当你能说明某个 Skill 对应的重复任务、它增加的独立产物,并且能审查它的来源与权限时,才把它留在组合中。先从少量开始,根据真实使用情况添加或移除,不必追求某个数量。

适合的确切数量因人而异。上下文大小、描述长度、配置、安装位置和具体任务都会影响发现与使用。官方文档说明了预算行为,但没有承诺一个普遍可靠的最大 Skill 数量或质量门槛。

下一步

按工作选择 Skill,不要追求堆满收藏

对照任务、来源、权限和预期产物,只保留你能解释并持续维护的职责。