ui-spec-writer
UI Spec Writer
將截圖或功能描述轉換為標準 spec Markdown 格式。格式核心是「口語化敘述 + ASCII 畫面示意」,讓開發者快速理解異動範圍、畫面結構與欄位規格。
請參考格式範例:example-output.md 詳細格式規則請參考:format-conventions.md
觸發時機
- 使用者提供 UI 截圖或 wireframe
- 使用者貼上 PM 的文字需求或功能說明
- 使用者要求整理某功能的 spec 文件
輸出原則
- 口語化:用自然的中文描述「這個頁面是什麼、怎麼運作」,避免條列式標題堆疊
- ASCII 示意:有視覺佈局的區域(卡片、列表列、過濾器排列)一律用 ASCII 畫出
- 差異描述優先:相似頁面只描述「與 X 頁相同,但...多一個...」,不重複全文
- 欄位附帶 component 標注:格式為
欄位名稱 (component類型, 附加說明)
輸出步驟
Step 1:識別輸入類型
判斷輸入屬於哪種類型:
- 新增功能模組:整個子系統(有多個子頁面)
- 單一頁面:列表頁、設定頁、紀錄頁
- 表單 / 編輯頁:欄位設定
- 局部 UI 元件:Drawer、Modal、卡片、過濾器
Step 2:確認文件結構
按照以下層級組織文件:
開頭段落 → 說明這次異動的整體範圍(不用標題)
### 頁面名稱 → 每個主頁面一個 H3
#### 子頁面 → 編輯頁、Drawer 等用 H4
Step 3:撰寫各段落
為每個頁面按照 format-conventions.md 撰寫:
- 頁面整體描述(1-2 句口語說明佈局方式)
- ASCII 示意圖(若有視覺結構)
- 邊界條件與空值說明
- 表單欄位列表(含 component 標注)
- 相似頁面的差異描述
Step 4:輸出 Markdown
直接輸出完整的 .md 文件內容,或依使用者指示建立檔案。
More from proladon/agent-vault
staged-task-execution
Use when requirements or change scope is large, complex, or spans multiple files/components. Creates a temp/ session folder with tasks.md (atomic task breakdown) and progress.md (context tracking), then executes one task at a time with user confirmation between each step. Use for: large feature implementation, multi-component refactoring, complex bug fixes with many steps, migration work, or any request that involves more than 2-3 independent changes. Trigger phrases: step by step, staged, one at a time, don't rush, large feature, big change, 分步執行, 逐步完成, 一步一步, 分階段, 大功能, 大改動, 不要一次做完, 慢慢來, 確認後再繼續, 按步驟. Resume phrases: continue where we left off, resume, pick up from last task, 繼續上次, 繼續執行, 繼續做, 從上次繼續, 接著做
11ui-spec-list-writer
將截圖或功能規格描述轉換為模組異動條列 spec 的 Markdown 文件。Use when: 使用者提供截圖、口語描述、UI 規格、設計稿,需要產出以 justify/new 標記異動類型、條列各範圍改動細節的 spec md 檔。觸發情境:模組調整文件、異動條列化、spec 轉換、功能改動記錄、巡邏 UI 改動、dashboard 模組異動。
1