Skills 正式加入 Codex
发布: (2025年12月20日 GMT+8 16:09)
4 min read
原文: Hacker News
Source: Hacker News
技能结构
技能是一个文件夹，包含一个 SKILL.md 文件（必需）以及可选的子文件夹：
SKILL.md– 必需：markdown 指令 + 元数据scripts/– 可选：可执行代码references/– 可选：文档assets/– 可选：模板、资源
调用技能
显式调用
您可以在提示中直接包含技能。要选择一个，请运行 /skills 斜杠命令或开始键入 $ 来提及技能。（Codex 网页版和 iOS 版尚不支持显式调用，但您仍然可以提示 Codex 使用已检入仓库的任何技能。）
隐式调用
当用户的任务与技能描述匹配时，Codex 可以决定使用可用的技能。无论哪种情况，Codex 都会读取已调用技能的完整指令以及检入该技能的任何额外参考。
技能范围与优先级
Codex 从多个位置加载技能。当多个技能共享相同名称时，来自更高优先级范围的技能会覆盖其他技能。
| 范围 | 位置 | 建议用途 |
|---|---|---|
| REPO | $CWD/.codex/skills | 当前工作目录（例如，微服务或模块）。 |
| REPO | $CWD/../.codex/skills | 当前仓库的父文件夹——用于相关项目的共享区域。 |
| REPO | $REPO_ROOT/.codex/skills | 仓库根目录——对所有子文件夹均可用的技能。 |
| USER | $CODEX_HOME/skills (~/.codex/skills on macOS/Linux) | 个人技能，可在任何仓库中使用。 |
| ADMIN | /etc/codex/skills | 系统范围的技能，用于自动化、SDK 脚本或默认管理员工具。 |
| SYSTEM | Bundled with Codex | 面向广泛受众的技能（例如 skill-creator、plan）。 |
创建技能
使用内置的 $skill-creator
在 Codex 中运行 $skill-creator 技能，描述你希望技能实现的功能，Codex 将为其引导生成。可以先配合 $plan 生成计划。
手动创建
在任意有效的技能位置创建文件夹并添加 SKILL.md 文件。文件必须包含 name 和 description（metadata 为可选）。
---
name: skill-name
description: Description that helps Codex select the skill
metadata:
short-description: Optional user‑facing description
---
Skill instructions for the Codex agent to follow when using this skill.Codex 技能基于 Agent Skills 规范。更多细节请参阅文档。
内置技能和安装程序
您可以通过从 GitHub 上的精选集合下载来扩展内置技能列表：
$skill-installer linear安装程序还可以从其他仓库获取技能。
示例用例
规划新功能
Codex 附带内置的 $plan 技能，可帮助研究并为新功能或复杂问题制定计划。
为 Codex 任务访问 Linear 上下文
$skill-installer linear让 Codex 访问 Notion 以获取更多上下文
$skill-installer notion-spec-to-implementation