ask-questions-if-underspecified

ask-questions-if-underspecified 技能是 AI 代理的重要工具，旨在確保在執行可能錯誤的技術工作前與使用者意圖保持一致。透過系統化分析請求，代理能識別關於專案目標、驗收標準、範圍、技術限制、環境要求或安全性風險的缺失細節。此技能可防止代理走錯方向，有效減少返工、浪費的 token 以及因過早假設而導致的潛在系統錯誤。它專為需要維持高精確度的 AI 輔助程式碼生成與系統修改任務的開發者、專案經理及安全性稽核員所設計。代理將作為護欄，在獲得足夠清晰度或明確的使用者核准前暫停操作。

• 針對目標、完成定義、範圍、限制與環境變數等關鍵標準，對模糊性進行結構化評估。

• 產生簡潔、易於掃描的 1-5 個必要問題集，以最小化使用者的互動摩擦來填補知識差距。

• 利用選擇題格式、建議預設值與快速回應路徑，使互動效率達到最高。

• 實施安全優先的工作流程：在關鍵未知事項獲得處理前，不會執行命令或修改檔案。

• 在澄清後明確重述需求，確保代理與使用者在開始實作前達成完美同步。

• 每當請求缺乏明確成功標準，或若執行錯誤會帶來高風險時，請觸發此技能。

• 使用它來強制執行專案限制，例如特定的語言版本、函式庫相依性或部署環境。

• 若 codebase 中已存在相關資料，代理會優先選擇執行低風險的探索動作（如檢查 package.json、requirements.txt 或 YAML 檔案），而非直接提問。

• 若使用者要求立即採用推測性的處理方式，代理將以條列式清單記錄其假設，並在執行前要求確認，確保所有動作皆可審計與還原。