Community寫作與編輯github.com

BuilderIO/plan-arbiter

當需要比較、交叉審查、合併、評判、選擇或仲裁來自多個代理(例如 Codex 和 Claude Code)的競爭計畫時使用;當給定兩個或多個提案計畫、Session ID、對話記錄、計畫文件、PR 描述或貼上策略時;或當使用者希望代理們相互審查彼此的提案後得到一個推薦的執行計畫時使用。

plan-arbiter 是什麼?

Plan Arbiter 是一個專門用於合併多個 AI 代理(如 Codex、Claude Code)所產生的競爭性計畫的技能。它的核心功能是將多個計畫轉化為一個清晰、可執行的執行方向,而不是產生模糊的混合方案。該技能支援從文字貼上、本機檔案、Session ID、對話記錄、PR 評論等多種來源收集計畫,並對每個計畫進行標準化,提取目標、假設、檔案影響、實作順序和驗證策略等關鍵資訊。接著它會進行交叉審查,檢查計畫是否能滿足使用者實際需求,並驗證其與真實程式碼庫、文件、測試的一致性。最後透過預設的決策優先順序(正確性、與真實檔案/API/測試的結合度、實作簡單性、驗證與回滾能力、成本)來決定採用單一計畫、合併為混合計畫,或要求重新規劃。該技能還會產出一個包含決策理由、執行步驟、借鑑與拒絕想法、驗證檢查清單以及執行者建議的決策備忘錄。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/BuilderIO/skills/tree/main/skills/plan-arbiter

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

Plan Arbiter

將競爭的計畫轉化為一個可執行的方向。保留最佳構想,拒絕薄弱假設,產出清晰的交接訊息,而非模糊的混合物。

工作流程

  1. 收集來源計畫。
  2. 將每個標準化為可比較的主張。
  3. 進行交叉審查,比對各計畫以及真實的程式碼庫或任務上下文。
  4. 選擇勝出者、合併出更好的混合方案,或將計畫退回修訂。
  5. 產出一個帶有驗證關卡和已拒絕替代方案的執行交接訊息。

規劃為唯讀操作,除非使用者明確要求你在決策後執行。

收集來源計畫

接受以貼上文字、本機檔案、Session ID、對話記錄路徑、PR、評論、視覺化計畫連結或聊天歷史等形式提供的計畫。盡可能解析原始工件,以便查看提示變更和假設,這些資訊可能從最終摘要中遺漏。

如果計畫仍在撰寫中且使用者要求你等待,請監控直到計畫完成或被阻擋。如果無法解析計畫,請繼續使用可用的計畫文字,並將缺失的來源標記為風險。

標準化

針對每個計畫,提取:

  • 目標和範圍。
  • 關鍵假設和未解決的問題。
  • 提議的檔案、模組、API、資料形狀、UI 狀態或工作流程。
  • 實作順序。
  • 驗證策略。
  • 回滾或遷移考量。
  • 成本、複雜度和預期的執行者適合度。

不要獎勵冗長。偏好具體、基於真實程式碼且誠實面對取捨的計畫。

交叉審查

假設每個計畫是由另一個能幹的代理撰寫,對其進行審查:

  • 檢查它是否滿足使用者的實際請求。
  • 根據儲存庫、文件、測試、截圖或外部系統驗證相關且可用的主張。
  • 識別隱藏的依賴關係、遺漏的測試、有風險的順序、模糊的步驟、不必要的範圍以及難以逆轉的決策。
  • 注意互補優勢:一個計畫可能擁有更好的架構,而另一個則有更好的遷移或驗證路徑。
  • 區分計畫品質與執行者偏好。當品質可接受時,成本更低/速度更快的執行者可能是實作的合適選擇。

當計畫規模龐大、程式碼庫廣泛,或決策需要獨立的技術和產品審查時,可使用子代理進行獨立審查。

決策

選擇以下三種結果之一:

  • 採用: 大致按原樣採納一個計畫。
  • 混合: 將特定部分組合成一個更強的執行計畫。
  • 優先修訂: 要求進行另一次規劃,因為兩個計畫都遺漏了關鍵限制條件或依賴於未解決的決策。

使用以下優先順序進行決策:

  1. 正確性以及是否符合使用者的請求。
  2. 與真實檔案、API、測試、資料和 UI 行為的結合度。
  3. 不阻礙預期未來的更簡單的首次實作。
  4. 更好的驗證和回滾方案。
  5. 品質可接受時較低的執行時間/代幣成本。

交接

產出一個精簡的決策備忘錄:

Decision
- 採用計畫 A / 混合 / 優先修訂。

Why
- 決定性證據和取捨。

Execution Plan
- 有序步驟,附帶需要觸及的檔案或表面。

Borrowed From Other Plans
- 從非勝出計畫中保留的有用部分。

Rejected
- 刻意不採用的想法,附帶原因。

Verification
- 需要的測試、瀏覽器檢查、截圖、CI、審查或部署檢查。

Executor Recommendation
- 哪個代理/模型應負責實作以及原因。

當使用者已經要求執行且選擇的路徑明確時,在簡短報告決策後繼續執行選定的計畫。否則,在交接處停止並請求批准。

Individual skills in this repo

This repo contains 10 individual skills — each has its own dedicated page.

BuilderIO/adding-a-skill

Use in the BuilderIO/skills repo whenever adding, updating, publishing, documenting, validating, or wiring a public skill. Covers the repo-local skill files, root catalog docs, plugin metadata, @agent-native/skills dynamic install path, optional managed AGENTS/CLAUDE instruction blocks in ../agent-native/framework, and generated/synced Plan skill gotchas.

BuilderIO/agent-watchdog

Use when asked to watch, babysit, audit, review, compare, or fix another agent's work from a Codex session ID, Claude Code session/transcript, chat/thread link, PR, branch, log, or pasted run summary. Monitor until the other agent is done or blocked, reconstruct what the user asked, inspect what the agent actually changed and verified, report gaps, and optionally make scoped fixes when the user authorizes repair.

BuilderIO/efficient-fable

Use when running Claude Fable on codebase-heavy or token-heavy work and the user wants Fable to orchestrate research, coding, and testing while cheaper subagents do bounded heavy lifting.

BuilderIO/efficient-frontier

Apply the same orchestration as `/efficient-fable` to any high-cost frontier model: delegate research, coding, and testing to cheaper subagents while keeping planning, synthesis, and final review with the expensive model.

BuilderIO/plow-ahead

Use when the user explicitly wants autonomous progress without routine clarification stops: "plow ahead", "do not stop", "use your best judgment", "keep going until done", "finish while I am away", "do not ask questions unless truly blocked", or similar. Convert ordinary ambiguity into stated assumptions, proceed through implementation and validation, stop only for true blockers, and end with a clear recap of decisions, changes, verification, and residual risk.

BuilderIO/quick-recap

Use when adding or following the red/yellow/green final status block convention for agent responses, especially by installing managed AGENTS.md or CLAUDE.md instructions.

BuilderIO/read-the-damn-docs

Use when implementing, integrating, upgrading, debugging, or answering anything involving third-party APIs, libraries, frameworks, CLIs, cloud services, model/provider SDKs, fast-moving product behavior, user requests for latest/current/official behavior, unfamiliar repo docs/specs, errors that may indicate API drift, or high-stakes auth, security, billing, data, migration, deployment, compliance, or privacy behavior. Forces Codex to web-search for current official docs and read primary docs before assuming from memory.

BuilderIO/stay-within-limits

Use when long-running or parallel agent work must respect 5-hour and weekly usage limits by checking usage between waves, pausing near the cap, and resuming only when the window is clear.

BuilderIO/visual-plan

Turn ordinary text plans into rich interactive visual plans with diagrams, file maps, annotated code, open questions, and UI/prototype review when useful.

BuilderIO/visual-recap

Turn a PR, branch, commit, or git diff into an interactive visual recap with diagrams, file maps, API/schema summaries, annotated diffs, and focused review notes.

相關技能