Communitygithub.com

搭子.skill (Partner)

搭子技能:Claude Code 負責規劃、潤色與審查,Codex 負責實作、監控與驗收。同一 session 的收據證明不會浪費 Claude cold start。

搭子.skill (Partner) 是什麼?

此技能定義了一套雙代理協作工作流程,其中 Claude Code 擔任高價值的規劃、審查與 UI 潤色代理,而 Codex 則負責主要實作與監控。其核心策略是盡可能在同一個 Claude Code session 中完成「規劃 → 實作傳遞 → 潤色 → 審查」的循環,以最大化 Claude 的上下文連續性,避免因 cold start 而浪費 token 與時間。技能明確規範了 session 管理策略,例如小型任務應使用單一 session,大型任務則在 Codex 產出精簡交接文件後再分割 session。此外,本技能也定義了權限政策、路由規則(哪些任務該交給 Claude Code、哪些該交給 Codex),以及完整的驗證閘門(Darwin-style 棘輪)與監控機制(優先使用五個訊號而非依賴對話文字)。最後,它要求每次非平凡的 Claude Code 工作流程結束時提供「Partner Session Receipt」,記錄 session ID、是否重複使用、異常狀態等關鍵資訊,以確保可稽核性。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add LearnPrompt/partner-skill

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

搭子.skill (Partner) 是做什麼的?

我的 Claude Code 和 Codex 天下第一好。

概述

使用此技能來執行雙代理協作工作流程:Claude Code 是高價值的規劃、潤色與審查代理;Codex 是外部編排器與主要實作者。請專注使用 Claude Code,因為它可能透過 API 計費。

對於小型與中型任務,偏好使用一個長生命週期的 Claude Code session:先向 Claude 索取計劃,讓 Codex 負責實作,然後將 diff 摘要與關鍵檔案回傳到同一個 Claude session 進行 UI/互動潤色與最終的 /codex:review。這樣可以避免為重建相同專案上下文而支付 Claude 費用,並賦予 Claude 足夠的連續性來改善工作成果。

Partner 並非甩鍋藉口。使用者仍是負責人,Codex 仍需對儲存庫證據負責,而 Claude Code 則被視為高價值協作者,其輸出必須經過驗證。

預設流程

  1. 在目標儲存庫中定位。

    • 進入具體的專案目錄,而非 agent-workbench 根目錄。
    • 啟動 Claude Code 前先執行 git status --short。
    • 判斷任務是全新專案、功能密集型、UI 密集型、純審查,還是除錯。
  2. 為昂貴的思考循環啟動一個 Claude Code session。

    • 對於規劃:在 PTY 中啟動 Claude Code 並設定目標。
    • 預設使用 claude --permission-mode plan --name <task-name>。
    • 在互動式 session 中,發送 /goal <明確的完成條件>。
    • 要求 Claude Code 提供具體的實作計劃、驗收標準以及 UI/互動指引。
    • 當任務規模不大時,保持同一個 session 開啟,以供後續的潤色與審查階段使用。
    • 不要因為 Codex 已完成實作就另外啟動一個純審查的 claude -p session。這會浪費 token 在 cold-start 上下文上,並削弱 Claude 的連續性。
  3. 主要以 Codex 進行實作。

    • 將 Claude Code 的計劃轉換為簡短的檢查清單。
    • 直接在 Codex 中進行程式碼變更,遵循現有儲存庫的模式。
    • 在有風險的編輯後執行最快的相關檢查。
    • 除非使用者要求,否則讓 Claude Code 遠離機械化的批次編輯、重複的 lint 修正以及長時間的命令循環。
  4. 將實作後的狀態送回同一個 Claude Code session 進行潤色。

    • 特別在處理前端 UI、互動品質、產品感受、無障礙性及邊界狀態時使用。
    • 傳送有範圍限制的資料包。如果可能,使用 references/handoff-template.md:包含原始計劃、變更檔案列表、git diff --stat、測試/檢查輸出、風險、待解決問題,以及只有 Claude 需要的關鍵檔案片段或完整檔案。
    • 要求優先排序的發現事項,而非廣泛的重寫。
    • Codex 套用已接受的修正並重新執行檢查。
  5. 從同一個 Claude Code session 執行最終審查。

    • 在 Claude Code 中,如果可用則使用 /codex:review。
    • 將發現事項視為錯誤/風險/測試問題優先,風格建議次之。
    • Codex 修正阻礙性的發現事項,重新執行檢查,並報告最終狀態。
    • 最後提供 Partner Session Receipt,以便使用者驗證 Claude Code 上下文是否被重複使用。

Session 策略

  • 小型或中型任務:保持一個 Claude Code session 開啟以執行 規劃 -> 潤色 -> /codex:review。
  • 將開啟全新的 Claude Code session 視為昂貴操作。僅在沒有可重複使用的 session、先前 session 無法恢復、或使用者明確要求全新 Claude 處理時才開啟。
  • 若同一個 Claude session 卡在提示、權限等待或閒置狀態,請先嘗試透過有範圍限制的訊息繼續或恢復同一個 session。除非其價值明顯超過上下文成本,否則不要 cold-start 一個替代審查。
  • 大型任務或巨大 diff:僅在 Codex 產出精簡的交接文件(包含計劃、變更檔案、關鍵決策、已知風險與檢查結果)後才分割 session。
  • 若同一個 Claude session 變慢、混淆或上下文過重,請在報告 token 權衡後關閉它並使用有範圍限制的交接重新啟動。
  • 除非使用者明確要求更快的極簡循環,否則不要跳過 UI/前端工作的 Claude 潤色階段。
  • 如果 /codex:review 卡住、逾時或陷入權限提示,請將其記錄為監控發現事項,停止卡住的子程序/session,並繼續以 Codex 方驗證。
  • 如果 Claude Code 沒有產生可操作的潤色建議,請不要盲目地持續提示它。捕捉這個空/低訊號結果,執行 Codex 驗證,並報告此限制。
  • claude -p 並非 Partner 的預設路徑。僅在處理廉價的一次性問題(失去先前 session 上下文是可接受的)時使用它。

權限政策

  • 規劃階段預設使用 --permission-mode plan,實作審查則使用一般權限。
  • 僅在使用者明確要求 skip、最高許可權限、全部允許、bypass,或工作位於刻意隔離的工作樹內時,才使用跳過/繞過模式。
  • 對於跳過模式,使用 claude --permission-mode bypassPermissions --name <task-name> 或 claude --dangerously-skip-permissions --name <task-name> 啟動 Claude Code。
  • 在任何跳過模式的 session 開始前,陳述儲存庫路徑、目前 git 狀態、預期範圍與停止條件。
  • 除非使用者給予額外的明確指示,否則絕不讓跳過模式進行提交、推送、部署、發送訊息、發佈或觸及機密。
  • 絕不將 skip 視為忽視儲存庫證據的許可。skip 改變的是 Claude Code 的權限,而非 Partner 的驗證責任。
  • 將儲存庫可見性變更、發佈標籤、註冊表發佈與外部公告保留在一個獨立的明確發佈指示之後。

路由規則

  • 路由至 Claude Code:架構規劃、實作策略、UI/互動評論、最終的 Codex Review、困難的產品取捨。
  • 路由至 Codex:支架搭建、實作、長上下文程式碼編輯、測試、建置修正、儲存庫檢查、監控、摘要。
  • 當 UI 品質很重要,或首次實作技術上通過但仍需產品潤色時,路由回同一個 Claude Code session。
  • 將 Kimi Work/Kimi Code Goal 與 Claude Code /goal 分開;先前的「Goal 模式」上下文可能指的是 Kimi,而非 Claude。

驗證閘門

在改進此工作流程或將其應用於重要任務時,請使用 references/darwin-ratchet.md 中的 Darwin 風格棘輪:

  • 一次僅改變一個工作流程維度:規劃、實作、UI 潤色、審查、監控、權限或報告。
  • 在宣稱改進更好之前,先執行測試提示或一個真實的迷你循環。
  • 對於高風險變更,不要讓同一個代理同時擔任唯一的製造者與唯一的評判者。
  • 僅在儲存庫證據有所改善時保留變更。如果惡化,請使用可審查的回退,而非 git reset --hard。
  • 當另一個提示循環產生低訊號或預期改進點數小於 1 時停止。

監控

對於活躍的 Claude Code session,請參閱 references/monitoring.md。優先使用五個訊號而非僅依賴聊天文字:

  1. 執行中 Claude Code session 的 PTY 輸出。
  2. claude agents --json --cwd <repo> session 狀態。
  3. Claude JSONL 轉錄結構,預設不傾印完整的訊息內文。
  4. 可選的 ~/.claude/tasks/<sessionId>/ 下的任務檔案。
  5. 儲存庫證據:git status --short、git diff --stat 以及相關的測試/建置檢查。

輸出契約

向使用者回報時,需包含:

  • 當前階段:規劃、Codex 實作、Claude 潤色、審查或最終修正。
  • Claude Code session id(如果存在)。
  • 已變更的檔案與已執行的檢查。
  • 已修正或仍開放的審查發現事項。
  • 工作是否準備好提交;預設不提交。
  • 任何監控異常,例如閒置 session、權限等待、空的審查輸出、無 diff 或檢查失敗。
  • 非平凡的 Claude Code 工作流程的 Partner Session Receipt:
[Partner session receipt]
phase: <planning | codex implementation | claude polish | review | final fix>
claude_session: <sessionId or none>
claude_session_reused: <yes | no | n/a>
new_claude_p_sessions: <0 | count | unknown>
codex_passes: <number of implementation/fix passes>
checks: <commands run or not run>
anomalies: <none | permission wait | idle | empty review | failed check | other>

不要捏造 token 節省量。當無法取得精確的 token 遙測資料時,改為報告可驗證的行為:同一個 Claude Code session 被重複使用、無新的 claude -p session、使用了有範圍限制的交接、檢查通過。

相關技能