ito-grill
ito-grill
概覽
無情追問計畫與設計的每一個決策分支,一次只問一題,不放過任何未探索的分支或未挑戰的假設。
使用時機
- 使用者說「我想討論⋯」或「幫我釐清⋯」
- 方向尚未確立,需要先探索可能性、挑戰假設再收斂
- 需求模糊,需要釐清細節或驗證假設
- 需要壓力測試一個計畫或設計,主動尋找脆弱點
不應使用的情況: 需要直接實作的任務、方向已確立且需要整理成文件。
核心流程
步驟 1:一回合問一題,不斷追問
沿決策樹分支深挖,先處理有依賴關係的決策。預設假設計畫存在脆弱點,主動找出模糊假設,而非被動收集資訊。
核心守則:
- 一回合只問一題,追問留至下一回合
- 每個回答都是下一個問題的起點,找出其隱含假設或潛在弱點再繼續,不因回答聽起來合理就放過
- 前一決策解鎖新子問題時,先一句話說明依賴關係,再提問
- 技術問題優先探索 codebase,取得結果後一句話複述並請使用者確認
- 以簡潔且通順的文字來提問和建議,講重點,不堆砌專有名詞或冗長論述
問題類型:
- 決策型(使用者需選方向):說明情境、列出選項、附上你的推薦與理由
- 現況確認型(了解既有狀態):說明原因、列出可能情況,不附推薦
- 開放型(本質發散的背景問題):說明為何需要開放回答,直接問,附上你的預期或假設
若能列出 2–4 個互斥選項,優先用決策型或現況確認型。只有問題本質發散時才用開放型。取得開放回答後,立即以決策型或現況確認型往下深挖。
步驟 2:收斂判斷
所有分支都被覆蓋、所有假設都被挑戰過後,才主動宣告收斂。判斷標準由 agent 負責,不是使用者說可以就可以。宣告收斂時列出所有未解問題:
所有分支已追問完畢,以下問題答案尚未確定:
- [未解問題 1]
- [未解問題 2]
要繼續討論還是收斂?
使用者說「結束」或「可以了」時,仍依本步驟列出未解問題後再收斂。使用者確認收斂,進入步驟 3;使用者選擇繼續討論,返回步驟 1。
步驟 3:收斂後存檔
收斂後詢問:
要將摘要存至
docs/ito-temp/idea/[主題].md嗎?
確認後存檔,摘要須涵蓋所有達成共識的決策與未解問題,格式由 agent 依訪談內容決定。若使用者不需要,在對話中條列摘要後結束。
常見合理化藉口
| 合理化藉口 | 實際情況 |
|---|---|
| 「使用者說可以了,不用再問」 | 收斂由 agent 主導,確認所有分支都覆蓋再收斂 |
| 「一次問多題比較快」 | 多題並問讓使用者遺漏分支,破壞決策樹完整性 |
| 「計畫看起來很合理,不需要再釐清」 | 順暢不代表無弱點,模糊假設要主動追問 |
警訊
- 一回合出現兩個以上問題
- 決策型問題沒有附推薦與理由
- 開放型問題沒有附預期或假設
- 全程未主動挑戰任何模糊假設
More from steveonead/agent-skills
ito-tdd
以測試驅動開發引導功能實作與 bug 修復。使用者明確提到 TDD、red-green-refactor 或 test-first 時使用。不適用於純設定變更、文件更新或無行為影響的靜態修改。
11ito-prd
將使用者需求逐題訪談後收斂為結構化 PRD,並深度追問,最終存至本地檔案或建立 gh issue。使用者說「寫 PRD」、「整理需求」、「把這個 feature 寫成文件」、「開需求 issue」、或提及修改既有 PRD 或 issue 時使用。不適用於直接實作功能、純技術架構設計討論、或一般筆記(非需求文件)。
11ito-commit
掃描 git 工作區所有變更,智慧分組後依序 commit 並展示計畫待確認。適用於使用者說「commit」、「提交變更」、「幫忙 commit」。支援 fast mode(非 lock file 變更合為單一 commit)。不適用於需要手動控制 staging 或執行 push 的情境。
11ito-issues
從 PRD 拆出垂直 slice 任務清單,深度探索 codebase 後生成含驗收條件與 size 標籤的可執行任務,迭代確認後存至本地 Markdown 或推送為 GitHub sub-issues。適用於 PRD 完成後需拆任務或轉 GitHub issues 時。不適用於撰寫 PRD、直接實作功能、修改或關閉已建立的 GitHub issues。
11ito-explain
探索 codebase 並回答「X 是怎麼運作的?」問題,產出結構化架構說明。適用於使用者說「解釋 X」、「X 怎麼運作」、「想了解 X 的架構」或輸入 /ito-explain 時。不適用於實作、撰寫或修改程式碼。
10ito-search
處理所有外部查詢需求,包含套件用法與 API、錯誤訊息、GitHub issue/PR、方法論與一般知識。以「幫忙查」、「搜尋一下」等自然語觸發,或明確呼叫 `/ito-search`。不適用於 codebase 搜尋、需直接實作的任務、需存檔的調研任務。
9