Spec → 模組異動條列 Markdown

When to Use

• 使用者提供截圖或文字描述某個模組的改動
• 需要將改動整理成條列式 spec 文件
• 文件格式採用 justify（既有功能調整）或 new（新增功能/元件）標記每個異動範圍

Output Format

每個異動範圍輸出一個頂層 bullet，結構如下：

- {change-type} - {範圍/頁面名稱}
  - {功能區塊}
    - {具體改動的 UI 元素}
      - {細節：顯示條件、文字內容、互動行為、格式說明等}

change-type 對照：

標記	用途
justify	調整、修改、擴充既有功能或 UI 元素
new	全新新增的功能、頁面、Drawer、區塊、元件

完整格式範例請參考 format-example.md。

---

Procedure

Step 1 — 識別輸入類型

截圖輸入：分析圖片中的 UI，識別：

• 改動影響的頁面 / 模組 / 元件名稱
• 哪些是新增元素（按鈕、欄位、區塊、Drawer、tab）
• 哪些是修改現有元素（改名、新增選項、新增 tooltip、改版）
• 觸發條件與顯示邏輯

文字描述輸入：從描述中提取相同資訊。

資訊不足時在繼續前先詢問：

• 這是調整既有功能（justify）還是全新新增（new）？
• 影響的頁面或元件完整名稱？

---

Step 2 — 分類 change-type

對每個異動範圍判斷標記類型：

• justify：修改現有按鈕名稱、新增 tooltip/選項/欄位到已存在元件、調整顯示條件
• new：完全新建的 Drawer、Tab、區塊、頁面、獨立元件

同一頁面內可以同時包含 justify 和 new 子區塊，依實際異動類型分開列出。

---

Step 3 — 建構條列階層

按以下層級組織內容（使用 2 空格縮排）：

層級	內容
Level 1	- {change-type} - {異動範圍名稱（附頁面/元件說明）}
Level 2	功能區塊 / 頁面章節（如「頂部資訊區塊」、「{名稱} tab」）
Level 3	具體改動的 UI 元素（欄位名稱、按鈕、子區塊標題）
Level 4+	細節：tooltip 文字、選項名稱、顯示條件、互動行為、數值格式

層級越深表示越細節，不必強制 4 層，以結構清晰為準。

---

Step 4 — 撰寫細節規則

需明確記錄的細節類型：

類型	寫法
Tooltip 文字	獨立 bullet，精確引用文字，以 tooltip: 開頭
顯示條件	顯示條件: {條件描述}
按鈕行為	點擊後開啟「{名稱}」 / 點擊後 {動作}
數值格式	附具體格式範例，如 NT$ {累計金額} / {目標金額}
狀態 tag 變化	列出每個狀態值與對應條件
元件排列方式	說明輪播 / grid / 並排等佈局
原名稱改動	原 {舊名} 按鈕改名為 {新名}
選項新增	新增選項: {選項名稱}

---

Step 5 — 輸出與確認

輸出完整 bullet list 內容（不加頁面標題，不加額外的 markdown heading）。

若存在以下情況，輸出後主動詢問：

• 改動類型不確定是 justify 還是 new
• 顯示條件或觸發邏輯不清楚
• 某個元素的精確名稱不確定