show-grill-clearly

清晰呈現 Grill

將既有的 grill 決策集轉換為瀏覽器交接流程。此輔助工具收集決策；不會發掘事實，也不會代替使用者做決定。

1. 確認交接

以既有的 grill 交接內容作為證據界線。只有在至少有一項由使用者決定、尚未解決且會影響行為、合約、資料或工作流程的決策，且交接內容已足以支援誠實呈現選項及其後果時，才繼續。如果證據不足，請整理一份完整的缺漏清單交給負責的 grill，然後停止。

任何時候都可接受直接在聊天中提供的答案；請依照同一決策集核對答案，不要強迫使用者使用瀏覽器輔助工具。

2. 整理決策集

將已確認的事實保留在 recap，並將每個尚未解決的重要事項放入 questions。絕不重新開啟已確認的決策，也不要將未解決事項藏在背景脈絡中。依照相依關係妥善排列問題，並將包含不同決策的問題拆開。

針對每個問題：

• 將 grill 的問題改寫為 sourceQuestion，讓讀者不看逐字稿也能據此做決定。保留所有會影響答案的內容——利害關係、具約束力的限制、最壞情況——並刪除敘述、重述，以及其他欄位已涵蓋的背景資訊。如果承載決策的內容仍然過多，表示該問題包含多項決策：應拆開，而不是刪減內容。
• 加入一個具體的 scenario、最多三項與決策相關的 context 事實，以及二至四個可明確區分的選項。這些內容用來說明決策，絕不可取代或重新定義決策。
• 在每個選項的 note 中說明具體影響或成本。
• 只有在既有證據足以支持時才加入 recommendation。推薦僅供參考，絕不可預先選定。

使用繁體中文撰寫面向使用者的文字，同時保留精確的技術文字。讓輔助文字易於瀏覽，但不可削弱原始問題或其後果。

3. 建置並開啟

assets/questionnaire-template.html 是呈現器及互動規格。其內嵌驗證是負載欄位、識別碼、限制及結構完整性的唯一準則；不要在此重述這些機械性規則。

使用檔案寫入工具，將決策資料寫成 JSON 負載檔案，並存放在作業系統的暫存目錄中，接著執行符合目前作業系統的建置工具。路徑皆相對於此技能目錄。

建置工具只接受檔案路徑。絕不可透過 heredoc、echo 或 -c 將負載直接寫入 shell 命令：長度超過約 8 KB 的 shell 命令會在傳輸過程中遭截斷，並因 shell 語法錯誤而失敗，但在工具外執行同一命令卻會成功。絕不可手動編輯範本，也不可用先前的問卷取代建置工具，將其當作範本。

Windows：

powershell.exe -NoProfile -File scripts/build-questionnaire.ps1 -Data <payload.json>

macOS：

sh scripts/build-questionnaire.sh <payload.json>

每個建置工具都會在暫存位置產生一個獨一無二、自包含的 HTML 問卷，位置不在儲存庫、已安裝的技能或共用狀態中，接著會在預設瀏覽器中開啟。請將輸出的 ARTIFACT=<path> 視為交付保證，並將 LAUNCH=accepted|failed 視為該產物最後的瀏覽器啟動狀態。若啟動失敗，則改為提供可點擊的產物路徑，不因此判定交接失敗。

4. 交還並暫停

回覆可點擊的產物路徑及建置工具的啟動結果。請使用者回答、選取 整理回復 prompt，並將結果貼回原始對話。暫停負責的 grill。

收到回覆後：

• 遵從明確的選擇及補充說明。
• 依照回覆本身的意思解讀只有備註的回覆；若其中沒有明確無歧義的決定，則維持該問題未解決。絕不可代以顯示的指引。
• 不論 required、推薦內容或急迫性為何，所有未填答的問題都維持開啟。
• 一起確認所有尚未解決的問題。只有在沒有未解決問題時，或使用者明確接受其餘顯示的推薦時，才恢復原始工作流程。