Codex 應用案例
將工作流程儲存為技能
把經常重複的工作寫成技能,讓 Codex 隨時取用。
將曾協助你完成任務的 Codex 對話、審查規則、測試指令、發布檢查清單、設計慣例、寫作範例或特定程式碼庫專用的指令碼整理成技能,讓 Codex 在日後的任務中使用。
最適合的對象
- 已有明確步驟,且希望 Codex 日後再次執行的工作流程。
- 希望重複使用技能,省去每次對話都要貼上冗長提示詞的團隊。
目錄
將工作流程儲存為技能
把經常重複的工作寫成技能,讓 Codex 隨時取用。
將曾協助你完成任務的 Codex 對話、審查規則、測試指令、發布檢查清單、設計慣例、寫作範例或特定程式碼庫專用的指令碼整理成技能,讓 Codex 在日後的任務中使用。
將曾協助你完成任務的 Codex 對話、審查規則、測試指令、發布檢查清單、設計慣例、寫作範例或特定程式碼庫專用的指令碼整理成技能,讓 Codex 在日後的任務中使用。
相關連結
最適合的對象
- 已有明確步驟,且希望 Codex 日後再次執行的工作流程。
- 希望重複使用技能,省去每次對話都要貼上冗長提示詞的團隊。
技能與外掛程式
- 蒐集工作流程的相關資訊,建立技能的基本架構,撰寫精簡的主要指示,再驗證技能是否能正常運作。
| 技能 | 使用理由 |
|---|---|
| Skill Creator | 蒐集工作流程的相關資訊,建立技能的基本架構,撰寫精簡的主要指示,再驗證技能是否能正常運作。 |
入門提示詞
建立 Codex 可隨時使用的技能
對於經常重複的工作,你可以透過技能,讓 Codex 重複使用相同的操作說明、資源和指令碼。技能可以保留當初讓 Codex 順利幫上忙的任務、文件、指令或範例。
先挑一個實際用過的範例,例如一段讓 Codex 以 cherry-pick 套用 PR 變更的對話、Notion 裡的發佈檢查清單、幾則實用的 PR 留言,或是說明上線流程的 Slack 討論串。
使用方式
-
加入你希望 Codex 使用的上下文。
在你想保留的 Codex 對話中,貼上 Slack 討論串或文件連結,再補上希望 Codex 記住的規則、指令或範例。
-
執行起始提示詞。
在提示詞中先寫出要建立的技能名稱,再把要保留的任務、文件、PR、指令或輸出交給
$skill-creator。 -
讓 Codex 建立並驗證技能。
建立完成的技能應定義
$skill-name,說明何時應觸發,並將可重複使用的操作說明放在適當位置。在任何程式碼庫中都能使用
~/.codex/skills裡的技能。你也可以將目前程式碼庫裡的技能提交到版本控制,讓團隊成員一起使用。 -
使用技能,再透過對話更新技能。
下次處理 PR、警示、審查、版本說明或設計任務時,叫用新的
$skill-name。如果 Codex 用錯測試指令、漏掉審查規則、跳過操作手冊中的步驟,或寫出你不會寄出的草稿,就請 Codex 把修正方式寫進技能。
提供來源資料
將能說明技能應如何運作的資料交給 $skill-creator。
| 現有資料 | 要加入的內容 |
|---|---|
| 想從 Codex 對話中保留的工作流程 | 在原本的對話中輸入 use this chat。Codex 可以從這段對話的上下文、指令、修改內容和意見回饋著手建立技能。 |
| 文件或操作手冊 | 貼上發佈檢查清單、提供事件應變手冊的連結、附上 API 文件的 PDF 檔,或告訴 Codex 程式碼庫中的 Markdown 指南放在哪裡。 |
| 團隊對話 | 貼上團隊成員說明某則警示的 Slack 討論串、提供載有前端規則的 PR 審查連結,或附上說明客戶問題的客服對話。 |
| 技能應重複使用的指令碼或指令 | 加入你希望 Codex 日後執行任務時使用的測試指令、預覽指令、發佈指令碼、擷取記錄的指令碼或本機輔助指令。 |
| 理想的成果 | 提供已合併的 PR、定稿的變更記錄條目、已獲採用的上線說明、已解決的工單、修改前後的螢幕截圖,或 Codex 的最終答覆,作為日後執行任務時的參考標準。 |
如果來源資料在 Slack、Linear、GitHub、Notion 或 Sentry 中,可以在 Codex 中透過外掛程式連接該工具,在起始提示詞中提及該工具,或將相關內容貼到對話中。
Codex 會建立哪些檔案
大多數技能一開始都只有一個 SKILL.md 檔案。視工作流程需要,$skill-creator 可以加入較詳細的參考文件、指令碼或素材。
-
my-skill/
- SKILL.md Required: instructions and metadata
- references/ Optional: longer docs
- scripts/ Optional: repeatable commands
- assets/ Optional: templates and starter files
-
可以建立哪些技能
如果之後的任務都需要參閱同一本操作手冊、執行同一套 CLI、遵循相同的審查準則、撰寫同類型的團隊進度報告,或測試同一套瀏覽器操作流程,都可以用這個方法建立技能。例如:
$buildkite-fix-ci下載執行失敗的作業記錄、診斷錯誤,並提出改動最少的程式碼修正方案。$fix-merge-conflicts簽出 GitHub PR 分支,依據基底分支更新 PR,解決衝突後提供可直接執行的推送指令。$frontend-skill讓 Codex 遵循你的介面設計偏好,沿用現有元件與素材選擇,透過螢幕截圖反覆檢查畫面,最後在瀏覽器中微調細節。$pr-review-comments將審查筆記整理成簡短、語氣恰當的逐行留言,並附上 GitHub 連結。$web-game-prototyper界定第一個可玩的遊戲循環要涵蓋哪些內容、挑選素材、調整遊玩手感、擷取螢幕截圖,並在瀏覽器中微調遊戲細節。