乐于分享
好东西不私藏

Codex App Commands 使用教程:别背命令表,先学会用入口

Codex App Commands 使用教程:别背命令表,先学会用入口

前两篇我们已经把 Codex App 装好,也跑通了本地项目工作流。

这篇聊一个更容易被忽略的东西:

Codex App 里的 Commands。

也就是你在输入框里敲 / 后看到的那些命令。

我一开始对它们没太在意。

反正直接用自然语言说“帮我看一下状态”“先给我计划”“帮我 review 一下”也能用。

后来发现,Commands 的价值不在于炫技。

它们像几个固定入口。

你不用每次都重新解释自己要进入哪种工作状态。

输入 /plan,就是先规划。

输入 /review,就是看当前改动。

输入 /status,就是确认当前线程状态。

这篇文章只解决一件事:

新手怎么把 Codex App 里的 Commands 用起来。


一、Commands 到底是什么

Commands 可以理解成 Codex App 里的快捷动作。

它们不是另一套高级语法,也不是必须背下来的命令表。

更实际一点说:

你在输入框里敲 /,Codex App 会列出当前环境可用的命令。

选中一个命令后,再补上你的任务说明。

比如:

  1. /plan
  2. 请先阅读项目结构,给出重构登录模块的方案。
  3. 先不要修改文件。

或者:

  1. /review
  2. 重点看这次改动有没有误改范围外文件,是否缺少测试。

它和直接聊天的区别在这里:

命令先帮你切到一个明确的工作入口。

你后面写的文字,再补充范围、约束和验收方式。


二、第一步不是背,而是输入 /

Codex App 的命令会随着版本、权限、插件、账号和当前环境变化。

所以我不建议一上来背一张“完整命令表”。

更靠谱的方式是:

  1. 打开一个项目线程
  2. ->在输入框输入/
  3. ->看当前弹出的命令列表
  4. ->再决定用哪个

这一步很重要。

别人电脑上有的命令,你这台机器未必有。

某篇教程里出现的命令,也不代表你当前版本一定支持。

如果你不确定某个命令能干什么,可以直接问 Codex:

  1. 解释一下当前可用的 slash commands
  2. 只解释,不要修改文件。

这个习惯比记命令更有用。


三、新手先掌握这几个

官方当前列出的 App slash commands 里,新手可以先看这些:

  1. /status
  2. /plan
  3. /review
  4. /mcp
  5. /goal
  6. /init
  7. /feedback

不用一次全学完。

我建议先从 /status、 /plan、 /review 开始。

这三个已经能覆盖大多数日常场景。


四、 /status:先确认你现在在哪

很多问题,其实不是 Codex 不会做。

而是你没看清当前线程处在什么状态。

比如:

当前有没有打开项目?

上下文还剩多少?

线程 ID 是什么?

当前有没有接近限制?

这时候可以先输入:

  1. /status

然后继续问:

  1. 解释当前线程状态。
  2. 重点说明:当前工作区、上下文使用情况、限制情况。
  3. 不要修改文件。

这个命令适合放在任务开始前。

尤其是你准备让 Codex 做一个比较大的任务时,先看状态,心里会稳一点。


五、 /plan:别急着让它改

我建议新手先学 /plan

因为它能帮你把“直接开改”的冲动按住。

适合用 /plan 的场景:

  1. 多文件改动
  2. 不熟悉的项目
  3. 影响面不确定的 bug
  4. 重构、迁移、升级依赖

可以这样写:

  1. /plan
  2. 目标:修复登录页在移动端按钮溢出的问题。
  3. 范围:
  4. 先只阅读登录页组件、相关样式和测试文件。
  5. 约束:
  6. 不要修改文件。
  7. 不要安装依赖。
  8. 交付:
  9. 列出可能原因、修改方案、风险和验证命令。

注意最后两句。

  1. 不要修改文件。
  2. 不要安装依赖。

这不是废话。

它能让 Codex 先进入分析状态,而不是一上来就动手。

等你看完计划,觉得方向没问题,再让它执行。


六、 /review:改完不要只听总结

Codex 改完文件后,人很容易偷懒:

只看它的总结。

总结可以看,但不能只看总结。

要看 diff。

这时候可以用:

  1. /review

如果任务比较敏感,把检查重点写清楚:

  1. /review
  2. 重点检查:
  3. 1.是否改了任务范围外的文件
  4. 2.是否缺少必要测试
  5. 3.是否引入新的网络请求、权限变化或外部服务调用
  6. 4.是否有过度抽象

/review 不是让 Codex 替你拍板。

它是在帮你做第一轮审查。

最后要不要保留这些改动,还是你决定。


七、 /mcp:看外部工具有没有接上

如果你装了浏览器、数据库、文档、内部 API 这类外部工具,通常会涉及 MCP。

这时候 /mcp 可以帮你看当前连接状态。

比如:

  1. /mcp

你可以接着问:

  1. 列出当前可用的 MCP 工具。
  2. 说明每个工具适合做什么。
  3. 不要调用工具。

这一步适合在“工具好像不能用”的时候先跑。

先看工具是否存在,再谈怎么用。

不要一上来就怀疑 prompt 写错了。

有时候只是工具没接上。


八、 /goal:适合有终点的长任务

/goal 适合更长一点的目标。

比如迁移、重构、持续修复测试,或者需要多轮推进的任务。

但我不建议新手一上来就用它。

原因很简单:

长任务如果目标写得模糊,Codex 会在模糊里跑很久。

不要这样写:

  1. /goal
  2. 优化整个项目

这个目标太大。

更好的写法是:

  1. /goal
  2. 把旧的 auth helper 迁移到新的 auth client
  3. 范围:
  4. 只允许修改 src/auth  tests/auth
  5. 验证:
  6. 持续推进,直到 npm test -- auth 通过。
  7. 停止条件:
  8. 如果需要修改范围外文件,或遇到需要人工确认的设计选择,先停下来问我。
  9. 限制:
  10. 不要提交 commit,不要推送远程分支。

这里的重点不是 /goal 本身。

重点是你写清楚了范围、验证方式和停止条件。

如果你的 App 里没有看到 /goal,不要硬找。

先用 /plan 加普通任务提示,也能把大部分工作拆开做。


九、 /init:让项目先有一份 AGENTS.md

/init 的作用,是为当前项目生成 AGENTS.md 脚手架。

AGENTS.md 可以放项目约定。

比如:

  1. 项目启动命令
  2. 测试命令
  3. 代码风格
  4. 不要碰哪些目录
  5. 提交前要跑什么检查

如果你经常让 Codex 处理同一个项目, AGENTS.md 很有用。

它相当于把重复说很多遍的项目规则写下来。

用法可以很简单:

  1. /init
  2. 根据当前项目生成 AGENTS.md 草稿。
  3. 先不要覆盖已有文件,如果已有 AGENTS.md,请先展示差异。

如果项目已经有规则文件,不要让它直接覆盖。

先看草稿,再合并。


十、 /feedback:真遇到问题就反馈

/feedback 用来打开反馈入口。

它适合反馈 App 或命令本身的问题。

比如:

  1. 某个命令不显示
  2. 某个命令行为和说明不一致
  3. 界面卡住
  4. 插件或工具状态异常

这不是日常高频命令。

但遇到产品问题时,比在普通 thread 里反复描述更直接。


十一、Commands、Skills、Automations 别混在一起

很多人容易把这几个概念混掉。

简单分:

Command 是当前线程里的快捷入口。

Skill 是可复用的方法和规则。

Automation 是定时或后台重复任务。

举个例子。

你只是想看当前改动:

  1. /review

这适合 Command。

你想每次写公众号文章都按同一套发布检查来做:

  1. wechat-md-publisher
  2. humanizer-zh
  3. markdown-to-html

这更适合 Skill。

你想每天早上自动检查一个仓库的测试状态:

  1. 每天9点检查测试结果

这属于 Automation。

不要把所有东西都想成 command。

入口不同,适合的事情也不同。


十二、我的日常用法

如果只给新手一套顺手流程,我会这样用:

  1. /status
  2. 先确认当前线程状态。

然后:

  1. /plan
  2. 先读项目,给方案,不要改文件。

确认计划后,让 Codex 执行小范围改动。

改完以后:

  1. /review
  2. 重点看范围、测试和风险。

如果这个任务比较长,再考虑 /goal

如果涉及外部工具,再看 /mcp

这套流程很朴素,但够用。

它的好处是让你一直知道 Codex 现在在干什么。


十三、几个不要做的事

不要把 CLI 命令表直接搬到 App 教程里。

CLI 和 App 不保证完全一样。

不要把别人机器上的命令当成你当前版本一定有。

先输入 / 看列表。

不要给 /goal 这种长任务入口一个模糊目标。

范围、验证、停止条件必须写清楚。

不要把 /review 当成人工 review 的替代品。

它是辅助,不是最终裁判。


总结

Codex App 的 Commands,不是让你背命令。

它们是几个工作入口。

你真正要学会的是:

  1. /发现当前可用命令
  2. /status 看状态
  3. /plan 先想清楚
  4. /review 检查改动
  5. /mcp 看工具连接
  6. /goal 处理有明确终点的长任务

先把这几个用顺,Codex App 就会从“一个会聊天的代码助手”,变成更可控的本地项目工作台。