結論先說
- 自定義提示詞存放在
~/.codex/prompts/目錄(若設了CODEX_HOME則為$CODEX_HOME/prompts/)。每個.md文件對應一條自定義斜槓命令,去掉.md後綴的文件名即為命令標識。 - 支持 YAML 前置說明與動態位置參數。文件頂部可寫
description(選單簡介)與argument_hint(參數提示),正文支持$1至$9按序接參,或用$ARGUMENTS接收整串附加文本。 - 按需展開不浪費平時上下文。和每次啟動都會讀入的
AGENTS.md不同,自定義提示詞只在你手動敲斜槓調用的那一輪才載入對話。 - 團隊共享可藉助倉庫腳本或軟連結同步。由於
~/.codex/prompts位於個人主目錄,團隊可把模板納入倉庫docs/codex-prompts/,再用初始化腳本軟鏈到成員本機。 - 複雜重構模板往往伴隨多輪倉庫讀寫。國內缺少外幣銀行卡的用戶,可在本站自助開通 ChatGPT Plus 或大額度的 ChatGPT Pro,多席位研發團隊可諮詢 ChatGPT Business 團隊定製。

圖:本站根據 OpenAI Codex 官方倉庫 Custom Prompts 說明 整理的示意圖
本文根據 OpenAI Codex 官方文檔《Slash commands in Codex CLI》《Codex CLI》與官方倉庫 Custom Prompts 說明整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 OpenAI 官方網站。
適用於誰
- 每天在 Codex CLI 裏反覆輸入相似的發版自檢、PR 描述生成或模組重構提示詞,想做成一鍵斜槓命令的開發者;
- 不希望把低頻長篇指令塞進
AGENTS.md擠佔每一次對話上下文的人; - 想在自定義模板裏用
$1、$ARGUMENTS動態傳入分支名、目錄路徑或目標版本號的用戶。
一、Custom Prompts 與 AGENTS.md、Skills 怎麼分工
在 Codex CLI 中(內置命令速查見 /guides/codex-cli-commands-cheatsheet),三種定製機制職責各有側重:

圖:本站根據 OpenAI Codex 官方文檔 整理的示意圖
AGENTS.md:放所有任務都要遵守的硬規矩(如包管理器、測試命令、代碼風格),讀取機制見 /guides/codex-agents-md-how-it-reads。- Custom Prompts(
~/.codex/prompts/):放「偶爾觸發、步驟固定、需要傳參」的單輪提示詞模板,比如發版前核對清單、給指定文件補單測。 - Skills(技能):當流程除了提示詞還依賴配套腳本、參考手冊或多步領域工具時,再封裝為技能(對比 Claude Code 同類寫法可看 /guides/claude-code-custom-skill-slash-command-example)。
二、目錄創建與參數佔位語法
- 創建目錄:
mkdir -p ~/.codex/prompts(Windows 用戶對應%USERPROFILE%\.codex\prompts)。 - 新建英文短橫線命名的
.md文件,例如refactor-module.md。 - 頂部可選添加 YAML frontmatter 聲明說明與參數提示,正文中可用以下佔位符:
$1、$2……$9:按空格分隔的順序參數(含空格的參數調用時加雙引號);$ARGUMENTS:命令名後面的全部原始參數字符串;$$:輸出字面量美元符號本身。
- 重新啟動
codex交互介面,輸入/即可在補全列表看到/prompts:refactor-module,選中後填入參數回車發送。終端介面快捷鍵定製可一併參考 /guides/codex-cli-keymap-statusline-tui-customization。
訂閱與帳號準備提示:使用帶參重構與發版核查模板時,Codex 通常會連續讀取多個目錄並跑測試校驗,配額消耗高於簡短提問。需要擴充額度時可在本站開通 ChatGPT Pro 充值 或選用 ChatGPT Pro 5x iOS 可覆蓋檔;日常開發起步也可直接選購 ChatGPT Plus 會員。
三、3 套可直接複製的工程模板
模板 1:發版前核對清單(~/.codex/prompts/release-check.md)
markdown
---
description: 對照目標基線分支執行發版前變更與風險自檢
argument_hint: <基線分支名> <擬發版本號>
---
請對比當前分支與 $1 分支的全部 git diff,準備發佈版本 $2:
1. 檢查是否有遺漏的環境變量新增項未同步寫入 .env.example;
2. 檢查數據庫遷移腳本與回滾邏輯是否成對出現;
3. 運行項目測試命令並彙總結果,最後輸出「可放行 / 需阻斷」結論。
核對要點:確認模型實際執行了本項目的測試套件而非僅憑靜態閱讀判斷。
模板 2:按模組安全重構(~/.codex/prompts/safe-refactor.md)
markdown
---
description: 在保持外部導出簽名不變的前提下重構指定目錄或文件
argument_hint: <文件路徑> <重構目標說明>
---
請針對 $1 執行重構,目標要求:$2。
約束條件:保持所有對外導出的函數名、參數類型和返回值契約完全不變;每改完一步立即運行關聯單元測試,若測試變紅請自行回退或修復。
核對要點:跑完後用 /diff 核查公共接口簽名確實未被改動。
模板 3:邊界用例補齊(~/.codex/prompts/add-edge-tests.md)
markdown
---
description: 為指定源碼文件補充空值、異常與邊界條件單元測試
argument_hint: <源碼文件路徑及重點函數>
---
請閱讀目標代碼:$ARGUMENTS。先找出當前測試文件尚未覆蓋的空輸入、超時、越界與異常分支,列出擬新增的測試點清單,再按倉庫現有測試框架風格補齊用例並跑通。
核對要點:人工檢查新增斷言是否驗證了真實業務行為,避免只斷言函數被調用過的形式化測試。
常見問題
問:新建或修改了 ~/.codex/prompts/ 下的文件,為什麼輸入 / 搜不到?
答:檢查文件擴展名是否為小寫 .md 且放在頂層 prompts 目錄(避免套多層子文件夾),儲存後退出當前 Codex TUI 重新進入會話即可刷新索引。
問:參數裏帶空格(比如一段中文重構說明)怎麼避免被拆成 $2、$3?
答:調用時把整段帶空格的說明放在英文雙引號內作為單個位置參數,或在模板末尾直接用 $ARGUMENTS 接收整句輸入。
問:國內沒有外幣卡,或者企業採購需要開具增值稅發票,怎麼訂閱跑 Codex 的會員?
答:可在本站 AI 會員充值總覽 選擇 ChatGPT Plus 或 ChatGPT Pro,支持支付寶、微信支付與 AlipayHK,支持卡密自助兌換(無需交出密碼)及團隊定製,並可開具增值稅發票。實時價格以頁面顯示為準;售後遵循掉訂閱按剩餘天數折退、封號不在質保範圍的規則。
相關教學
參考資料
- OpenAI Codex 官方文檔:Slash commands in Codex CLI — https://learn.chatgpt.com/docs/developer-commands
- OpenAI Codex 官方文檔:Codex CLI — https://learn.chatgpt.com/docs/codex/cli
- OpenAI Codex 官方 GitHub 倉庫 — https://github.com/openai/codex
0 條評論
還沒有評論,來搶沙發~