# Milktea Skills Report

> 在產出既有專案架構健檢或實作完成報告時，以精簡結論、必要圖表與可展開證據整理繁體中文 HTML 報告。由報告產出流程載入；不套用於平常問答、需求或架構確認摘要。

- Skill: `royalmilkteamaster/milktea-skills-report` (Agent Skill)
- Install (CLI): `npx skillmds@latest add royalmilkteamaster/milktea-skills-report`
- Raw SKILL.md: https://api.skillmd.com/api/skills/royalmilkteamaster/milktea-skills-report/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: RoyalMilkteaMaster (https://skillmd.com/u/royalmilkteamaster)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/royalmilkteamaster/milktea-skills-report

---


# 奶茶流報告呈現

只整理報告的呈現方式。必填內容、證據要求、儲存位置、核准與交付流程均沿用呼叫方；不新增報告、副本或核准關卡，不因精簡而省略必填資訊。呼叫方有更具體的報告契約時，保留其要求。

## 表達規則

- 全文使用繁體中文與白話短句；程式識別字、技術名稱、命令與實際路徑保留原文。
- 開頭直接說明本次範圍、結論或成果，以及需要使用者決定或確認的事項，省略長篇前言與操作流水帳。
- 選擇能說清楚重點的最小表示方式；一句話足夠就用短句，不為視覺化硬畫圖，也不硬湊章節或圖表數量。
- 一個概念只說一次，圖表旁只補必要解釋，不把圖表內容重新寫成長段文字。
- 未完成、重要風險、未知、未驗證與待確認事項直接呈現在正文，不藏進折疊區，也不把推論寫成已確認成果。
- 完整命令、測試輸出、逐項執行設定與較長證據放入 `<details>`，以清楚標題說明展開後的內容；正文保留結果、影響與證據入口。

## 選擇呈現方式

| 要說明的內容 | 優先形式 |
|---|---|
| 判斷邏輯或演算法 | 精簡虛擬碼（Pseudocode） |
| 執行順序或呼叫關係 | 呼叫樹（Call Tree），呈現哪個函式呼叫哪個函式 |
| 畫面組成與狀態邊界 | 元件樹（Component Tree），呈現畫面由哪些元件組成及其包含關係 |
| 檔案位置與模組責任 | 附繁體中文用途備註的淺層目錄樹（File Tree） |
| 元件互動、控制流程或資料流 | Mermaid 流程圖（Flowchart）或循序圖（Sequence Diagram） |
| 方案、責任、需求完成狀態或驗證結果 | 精簡表格（Table） |
| 修改前後差異 | 前後對照（Before/After）或差異片段（Diff）；大部分為新內容或省略會誤解時，顯示完整的必要區塊 |
| 圖表難以說明的畫面、版面或狀態比較 | 在同一份 HTML 中加入聚焦的視覺區塊（HTML Visual） |

只保留與本次報告相關的節點、欄位、狀態與邊界。使用真實標籤與已查證資料，不捏造數字或修改前結果。

## HTML 呈現

- 在呼叫方指定的同一份 HTML 中呈現，支援桌面與窄螢幕；已有產品視覺風格時沿用其配色、字體與間距，沒有時使用白底深色文字、系統字體、清楚標題與適當留白的簡潔版面。
- 圖表無法載入時，仍能從相鄰短句或表格理解結論；不只用顏色傳達狀態。
- 完成前確認報告可開啟、正文精簡、細節可展開，且呼叫方要求的資訊完整保留。