搭子.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 則被視為高價值協作者,其輸出必須經過驗證。
預設流程
-
在目標儲存庫中定位。
- 進入具體的專案目錄,而非
agent-workbench根目錄。 - 啟動 Claude Code 前先執行
git status --short。 - 判斷任務是全新專案、功能密集型、UI 密集型、純審查,還是除錯。
- 進入具體的專案目錄,而非
-
為昂貴的思考循環啟動一個 Claude Code session。
- 對於規劃:在 PTY 中啟動 Claude Code 並設定目標。
- 預設使用
claude --permission-mode plan --name <task-name>。 - 在互動式 session 中,發送
/goal <明確的完成條件>。 - 要求 Claude Code 提供具體的實作計劃、驗收標準以及 UI/互動指引。
- 當任務規模不大時,保持同一個 session 開啟,以供後續的潤色與審查階段使用。
- 不要因為 Codex 已完成實作就另外啟動一個純審查的
claude -psession。這會浪費 token 在 cold-start 上下文上,並削弱 Claude 的連續性。
-
主要以 Codex 進行實作。
- 將 Claude Code 的計劃轉換為簡短的檢查清單。
- 直接在 Codex 中進行程式碼變更,遵循現有儲存庫的模式。
- 在有風險的編輯後執行最快的相關檢查。
- 除非使用者要求,否則讓 Claude Code 遠離機械化的批次編輯、重複的 lint 修正以及長時間的命令循環。
-
將實作後的狀態送回同一個 Claude Code session 進行潤色。
- 特別在處理前端 UI、互動品質、產品感受、無障礙性及邊界狀態時使用。
- 傳送有範圍限制的資料包。如果可能,使用
references/handoff-template.md:包含原始計劃、變更檔案列表、git diff --stat、測試/檢查輸出、風險、待解決問題,以及只有 Claude 需要的關鍵檔案片段或完整檔案。 - 要求優先排序的發現事項,而非廣泛的重寫。
- Codex 套用已接受的修正並重新執行檢查。
-
從同一個 Claude Code session 執行最終審查。
- 在 Claude Code 中,如果可用則使用
/codex:review。 - 將發現事項視為錯誤/風險/測試問題優先,風格建議次之。
- Codex 修正阻礙性的發現事項,重新執行檢查,並報告最終狀態。
- 最後提供 Partner Session Receipt,以便使用者驗證 Claude Code 上下文是否被重複使用。
- 在 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。優先使用五個訊號而非僅依賴聊天文字:
- 執行中 Claude Code session 的 PTY 輸出。
claude agents --json --cwd <repo>session 狀態。- Claude JSONL 轉錄結構,預設不傾印完整的訊息內文。
- 可選的
~/.claude/tasks/<sessionId>/下的任務檔案。 - 儲存庫證據:
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、使用了有範圍限制的交接、檢查通過。