Codex 自定義斜槓提示詞(Custom Prompts / ~/.codex/prompts)怎麼寫:帶參數複用團隊發版與重構模板

每次在 Codex 裏重複敲發版檢查或重構提示詞太麻煩?本文按官方文檔整理 ~/.codex/prompts 自定義斜槓命令的目錄位置、Markdown 前置說明、參數佔位符寫法及 3 套實用模板。

NNathaniel bigo··原創首發·AI 輔助撰寫
9 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 Plus 帳號

結論先說

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

Codex 自定義斜槓提示詞配置四步流程

圖:本站根據 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),三種定製機制職責各有側重:

Custom Prompts、AGENTS.md 與 Skills 區別

圖:本站根據 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)。

二、目錄創建與參數佔位語法

  1. 創建目錄:mkdir -p ~/.codex/prompts(Windows 用戶對應 %USERPROFILE%\.codex\prompts)。
  2. 新建英文短橫線命名的 .md 文件,例如 refactor-module.md。
  3. 頂部可選添加 YAML frontmatter 聲明說明與參數提示,正文中可用以下佔位符:
  • $1、$2……$9:按空格分隔的順序參數(含空格的參數調用時加雙引號);
  • $ARGUMENTS:命令名後面的全部原始參數字符串;
  • $$:輸出字面量美元符號本身。
  1. 重新啟動 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

Nathaniel 的更多內容

  1. 01

    獨立開發者用 ChatGPT + Codex 跑通產品全流程:市場驗證、PRD、原型到代碼上線覆盤清單

    單人做獨立產品最容易陷入「閉門寫兩個月代碼上線零用戶」或「AI 寫到一半目錄越改越崩」。本文整理「ChatGPT 負責市場驗證、PRD 與覆盤 + Codex 負責工程實現與測試」的五階段雙軌流程,附起手提示詞與 7 項上線覆盤清單。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成規範文件命名規則、整理混亂目錄樹與合併零散發票抬頭清單腳本

    面對滿桌面的「新建文件夾」「最終版2」和上百張零散電子發票,手工改名抄台帳耗時又容易漏重。本文分享先脫敏取樣、再用 ChatGPT 生成帶預演和回滾日誌的本地 Python 腳本,離線安全完成目錄整理與發票抬頭合併去重的實戰流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外電郵營銷(EDM)受眾分層文案、A/B 主題行測試與防進垃圾箱自檢

    做海外獨立站或出海 SaaS 電郵營銷(EDM),最怕千人一面群發被直接送進垃圾箱。本文結合 Gmail/Yahoo 批量發件人規範,梳理用 ChatGPT 設計受眾分層文案、批量生成 A/B 主題行矩陣並開展發前垃圾詞與合規自檢的實戰提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫 Notion Formula 2.0 公式、Obsidian Dataview 查詢與 Airtable 自動化腳本

    給 Notion 數據庫寫多條件 Formula 2.0 公式、給 Obsidian 寫 Dataview 動態看板,或在 Airtable 裏寫自動化腳本,經常因為一個小括號或類型不匹配報錯半天。本文整理三大工具的通用上下文喂料規範與三套直接可複製的生成提示詞。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 處理複雜 JSON / YAML / XML 字段映射、格式轉換與校驗規則編寫實戰

    對接第三方 API、遷移 Kubernetes 配置或解析政企 XML 報文時,手工對照幾百行嵌套字段既慢又容易漏掉空值與類型邊界。本文整理用 ChatGPT 完成字段映射表梳理、生成確定性轉換腳本以及編寫 JSON Schema / Pydantic / XSD 校驗規則的實戰流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 準備本科/碩士畢業論文答辯:提煉答辯 PPT 結構、模擬導師犀利追問與 3 分鐘自述稿

    畢業論文寫完後,要在 3–5 分鐘內講清研究價值並頂住答辯評委的連環追問並不輕鬆。本文整理在嚴格遵守高校學術規範的前提下,用 ChatGPT 提煉答辯 PPT 結構、打磨 3 分鐘口語自述稿並開展模擬導師犀利追問的排練流程與提示詞。

    ChatGPT0

同產品的其他教學

  1. 01

    用 ChatGPT 整理家庭裝修預算明細、隱蔽工程驗收清單與主材優缺點對比表實戰

    第一次裝修面對幾十頁施工報價單、密密麻麻的水電防水隱蔽項目與五花八門的主材參數,極易踩坑增項。本文梳理用 ChatGPT 審查裝修報價漏項、生成帶公式的預算明細表、定製工地隱蔽工程驗收單與主材對比表的實戰提示詞。

    ChatGPT0
  2. 02

    用 ChatGPT 做費曼學習法讀書共讀:反向追問檢驗自己是否真讀懂專業書籍與整理書單筆記

    讀完一本專業硬書常感覺「合上書就忘」,直接讓 AI 概括全書又容易產生懂了的錯覺。本文介紹用 ChatGPT 結合 Study Mode 與費曼學習法做反向追問共讀,通過通俗複述、挑刺盲區到沉澱書單卡片的完整流程與提示詞。

    ChatGPT0
  3. 03

    用 ChatGPT 做外貿產品多語種目錄、展會邀約與客戶跟進節奏表(附脫敏與本地化提示詞)

    做外貿展會與海外推廣時,手工翻譯十幾款產品目錄費時且容易留下一堆中式英文,展後客戶跟進也常缺節奏。本文梳理用 ChatGPT 先脫敏建術語庫、再批量產出多語種目錄、展前邀約函與展後 21 天跟進節奏表的實戰流程與提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫高質素技術專欄文章、開源項目 Release Notes 與版本更新日誌實戰

    讓 AI 直接憑空寫技術文章容易滿篇空洞套話,直接甩 Git 記錄寫更新日誌又常常漏掉破壞性變更。本文整理用 ChatGPT 結合真實代碼片段、壓測數據與 PR 摘要,高效產出深度技術專欄、GitHub Release Notes 與 CHANGELOG 的實戰工作流。

    ChatGPT0
  5. 05

    用 ChatGPT 做產品用戶訪談紀要編碼、提煉高頻痛點需求池與 RICE 優先級打分實戰

    手頭攢了十幾份用戶訪談逐字稿,手工貼便利貼歸納痛點耗時又容易帶入主觀偏見。本文分享用 ChatGPT 完成脫敏檢查、逐份開放式編碼、跨樣本聚類高頻痛點並搭建 RICE 優先級打分表的 5 步實戰流,附可直接複製的三段核心提示詞。

    ChatGPT0
  6. 06

    ChatGPT 網頁版上載超過 10 個文件或回形針附件按鈕變灰怎麼辦:打包合併與配額限制排查

    在 ChatGPT 網頁版批量分析文檔時,常遇到一次選超 10 個文件被攔截或輸入框回形針按鈕變灰。本文依據 OpenAI 文件上載與存儲說明,梳理 6 類常見報錯的分流排查法,提供 ZIP 打包、本地合併與 Projects 複用方案及可直接複製的解包提示詞。

    ChatGPT0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~