deliver-reportlisted

# deliver-report — 交付訊息產生器 > 使用者常要把一批 session 產出（報告、Excel、log、設定檔…）交付給他的收件人。**格式與語氣固定，內容依當次產出而定。** 這個 skill 只負責把當次產出寫成那段訊息。 > > **三個鐵則**：①**收件人沒指定就寫 `Hi，`，永遠不留 `<收件人>` 這種佔位符**（忘了改會很難看）。②**預設讀者不懂技術**——寫給主管/客戶/業務看的，用白話，術語只留在給工程端的那一檔。③**這是對外說明，嚴禁任何內部術語/流程字眼**（紅藍對抗、QA、code-review、adopt/bump/publish、skill、plugin、session、AI…）——只講交付物與結論，不講我方怎麼做出來的。 ## 何時用 / 何時不用 **該用**：一批檔案已產好、要寫一段訊息把它們交給收件人（客戶、工程端、主管）。典型是分析報告 + 明細 + 原始資料 + 實作/設定檔的組合交付。 **不該用**：還在做分析、檔案還沒定案（先把東西做完）；單一檔案隨手丟一句話就好（不需要正式交付結構）；要寫的是內部技術文件本身而非「交付說明」（那是寫文件，不是交付訊息）。 ## 第一步：蒐集這次要交付什麼 在動筆前，先從 **本次 session 的產出** 湊齊這些資訊。能從上下文推出來的就自己填，缺的才問使用者——一次把缺的問完，不要逐項來回。 必要素材： 1. **收件人**：若使用者這次有講收件人（例如「給 Jerry」），就寫 `Hi Jerry，`。**沒講就直接寫 `Hi，`**——絕不輸出 `Hi <收件人>，`、`Hi ___，` 這類佔位符（忘了改會很難看）。乾淨的 `Hi，` 本身就成立，寧可留白也不留佔位符。 **順帶判斷收件人是單類還是多類**：若收件人涵蓋多種角色（業務端＋工程端＋第三方單位…）且各自只需要讀這批檔案的一部分，記下「每類受眾 × 各自關心哪幾份 × 各自的關鍵重點」——這決定你要用多受眾分流型（見選型規則）。 2. **這批是什麼＋幾份檔案**：一句話講清主題與檔案數，例：「這次的 AWS WAF 規則封鎖分析，共五份檔案」。 3. **逐檔清單**：每個交付檔案的 **檔名 + 一句白話說明**。說明要回答：這份是什麼、給誰看、要去這份查什麼。 4. **背景與範圍**：資料從哪來、涵蓋範圍（時間區間 / 筆數 / 樣本數）、以及**帶數字的重點結論**。 5. **跟上次的差異（選填）**：若有前一版，寫數量/結論怎麼變、**為什麼變**（別只報數字，要給原因）。沒有前版就整段省略。 6. **導讀動線**：告訴收件人先看哪份抓全貌 → 要查細節翻哪份 → 各份的定位。 7. **收尾**：一句「有問題再跟我說」＋「謝謝！」類的輕鬆收束。 > 檔名照使用者實際產出的檔名寫（含版本號，如 `_v1.1`）。 ### 順手整理交付清單（寫訊息前先做） 寫訊息前，先把這批要交付的檔案整理清楚——這一步是為了讓逐檔清單正確、也順便替使用者把關： - **列出實際檔案**：從本次 session 產出、或使用者指定的資料夾，把要交付的檔案抓出來（用檔案工具實際看，別憑記憶）。列給使用者確認「這批就是這些、沒有多也沒有漏」。 - **檢查命名/版本一致性**：同一批交付的版本號應一致（例如都是 `v1.1`）。若出現 `v1.1` 混 `v1` 這種不一致，**明講哪幾份不一致**、問使用者是刻意的還是漏更版，別默默照抄。