SuperAPI AI 工具集

plan-review

通用与其它

查看项目

更新于 10-16 08:08

技能介绍

用途:在實作前審查計畫本身(任務拆解、方向、風險、範圍),而非程式碼審查;程式碼層面審查另有 /code-review。適用於 codex-plan 產出、plan mode 計畫或任何實作計畫文件。觸發詞為 /plan-review、review plan、審查計畫、檢視計畫。

主要能力:Step 0 定位計畫與選擇深度。計畫定位依序為 ARGUMENTS 指定路徑、當前目錄 codex-plan.md、.claude/plans/ 取最新 .md,皆無則用 AskUserQuestion 詢問。讀取計畫後摘要核心目標(1-2 句)確認對象,並讀取計畫提到的 Target Files/修改檔案。深度分兩級:深度審查每段最多 4 個議題,適合大型功能或架構變更;快速審查每段最多 1 個議題,適合小改動或時間有限。

四段審查:第一段完整性,檢查任務拆解是否細到一次 commit 可完成、依賴關係是否正確、是否遺漏 DB migration/config/環境變數/文件更新、Mermaid 依賴圖是否反映實際依賴。第二段方向性,檢查現有程式碼是否已能解決問題(最高優先),架構模式是否適合規模、技術選型是否合理、修改檔案清單是否正確、API/介面設計是否清晰一致。第三段風險,檢查高風險步驟與失敗後果、有無 rollback 或漸進式部署(feature flag、canary)、向後相容、測試策略是否覆蓋關鍵路徑與邊界案例。第四段範圍,檢查是否超出需求、工程是否不足、任務粒度與複雜度估算是否合理、是否明確列出 NOT in scope。每段完成後用 AskUserQuestion 確認決策才進下一段。

議題呈現格式:每議題含問題描述(指出計畫中的 task/step,可引用檔案路徑)、2-3 個選項(含不處理,各標明對計畫影響、風險變化、實作成本變化)、建議選項及理由。

Step 5 輸出計畫審查摘要表格與建議修訂清單,並建議補入 NOT in scope 項目。

限制:資料未提供安裝方式、平台、收費或價格資訊。使用時須由使用者指定或提供計畫來源。