Codex 的 skill 调用和功能调用

📅 2026/8/2 7:47:42 👁️ 阅读次数 📝 编程学习
Codex 的 skill 调用和功能调用

Codex CLI / Codex 桌面端 环境中,前缀符号的使用遵循了明确的作用域分工:


1. $ 用于注入上下文对象与 Skill(技能/插件)

在 Codex 中,$ 符号专门用于向当前的提示词(Prompt)中引用或注入“扩展内容”。这源于类 UNIX / Shell 命令行中变量引用的习惯(如 $VAR):

  • Skill / 扩展插件调用:输入 $openai-docs$prd 时,Codex 会去寻找本地 .codex/skills/ 或全局 ~/.codex/skills/ 中的技能定义文件(SKILL.md),并把该技能对应的 Prompt 指令或说明注入到发送给大模型的上下文里。
  • 上下文 / 资源挂载:输入 $app-name$file,相当于在告诉 AI:“把这个特定资源作为上下文数据带入回答中”。

直观理解$ 作用于 AI 接收的内容(注入变量、知识库、外部技能 Prompt)。


2. / 用于控制终端运行状态(内置客户端命令)

$ 不同,以 / 开头的命令不会直接作为文本/提示词发给大模型,而是直接被 Codex 客户端自己的解析器捕获,用来控制运行环境或发起客户端系统操作:

  • /clear:清空客户端当前的终端界面。
  • /model:在本地切换当前调用的底层大模型或 reasoning effort。
  • /mcp / /plugins:查看或配置客户端连接的 MCP 服务和插件列表。
  • /diff:调用本地 Git 逻辑查看代码改动。

直观理解/ 作用于 Codex 软件自身(控制软件系统设置、终端会话生命周期)。


总结对照

前缀符号 对应概念 作用机制 典型示例
**` 前缀符号 对应概念 作用机制
--- --- --- ---
** | Context & Skills (上下文 / 插件技能) | 将技能 Prompt 或扩展内容注入到 AI 提示词中 | $openai-docs (调用文档技能)


$code-explorer (调用代码探索技能) |
| / | Control Commands (系统控制命令) | 终端直接拦截执行,不传给大模型,用于控制会话状态 | /clear (清屏)


/model (换模型)


/exit (退出) |