docs: enhance LLM execution guidelines to prevent common pitfalls and improve task efficiency

.github/copilot-instructions.md

@@ -51,6 +51,29 @@
 - 優先保持向後相容；新增資料來源或輸入項時參考 `spec/04-extensions.md`。
 - 避免將關鍵邏輯（如批次策略、資源查詢）分散於多處；若需重構，提供明確的入口函式或工廠（參考 `04-extensions.md` 工廠模式）。
 
+## LLM 執行防護（預防常見陷阱）
+
+### 避免無限驗證迴圈
+- **問題**：執行完檔案操作後，開始重複執行 `ls`, `wc -l`, `find`, `file` 等驗證命令
+- **預防**：
+  - 每個主要任務完成後**立即停止**，不進行驗證
+  - 若需驗證，由用戶在後續對話中明確要求
+  - 單個工具呼叫的驗證可以（如 `get_errors` 檢查編譯），但連環的驗證命令應停止
+
+### 避免生成不必要的報告
+- **問題**：執行 `/project.init` 等明確指定「不產生報告」的命令後，卻自動生成總結 markdown
+- **預防**：
+  - 明確檢查指令的「限制」與「不做」清單
+  - 若指令說「完成後直接返回」，就真的直接返回
+  - 報告只有在用戶**明確要求**時才生成
+
+### 避免過度消耗 token
+- **問題**：為了「確保完美」而執行多個驗證步驟，造成 token 浪費
+- **預防**：
+  - 優先相信檔案操作工具成功（除非有明確錯誤訊息）
+  - 避免為了「心安」而重複讀取剛建立的檔案
+  - 單輪對話內集中驗證，而非分散於多個工具呼叫
+
 ## 提交前檢查
 
 commit 前確認以下兩點：
@@ -87,10 +110,20 @@ commit 前確認以下兩點：
 ### `/project.init`（一次性初始化 — 僅用於既有專案無規格文件時）
 - **目的**：為既有專案（Brownfield）從無規格的狀態，快速生成模塊化規格檔案（`spec/00-overview.md` 至 `spec/04-extensions.md`）與迭代計畫模板（`spec/plan.md`）。
 - **限制**：此命令為一次性初始化，**應該只產生必要的規格與計畫文件，不產生總結報告或分析文檔**。初始化完成後無需進一步的報告文件。
+- **執行檢查清單**（防止重複驗證與報告生成）：
+  - ❌ **不做**：生成總結報告、比較表、驗證文檔
+  - ❌ **不做**：執行 `ls`, `wc -l`, `file`, `find` 等驗證命令
+  - ❌ **不做**：使用 `show_content` / `open_file` 顯示生成結果
+  - ❌ **不做**：重複讀取已建立的檔案確認內容
+  - ✅ **只做**：
+    1. 掃描現有程式碼結構
+    2. 建立 5 份規格 + 2 份計畫檔案
+    3. 更新 `change-log.md`
+    4. 直接結束，不進行任何驗證
 - **流程**：
   1. LLM 掃描現有程式碼結構，分析核心模組與資料流。
   2. 根據代碼分析，逐一填充 5 份模塊化規格文件（`spec/00-*` 至 `spec/04-*`）與計畫模板。
-  3. 完成後直接返回（無總結文檔）；如需驗證規格內容，用戶可在後續對話中執行 `/project.spec` 或 `/project.plan`。
+  3. 完成後**直接返回**（無總結、無驗證、無報告）；如需驗證規格內容，用戶可在後續對話中執行 `/project.spec` 或 `/project.plan`。
 
 ### `/project.spec`（需求改變時用）
 - **目的**：調整 spec 的大方向、契約或不變條件。與現有程式碼做比較，列出後續工作清單。