如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題
Codex

Codex 應用案例

將工作流程儲存為技能

把經常重複的工作寫成技能,讓 Codex 隨時取用。

難度 Easy
任務時間跨度 5m

將曾協助你完成任務的 Codex 對話、審查規則、測試指令、發布檢查清單、設計慣例、寫作範例或特定程式碼庫專用的指令碼整理成技能,讓 Codex 在日後的任務中使用。

最適合的對象

  • 已有明確步驟,且希望 Codex 日後再次執行的工作流程。
  • 希望重複使用技能,省去每次對話都要貼上冗長提示詞的團隊。

目錄

    ← 所有應用案例

    將工作流程儲存為技能

    把經常重複的工作寫成技能,讓 Codex 隨時取用。

    將曾協助你完成任務的 Codex 對話、審查規則、測試指令、發布檢查清單、設計慣例、寫作範例或特定程式碼庫專用的指令碼整理成技能,讓 Codex 在日後的任務中使用。

    Easy
    5m

    將曾協助你完成任務的 Codex 對話、審查規則、測試指令、發布檢查清單、設計慣例、寫作範例或特定程式碼庫專用的指令碼整理成技能,讓 Codex 在日後的任務中使用。

    Easy
    5m

    相關連結

    最適合的對象

    • 已有明確步驟,且希望 Codex 日後再次執行的工作流程。
    • 希望重複使用技能,省去每次對話都要貼上冗長提示詞的團隊。

    技能與外掛程式

    • 蒐集工作流程的相關資訊,建立技能的基本架構,撰寫精簡的主要指示,再驗證技能是否能正常運作。
    技能 使用理由
    Skill Creator 蒐集工作流程的相關資訊,建立技能的基本架構,撰寫精簡的主要指示,再驗證技能是否能正常運作。

    入門提示詞

    請使用 $skill-creator 建立一項 Codex 技能,用來[修正 GitHub PR 上導致 Buildkite 檢查失敗的問題 / 將 PR 筆記轉成對應程式碼行的審查意見 / 根據已合併的 PR 撰寫我們的版本說明]。 建立技能時,請使用以下資料: - 成功範例:[寫下「使用這段對話」、提供已合併 PR 的連結,或貼上符合需求的 Codex 回覆] - 參考來源:[貼上 Slack 討論串、PR 審查連結、操作手冊網址、文件網址或工單] - 程式碼庫:[如果這項技能依賴特定程式碼庫,請填入該程式碼庫的路徑] - 可重複使用的指令碼或指令:[測試指令]、[預覽指令]、[擷取記錄的指令碼]、[發布指令] - 理想輸出範例:[貼上 Slack 進度更新、變更記錄條目、審查意見、工單或最終回覆,供日後執行任務時比照]
    請使用 $skill-creator 建立一項 Codex 技能,用來[修正 GitHub PR 上導致 Buildkite 檢查失敗的問題 / 將 PR 筆記轉成對應程式碼行的審查意見 / 根據已合併的 PR 撰寫我們的版本說明]。 建立技能時,請使用以下資料: - 成功範例:[寫下「使用這段對話」、提供已合併 PR 的連結,或貼上符合需求的 Codex 回覆] - 參考來源:[貼上 Slack 討論串、PR 審查連結、操作手冊網址、文件網址或工單] - 程式碼庫:[如果這項技能依賴特定程式碼庫,請填入該程式碼庫的路徑] - 可重複使用的指令碼或指令:[測試指令]、[預覽指令]、[擷取記錄的指令碼]、[發布指令] - 理想輸出範例:[貼上 Slack 進度更新、變更記錄條目、審查意見、工單或最終回覆,供日後執行任務時比照]

    建立 Codex 可隨時使用的技能

    對於經常重複的工作,你可以透過技能,讓 Codex 重複使用相同的操作說明、資源和指令碼。技能可以保留當初讓 Codex 順利幫上忙的任務、文件、指令或範例。

    先挑一個實際用過的範例,例如一段讓 Codex 以 cherry-pick 套用 PR 變更的對話、Notion 裡的發佈檢查清單、幾則實用的 PR 留言,或是說明上線流程的 Slack 討論串。

    使用方式

    1. 加入你希望 Codex 使用的上下文。

      在你想保留的 Codex 對話中,貼上 Slack 討論串或文件連結,再補上希望 Codex 記住的規則、指令或範例。

    2. 執行起始提示詞。

      在提示詞中先寫出要建立的技能名稱,再把要保留的任務、文件、PR、指令或輸出交給 $skill-creator。

    3. 讓 Codex 建立並驗證技能。

      建立完成的技能應定義 $skill-name,說明何時應觸發,並將可重複使用的操作說明放在適當位置。

      在任何程式碼庫中都能使用 ~/.codex/skills 裡的技能。你也可以將目前程式碼庫裡的技能提交到版本控制,讓團隊成員一起使用。

    4. 使用技能,再透過對話更新技能。

      下次處理 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 界定第一個可玩的遊戲循環要涵蓋哪些內容、挑選素材、調整遊玩手感、擷取螢幕截圖,並在瀏覽器中微調遊戲細節。

    相關應用案例