Codex 應用案例
建立 Codex 可使用的 CLI
為 Codex 提供可與其他指令搭配使用的指令,讓它能存取 API、日誌來源或匯出資料,也能執行團隊的指令碼。
請 Codex 建立一套 CLI,讓它能在任何資料夾中執行 CLI 指令、搭配程式碼庫中的指令碼使用,也能下載檔案。再請它建立配套技能,讓 Codex 日後記得如何使用這套 CLI。
最適合的對象
- Codex 需要反覆對同一項服務、同一份匯出資料、同一個本機封存檔或同一支程式碼庫指令碼執行搜尋、讀取、下載或安全寫入等操作。
- 智慧體工具需要分頁搜尋、依 ID 精確讀取資料、格式可預期的 JSON 輸出、下載的檔案、本機索引,或先建立草稿再寫入的指令。
目錄
建立 Codex 可使用的 CLI
為 Codex 提供可與其他指令搭配使用的指令,讓它能存取 API、日誌來源或匯出資料,也能執行團隊的指令碼。
請 Codex 建立一套 CLI,讓它能在任何資料夾中執行 CLI 指令、搭配程式碼庫中的指令碼使用,也能下載檔案。再請它建立配套技能,讓 Codex 日後記得如何使用這套 CLI。
技能與外掛程式
- 規劃指令介面、建置 CLI,並加入設定與身分驗證檢查。將指令安裝到 PATH 所列的目錄後,再從另一個資料夾執行,確認指令可用。
- 建立配套技能,讓 Codex 在後續任務中知道該先執行哪些 CLI 指令,以及哪些寫入操作需要核准。
| 技能 | 使用理由 |
|---|---|
| Cli Creator | 規劃指令介面、建置 CLI,並加入設定與身分驗證檢查。將指令安裝到 PATH 所列的目錄後,再從另一個資料夾執行,確認指令可用。 |
| Skill Creator | 建立配套技能,讓 Codex 在後續任務中知道該先執行哪些 CLI 指令,以及哪些寫入操作需要核准。 |
入門提示詞
簡介
如果 Codex 經常使用同一個 API、日誌來源、匯出的收件匣資料、本機資料庫或團隊指令碼,可以把這類操作做成可組合的指令。這樣一來,Codex 就能從任何資料夾執行指令、檢視結果、縮小輸出範圍,也能搭配 git、gh、rg、測試和程式碼庫中的指令碼使用。
建立一個搭配 CLI 使用的技能,記下 Codex 何時該使用 CLI、應先執行哪個指令、如何控制輸出量、下載的檔案存在哪裡,以及哪些寫入指令需要核准。
在這個工作流程中,$cli-creator 協助 Codex 建立指令。$skill-creator 則協助 Codex 儲存可重複使用的技能,例如 $ci-logs,讓日後的任務可以直接依名稱呼叫技能。
使用方式
決定 CLI 要支援哪些操作
先想清楚要讓 Codex 完成什麼工作,再考慮用什麼技術實作。設計得當的 CLI 能將經常重複的讀取、搜尋、下載、匯出、草擬、上傳、輪詢或安全寫入操作做成指令,讓 Codex 能從任何程式碼庫執行。
| 情境 | Codex 可以如何使用 CLI |
|---|---|
| 必須進入建置頁面才能查看 CI 日誌。 | 接收建置網址,將失敗作業的日誌下載到 ./logs,並傳回檔案路徑和簡短的日誌摘錄。 |
| 每週收到一份匯出的客服工單資料。 | 為最新匯出的 CSV 或 JSON 檔案建立索引,依客戶或詞句搜尋,再用固定不變的 ID 讀取單一工單。 |
| API 回應太大,上下文容納不下。 | 只列出需要的欄位,依 ID 讀取完整物件,並將完整回應匯出至檔案。 |
| Slack 匯出資料中有很長的討論串。 | 使用 --limit 搜尋,讀取單一討論串,只傳回相符訊息前後的上下文,無須傳回整份封存資料。 |
| 團隊指令碼會執行四個不同的步驟。 | 將設定、探索、下載、草擬、上傳、輪詢和寫入實際系統等操作拆成獨立指令。 |
| 外掛程式找到了紀錄,但 Codex 需要檔案。 | 在對話中繼續使用外掛程式,再用 CLI 下載附件、追蹤資料、報告、影片或日誌封裝檔,並傳回檔案路徑。 |
提供文件、檔案或指令
Codex 需要具體的參考資料,例如文件或 OpenAPI 規格、已遮蔽敏感資訊的 curl 指令、匯出檔案或資料庫的路徑、存放日誌的資料夾,或現有的指令碼。如果希望 CLI 沿用熟悉的指令風格,可以貼上一小段 --help 輸出,來源可以是 gh、kubectl 或團隊自己的工具。
如果指令需要驗證身分,請告訴 Codex 應支援的環境變數名稱、設定檔路徑或登入流程。請自行在 shell 或設定檔中設定驗證所需的機密資訊,切勿將這些資訊貼到對話中。請 Codex 確保 CLI 在缺少驗證資訊時無法通過設定檢查,並清楚說明原因。
請 Codex 建立 CLI 和技能
使用本頁的起始提示詞,填入要讓 Codex 參考的資料來源,以及 CLI 首先要支援的工作。
在撰寫程式碼之前,Codex 應先列出預計提供的指令及其用法。只有在缺少必要資訊而無法實作時,才需要就缺少的資訊提問。
確認從任何資料夾都能執行指令
Codex 不應只執行 cargo run、python path/to/script.py 或尚未安裝的套件指令就結束測試。請它按照日後執行任務時的用法,從另一個程式碼庫或暫存資料夾測試安裝後的指令。
以智慧體日後執行任務的方式測試 CLI
如果 Codex 傳回一大段 JSON 資料,請它縮小預設回應範圍,並新增將完整承載資料匯出至檔案的功能。如果它忘了哪些操作需要核准,請先讓它更新搭配使用的技能,再用於其他任務。
日後使用技能
下次需要這個 CLI 時,直接呼叫技能即可,無須再次貼上文件:
對於需要定期執行的工作,先在對話中測試一次技能,再請 Codex 直接在該對話中為同一個技能呼叫建立排程任務。