Refactoring重構教學

Refactoring(重構)教學手冊 文件版本:v2.0(2026-10-13) 作者:資深軟體架構師團隊 適用對象:Java/TypeScript 開發人員、Tech Lead、程式碼審查者、使用 AI 程式助理的工程師 技術基準:Java 25 LTS、JUnit 6、Maven 3.9、TypeScript 6/7、IntelliJ IDEA 2026.2(詳見 0.3) 定位:教學手冊——以「把人教會」為目標,每個觀念都有逐步操作、可執行的範例與練習;規則以 RFT-* 編號,可直接當作審查 AI 產出的檢核依據 目錄 0. 文件資訊與學習指南 0.1 為什麼要學重構 0.2 讀者與學習路徑 0.3 技術基準版本 0.4 規則格式與驗證圖示 0.5 範例的閱讀方式 0.6 與其他文件的關係 0.7 名詞約定 1. 重構基本概念 1.1 什麼是重構 1.2 可觀察行為的界定 1.3 重構的目標與效益 1.4 重構與其他變更的區別 1.5 國際標準與業界參考 1.6 實務案例:一次「不是重構」的重構 2. 重構的基本原則 2.1 兩頂帽子 2.2 小步前進與每步驗證 2.3 重構的時機 2.4 何時不該重構 2.5 安全重構的流程 2.6 Tidy First:整理的經濟學 2.7 實務注意事項 3. 識別壞味道(Code Smells) 3.1 什麼是程式碼壞味道 3.2 Fowler 第二版的 24 種壞味道 3.3 膨脹類壞味道 3.3.1 過長函式(Long Function) 3.3.2 過長參數列(Long Parameter List) 3.3.3 過大類別(Large Class) 3.3.4 資料泥團與基本型別偏執(Data Clumps/Primitive Obsession) 3.4 阻礙修改類壞味道 3.5 耦合類壞味道 3.6 可有可無類壞味道與註解 3.7 資料與狀態類壞味道 3.8 壞味道的量化指標 3.9 壞味道識別工具 3.9.1 靜態分析工具 3.9.2 IDE 內建工具 4. 基本重構手法 4.1 提煉函式與內聯函式(Extract Function/Inline Function) 4.2 提煉變數與內聯變數(Extract Variable/Inline Variable) 4.3 改名(Rename Variable/Rename Field) 4.4 改變函式宣告(Change Function Declaration) 4.5 引入參數物件(Introduce Parameter Object) 4.6 封裝變數、以查詢取代暫存變數與拆分變數 4.7 搬移語句與拆分迴圈(Slide Statements/Split Loop) 4.8 以具名常數取代魔術字面值(Replace Magic Literal) 4.9 拆分階段與函式組合(Split Phase/Combine Functions into Class) 4.10 以命令取代函式(Replace Function with Command) 4.11 重構方法選擇流程 4.11.1 重構決策樹 4.11.2 重構優先順序指南 5. 搬移特性與組織資料 5.1 搬移函式(Move Function) 5.2 搬移欄位(Move Field) 5.3 提煉類別與內聯類別(Extract Class/Inline Class) 5.4 隱藏委託與移除中間人(Hide Delegate/Remove Middle Man) 5.5 以物件取代基本型別(Replace Primitive with Object) 5.6 移除無用程式碼(Remove Dead Code) 5.7 封裝集合與封裝記錄(Encapsulate Collection/Encapsulate Record) 5.8 值物件與參照物件、以查詢取代衍生變數 6. 簡化條件邏輯 6.1 分解條件式(Decompose Conditional) 6.2 合併條件式(Consolidate Conditional Expression) 6.3 以衛述句取代巢狀條件式(Replace Nested Conditional with Guard Clauses) 6.4 以多型取代條件式(Replace Conditional with Polymorphism) 6.5 引入特例(Introduce Special Case) 6.6 引入斷言與以 break 取代控制旗標 7. API 與繼承重構 7.1 將查詢與修改分離(Separate Query from Modifier) 7.2 移除旗標參數與函式參數化(Remove Flag Argument/Parameterize Function) 7.3 保留完整物件與以查詢取代參數(Preserve Whole Object/Replace Parameter with Query) 7.4 以工廠函式取代建構式(Replace Constructor with Factory Function) 7.5 以例外取代錯誤碼(Replace Error Code with Exception) 7.6 繼承結構重構:上移、下移、提煉父類別與摺疊階層 7.7 以委託取代繼承(Replace Superclass/Subclass with Delegate) 7.8 公開函式庫的相容性檢查 8. 重構與測試:建立安全網 8.1 重構的安全網:為什麼測試是前提 8.2 特性測試(Characterization Test) 8.3 核准測試(Approval Test) 8.4 覆蓋率與變異測試 8.4.1 覆蓋率的意義與限制 8.4.2 用變異測試檢查安全網 8.5 重構友善的測試設計 8.6 等價性驗證:同一組測試驗證重構前後 8.7 重構測試檢查清單 9. TDD 與重構 9.1 紅燈—綠燈—重構循環詳解 9.2 實際 TDD 重構範例 9.3 重構測試程式碼 10. 遺留程式碼的重構 10.1 遺留程式碼變更演算法 10.2 接縫(Seam) 10.3 Sprout 與 Wrap:讓新程式碼保持可測試 10.4 打破相依的常用手法 10.5 Mikado 方法 10.6 探索性重構(Scratch Refactoring) 11. 大型與架構層級的重構 11.1 漸進式重構與大爆炸重寫 11.2 Strangler Fig 與平行執行 11.3 Branch by Abstraction 11.4 架構守護:用 ArchUnit 把規則寫成測試 11.5 功能旗標的生命週期 12. 資料庫與 API 的演進式重構 12.1 為什麼不能一次改名 12.2 擴充—遷移—收縮(Expand–Migrate–Contract) 12.3 API 的演進 12.4 事件與訊息格式的演進 13. Java 現代化重構 13.1 現代化的原則 13.2 sealed 型別與模式比對 switch 13.3 以 record 取代資料類別 13.4 以管線取代迴圈(Replace Loop with Pipeline) 13.5 Optional 的使用 13.6 文字區塊與其他語法 13.7 用 OpenRewrite 自動化現代化 14. 前端 TypeScript 重構 14.1 TypeScript 重構的安全網 14.2 以可辨識聯集取代型別碼 14.3 || 與 ??、&& 與 ?. 的差異 14.4 Promise 鏈改寫為 async/await 14.5 以 unknown 取代 any 14.6 以 codemod 進行大量修改 15. 重構工具與自動化 15.1 IDE 的自動化重構 15.2 靜態分析與品質門檻 15.3 CI 中的重構守護 15.4 編譯器警告與棄用追蹤 15.5 RefactoringMiner:在審查時辨識重構 15.6 工具選擇與配置 16. 效能與重構 16.1 重構與效能的關係 16.2 用 JMH 量測 16.3 效能監控與回歸 16.4 重構常見的效能退化 17. 團隊規範與最佳實務 17.1 重構的責任分配與協作 17.2 提交與 PR 的規範 17.3 程式碼審查中的重構 17.3.1 審查檢查清單 17.3.2 審查技巧:辨識搬移的程式碼 17.4 重構標準與約定 17.4.1 命名規範 17.4.2 程式碼組織約定 17.5 持續重構的團隊文化 17.5.1 重構意識培養 17.5.2 工具與流程整合 17.5.3 團隊重構最佳實務 17.6 重構培訓計畫 17.6.1 新人重構訓練 17.6.2 技能評估標準 18. AI 輔助重構 18.1 AI 輔助重構的機會與風險 18.2 給 AI 的重構提示 18.3 專案層級的 AI 指示檔 18.4 驗證 AI 產出的流程 18.5 AI 常見的重構錯誤 18.6 AI 代理的批次重構 19. 技術債管理與重構的度量 19.1 技術債與技術債象限 19.2 技術債登錄 19.3 熱點分析:決定先重構哪裡 19.4 重構的時機與投資配置 19.4.1 主動重構與被動重構 19.4.2 重構優先順序矩陣 19.4.3 容量配置 19.5 重構效益的評估與度量 20. 重構的反模式與常見陷阱 20.1 流程上的反模式 20.2 程式碼上的反模式 20.3 測試上的反模式 20.4 AI 協作的反模式 21. 綜合案例:活動票券對帳單 21.1 起點:需求與現有程式碼 21.2 建立安全網 21.3 重構步驟 21.4 重構後的程式碼 21.5 加入新功能 22. 練習與自我評量 22.1 能力評量架構 22.1.1 觀念能力 22.1.2 實作能力 22.2 觀念選擇題 22.3 情境分析題 22.4 程式碼重構實作題 22.4.1 Kata 1:會員點數(Java) 22.4.2 Kata 2:價格標籤(TypeScript) 22.5 AI 產出審查演練 22.6 綜合演練 22.7 評分基準 22.8 學習建議 23. 檢查清單 23.1 重構前檢查清單 23.1.1 環境準備 23.1.2 範圍評估 23.2 重構執行檢查清單 23.2.1 執行原則 23.2.2 常見重構步驟 23.3 重構後檢查清單 23.3.1 功能驗證 23.3.2 品質檢查 23.3.3 交付準備 23.4 緊急應對檢查清單 23.4.1 問題發現 23.4.2 修復策略 23.5 持續改善檢查清單 23.5.1 定期檢視 23.5.2 工具和流程優化 23.6 AI 產出審查檢查清單 附錄 A 規則總表 A.1 依領域統計 A.2 驗證方式與範例覆蓋 A.3 規則清單 附錄 B 手法速查表 B.1 Fowler 第二版重構目錄對照 B.2 依壞味道查手法 B.3 IDE 快捷鍵速查 附錄 C 設定檔與腳本 C.1 範例專案的 pom.xml C.2 PMD 規則集 C.3 Checkstyle 設定 C.4 GitHub Actions:重構型 PR 的守護流程 C.5 equivalence-check.sh C.6 refactor-guard.sh C.7 重構提案範本 附錄 D 名詞對照 附錄 E 參考資料 E.1 延伸閱讀:書籍 E.2 國際標準與規範 E.3 研究報告 E.4 線上資源 E.5 工具推薦 附錄 F 修訂紀錄與查證紀錄 F.1 v1.0 章節對照 F.2 v1.0 內容更正紀錄 F.3 查證紀錄 F.4 待確認事項 F.5 技術版本紀錄 0. 文件資訊與學習指南 0.1 為什麼要學重構 重構(refactoring)是「在不改變軟體可觀察行為的前提下,改善其內部結構」的一連串小步驟。它是每位工程師每天都在做的事,卻也最容易做錯: ...

October 31, 2025 · 149 min · 31539 words · Eric Cheng

spec-kit使用教學

Spec-Kit 使用教學手冊 版本: 18.0 最後更新: 2026年10月30日 適用於: Spec-Kit v1.2.5(2026-10-28 發布);指令與旗標以 v1.2.5 原始碼與官方文件為準 文件等級: 企業標準技術白皮書 Created by: Eric Cheng 摘要 Spec-Driven Development(SDD,規格驅動開發)把「規格」從容易過時的輔助文件,重新定位為驅動實作的主要工件:程式碼是規格的產物,規格不再只是事後補寫的說明。Spec-Kit 是 GitHub 以此理念開源的工具組。它的官方定位已從「SDD 工具」擴大為「讓 AI 編碼代理遵循結構化流程、可重用模板並留下可稽核成果的工具組」。目前內建三條彼此獨立的流程入口: 你要做的事 流程 成果 建立功能或應用程式 Spec-Driven Development(核心內建) 一份規格,經計畫、實作到收斂檢查 診斷並修復錯誤行為 Bug fixing(bug 擴充,選用) 有證據的根因、受控範圍的修正與驗證紀錄 判斷某個想法值不值得投入 Idea assessment(assess 擴充,選用) go/needs-clarification/kill 的證據化決策 此外,團隊可以透過 Extension、Preset、Workflow、Bundle 與 Catalog 五種機制,改造既有流程或組裝自己的流程。 本手冊面向在企業共用平台(多資料庫、微服務、微前端、批次與檔案傳輸整合)導入 AI 輔助開發的技術團隊。內容依「方法論 → 安裝與升級 → 守則與模板 → 核心流程 → 修錯與評估流程 → 客製化 → 企業治理 → 實務案例 → 常見陷阱 → 附錄」的順序展開。每一個環節都附上範例,以及「AI 產出後,人要如何審查與驗證」的具體檢查方法。全書以 Spec-Kit v1.2.5 為基準,逐項核對官方 README、spec-driven.md、docs/upgrade.md、CHANGELOG、文件站(github.github.io/spec-kit)與 v1.2.5 tag 的原始碼。核對過程與修正清單記錄在附錄 F。 ...

October 31, 2025 · 91 min · 19185 words · Eric Cheng

spec-kit使用教學

Spec-Kit 使用教學手冊 版本: 1.0 最後更新: 2025年10月29日 適用於: Spec-Kit v0.0.79+ Created by: Eric Cheng 📚 目錄 前言 目的與適用對象 背景說明:為何採用 SDD + Spec-Kit → AI 助手流程 本手冊使用假設 第一章:概念理解 1.1 SDD 是什麼? 1.2 Spec-Kit 概覽 1.3 SDD 中的關鍵 artefacts(工件) 1.4 流程概覽:SDD 的階段/步驟 1.5 為什麼這對我們團隊/共用平台開發特別有價值 第二章:環境準備 2.1 前置條件 2.2 安裝 Spec-Kit CLI 2.3 建立專案與初始化 2.4 建立團隊守則 (Constitution) 2.5 模板與提示文件說明 2.6 GitHub 倉庫分支與版本控制建議 第三章:使用流程詳細說明 3.1 Step 1:撰寫 Spec (/speckit.specify) 3.2 Step 1a:澄清模糊需求 (/speckit.clarify) 3.3 Step 2:撰寫 Plan (/speckit.plan) 3.4 Step 3:拆分 Tasks (/speckit.tasks) 3.5 Step 4:預實作檢查 (/speckit.analyze + /speckit.checklist) 3.6 Step 5:實作 (/speckit.implement) 3.7 Step 6:迭代維護 第四章:實務案例與應用指引 4.1 案例一:Greenfield 開發 - 新建交易記錄微服務 4.2 案例二:Brownfield 整合 - 為既有系統新增功能 4.3 團隊協作:多人開發 4.4 AI 助手最佳實踐 4.5 平台導入建議 第五章:常見問題與陷阱 5.1 常見問題(FAQ) 5.2 常見陷阱與避免方法 第六章:附錄 6.1 完整模板範例 6.2 檢查清單 6.3 參考資源 6.4 術語表 6.5 快速指令參考 結語 前言 目的與適用對象 本手冊旨在幫助開發團隊快速掌握 Spec-Driven Development (SDD) 方法論,並透過 Spec-Kit 工具組與 AI 助手協作,建立高品質、可維護的軟體系統。 ...

October 31, 2025 · 76 min · 16041 words · Eric Cheng

Spring Boot 教學

Spring Boot 教學手冊 文件資訊 作者: 技術團隊 版本: 1.0 更新日期: 2025-08-31 目標對象: 新進開發同仁、Spring Boot 初學者、認證考試準備者 目錄 Spring Boot 簡介 1.1 什麼是 Spring Boot? 1.2 Spring Boot 的核心特點 1.3 Spring Boot vs Spring Framework 1.4 專案常見應用場景 1.5 Spring Boot 版本選擇 1.6 章節小練習 1.7 實務注意事項 開發環境建置 2.1 系統需求 2.2 JDK 安裝與設定 2.3 Maven 安裝與設定 2.4 IDE 設定 2.5 Spring Initializr 使用 2.6 開發工具設定 2.7 專案建立實作 2.8 執行與測試 2.9 章節小練習 2.10 實務注意事項 Spring Boot 基礎 3.1 專案結構 3.2 Application Properties 設定 3.3 依賴注入 (Dependency Injection) 3.4 Spring Boot Starter 3.5 Bean 生命週期與作用域 3.6 Profile 環境管理 3.7 章節小練習 3.8 實務注意事項 RESTful API 開發 ...

October 31, 2025 · 52 min · 10928 words · Eric Cheng

Spring Framework教學

Spring Framework 教學手冊 目錄 Spring Framework 概述 1.1 什麼是 Spring Framework 1.2 Spring 生態系統 1.3 為什麼使用 Spring Framework 1.4 認證考點提示 1.5 實務案例 核心概念 2.1 控制反轉 (Inversion of Control, IoC) 2.2 依賴注入 (Dependency Injection, DI) 2.3 Bean 的概念 IoC 容器與依賴注入 3.1 IoC 容器深入解析 3.2 BeanFactory vs ApplicationContext 3.2.1 BeanFactory 3.2.2 ApplicationContext 3.3 Bean 定義與註冊 3.3.1 註解驅動的配置 3.3.2 Java 配置方式 3.4 依賴注入的進階特性 3.4.1 條件式注入 3.4.2 Qualifier 與 Primary 3.5 Bean 生命週期 3.6 ApplicationContext 事件機制 3.6.1 內建事件 3.6.2 自定義事件 3.7 認證考點提示 3.8 實務案例 Bean 管理 4.1 Bean 的作用域 4.1.1 Singleton 作用域 4.1.2 Prototype 作用域 4.1.3 Web 作用域 4.2 Bean 的初始化和銷毀 4.2.1 初始化方法 4.2.2 銷毀方法 4.3 Bean 的延遲初始化 4.4 條件式 Bean 創建 4.4.1 內建條件註解 4.4.2 自定義條件 4.5 Profile 環境配置 4.6 Factory Bean 模式 4.7 認證考點提示 4.8 實務案例 面向切面程式設計 (AOP) ...

October 31, 2025 · 73 min · 15420 words · Eric Cheng

SQL使用教學

SQL 使用教學手冊 目錄 1. SQL 基礎入門 1.1 什麼是 SQL? 1.2 SQL 的特點 1.3 SQL 語句分類 1.4 第一個 SQL 查詢 2. 資料庫基本概念 2.1 關聯式資料庫模型 2.2 基本概念解釋 2.3 資料類型 2.4 正規化(Normalization) 3. 基本查詢語法 3.1 SELECT 語句基礎 3.2 查詢所有欄位 3.3 查詢特定欄位 3.4 WHERE 條件查詢 3.5 排序 ORDER BY 3.6 限制結果筆數 3.7 去除重複 DISTINCT 4. 進階查詢技巧 4.1 聚合函數 4.2 GROUP BY 分組查詢 4.3 HAVING 分組篩選 4.4 JOIN 表格連接 4.5 子查詢(Subquery) 4.6 WITH 公用表格表達式(CTE) 4.7 視窗函數(Window Functions) 5. 資料操作語言 (DML) 5.1 INSERT - 新增資料 5.2 UPDATE - 更新資料 5.3 DELETE - 刪除資料 5.4 UPSERT - 插入或更新 5.5 批次處理最佳實務 6. 資料定義語言 (DDL) 6.1 CREATE - 建立資料庫物件 6.2 ALTER - 修改資料庫物件 6.3 DROP - 刪除資料庫物件 6.4 TRUNCATE - 清空表格 6.5 資料類型選擇指南 6.6 表格設計最佳實務 6.7 效能考量 7. 交易處理與併發控制 7.1 交易基本概念 7.2 交易控制語句 7.3 交易隔離等級 7.4 併發問題與解決方案 7.5 鎖定機制 7.6 實務交易處理模式 8. 索引與效能優化 8.1 索引基本概念 8.2 索引類型 8.3 索引設計策略 8.4 查詢效能分析 8.5 查詢優化技巧 8.6 分割與分片 8.7 效能監控與維護 9. 儲存程序與函數 9.1 儲存程序基礎 9.2 函數 9.3 控制流程結構 9.4 例外處理 10. 安全性與防護 10.1 SQL Injection 防護 10.2 存取控制與權限管理 10.3 資料加密 10.4 稽核與監控 11. 專案實務案例 11.1 電商系統資料庫設計 11.2 常用業務查詢 11.3 效能優化實作 12. 認證考試準備 12.1 Oracle SQL 認證要點 12.2 Microsoft SQL Server 認證要點 12.3 PostgreSQL 認證要點 12.4 IBM DB2 認證要點 12.5 認證考試技巧 13. 最佳實務與故障排除 13.1 常見錯誤與解決方案 13.2 效能優化建議 13.3 開發最佳實務 13.4 資源推薦 前言 歡迎來到 SQL 的世界!SQL(Structured Query Language,結構化查詢語言)是與資料庫溝通的標準語言。無論您是新進的開發同仁,還是希望深化資料庫技能的工程師,這份教學手冊都將帶您從零開始,循序漸進地掌握 SQL 的精髓。 ...

October 31, 2025 · 72 min · 15202 words · Eric Cheng

SSDLC_專案範本指南

SSDLC 專案範本指南 簡介 本指南提供安全軟體開發生命週期 (Secure Software Development Life Cycle, SSDLC) 的完整範本體系,旨在協助團隊透過 AI 輔助完成專案的各個階段開發任務。 SSDLC 階段概覽 1. 需求分析階段 (Requirements Analysis) 目標: 收集、分析並定義專案需求,建立安全需求規範 工作項目 業務需求收集 功能需求分析 非功能需求定義 安全需求識別 使用者故事撰寫 風險評估 技術細節和業務需求 需求追溯矩陣 安全威脅模型分析 合規性要求檢查 效能基準定義 2. 設計開發階段 (Design & Development) 目標: 進行系統架構設計和安全編碼實作 工作項目 系統架構設計 安全架構設計 資料庫設計 API 設計 編碼實作 程式碼審查 技術細節和業務需求 設計模式應用 安全編碼標準 程式碼品質標準 版本控制策略 3. 測試驗收階段 (Testing & Validation) 目標: 執行全面測試並進行安全驗證 工作項目 單元測試 整合測試 系統測試 效能測試 安全測試 使用者驗收測試 技術細節和業務需求 測試策略制定 自動化測試框架 安全測試工具 測試覆蓋率要求 4. 部署運維階段 (Deployment & Operations) 目標: 安全部署系統並建立持續監控機制 ...

October 31, 2025 · 1 min · 206 words · Eric Cheng

Thymeleaf使用教學

Thymeleaf 使用教學手冊 目錄 基礎概念 1.1 什麼是 Thymeleaf? 1.2 核心特色 1.2.1 自然模板特性 1.2.2 表達式豐富性 1.3 與其他模板引擎比較 1.3.1 詳細比較表 1.4 適用場景 1.5 工作流程 1.6 實務注意事項 環境建置 2.1 Spring Boot 專案整合 2.1.1 Maven 設定 2.1.2 Gradle 設定 2.2 目錄結構設定 2.3 應用程式設定 2.3.1 基本設定 (application.yml) 2.3.2 生產環境設定 (application-prod.yml) 2.4 IDE 設定 2.4.1 IntelliJ IDEA 設定 2.4.2 VS Code 設定 2.5 驗證安裝 2.5.1 建立控制器 2.5.2 建立模板 2.5.3 啟動應用程式 2.6 開發環境最佳化 2.6.1 熱重載設定 2.6.2 除錯設定 2.7 常見安裝問題 語法教學 3.1 基本標籤語法 3.1.1 文字輸出 (th:text) 3.1.2 HTML 輸出 (th:utext) 3.1.3 條件判斷 (th:if, th:unless) 3.1.4 迴圈遍歷 (th:each) 3.1.5 條件選擇 (th:switch, th:case) 3.2 屬性處理 3.2.1 設定屬性 (th:attr) 3.2.2 常用屬性快捷方式 3.2.3 CSS 類別處理 (th:classappend) 3.3 表達式語法 3.3.1 變數表達式 (${…}) 3.3.2 選擇表達式 (*{…}) 3.3.3 連結表達式 (@{…}) 3.3.4 訊息表達式 (#{…}) 3.3.5 片段表達式 (~{…}) 3.4 內建工具物件 3.4.1 日期工具 (#dates) 3.4.2 數字工具 (#numbers) 3.4.3 字串工具 (#strings) 3.4.4 集合工具 (#lists, #sets, #maps) 3.5 實務注意事項 3.6 模板繼承與片段 3.6.1 片段定義與使用 (th:fragment) 3.6.2 片段插入方式 3.6.3 佈局模板系統 3.6.4 參數化片段 3.6.5 片段選擇器 3.7 實務注意事項 3.8 表單處理 3.8.1 基本表單綁定 3.8.2 下拉選單處理 3.8.3 核取方塊處理 3.8.4 單選按鈕處理 3.8.5 檔案上傳處理 3.8.6 表單驗證錯誤處理 3.9 國際化 (i18n) 支援 3.9.1 設定國際化 3.9.2 訊息資源檔案 3.9.3 在模板中使用國際化 3.9.4 Java 程式碼中的國際化 3.9.5 日期和數字本地化 3.9.6 進階國際化實作 3.9.7 多語言最佳實務 3.10 實務注意事項 實務應用範例 ...

October 31, 2025 · 45 min · 9455 words · Eric Cheng

UI_UX設計指引範本

UI/UX 設計指引範本 Prompt 目標 指導 AI 進行用戶體驗和使用者介面設計,建立以使用者為中心的設計規範和原型。 角色設定 你是一位資深 UI/UX 設計師,具備豐富的使用者體驗設計經驗,熟悉設計思維、使用者研究方法和現代化介面設計原則。 任務描述 請協助我完成 {專案名稱} 的 UI/UX 設計工作。 專案設計背景 專案名稱: {填入專案名稱} 產品類型: {填入產品類型,如:Web應用、Mobile App、桌面應用} 目標使用者: {填入主要使用者群體} 使用情境: {填入主要使用場景} 設計風格偏好: {填入設計風格,如:簡約、現代、傳統} 品牌色彩: {填入品牌主色調} UI/UX 設計要求 請按照以下結構進行設計: 1. 使用者研究 使用者角色建立 使用者旅程地圖 痛點分析 需求優先級排序 2. 資訊架構設計 內容結構規劃 導航系統設計 資訊層級設計 搜尋和篩選機制 3. 互動設計 使用者流程設計 互動原型設計 微互動設計 回饋機制設計 4. 視覺設計 設計系統建立 色彩配置方案 字體系統設計 圖示和插圖風格 5. 響應式設計 多裝置適配策略 斷點設計規劃 彈性佈局設計 觸控優化設計 6. 無障礙設計 可及性標準遵循 色彩對比度檢查 鍵盤導航支援 螢幕閱讀器相容 輸出格式 # {專案名稱} UI/UX 設計規格 ## 1. 使用者研究 ### 1.1 使用者角色 (Personas) #### 主要使用者角色: [角色名稱] **基本資訊:** - 年齡: [年齡範圍] - 職業: [職業類型] - 技術熟悉度: [初級/中級/高級] - 使用裝置: [主要使用的裝置] **目標和需求:** - 主要目標: [使用者想要達成的目標] - 次要需求: [附加需求清單] - 成功指標: [如何衡量目標達成] **行為特徵:** - 使用習慣: [典型的使用模式] - 偏好: [介面和功能偏好] - 挫折點: [常見的困擾] **情境描述:** "[一段描述使用者在什麼情況下會使用這個產品的情境故事]" ### 1.2 使用者旅程地圖 #### 旅程階段1: 發現階段 **使用者行為:** [使用者在此階段的行為] **想法和感受:** [使用者的心理狀態] **觸點:** [與產品的接觸點] **痛點:** [遇到的問題] **機會點:** [改善的機會] #### 旅程階段2: 探索階段 **使用者行為:** [行為描述] **想法和感受:** [心理狀態] **觸點:** [接觸點] **痛點:** [問題點] **機會點:** [改善機會] #### 旅程階段3: 使用階段 **使用者行為:** [行為描述] **想法和感受:** [心理狀態] **觸點:** [接觸點] **痛點:** [問題點] **機會點:** [改善機會] ### 1.3 痛點分析矩陣 | 痛點 | 頻率 | 嚴重性 | 影響範圍 | 解決優先級 | |------|------|--------|----------|------------| | [痛點1] | [高/中/低] | [高/中/低] | [影響的使用者比例] | [高/中/低] | | [痛點2] | [高/中/低] | [高/中/低] | [影響的使用者比例] | [高/中/低] | ## 2. 資訊架構設計 ### 2.1 網站地圖 首頁 ├── 產品/服務 │ ├── 產品分類A │ ├── 產品分類B │ └── 產品詳細頁 ├── 關於我們 │ ├── 公司介紹 │ ├── 團隊介紹 │ └── 聯絡我們 ├── 支援中心 │ ├── 常見問題 │ ├── 使用指南 │ └── 技術支援 └── 使用者帳戶 ├── 個人資料 ├── 訂單記錄 └── 設定 ...

October 31, 2025 · 5 min · 994 words · Eric Cheng

UIUX指引

UI/UX 開發指引 企業標準技術白皮書|版本 v3.0|2026-10-09 適用範圍:以 Vue 3/TypeScript/Tailwind CSS 開發的企業 Web 應用,特別是網路銀行、保險、證券等金融服務,以及其他需要處理交易、個資與法規要求的系統。本指引規範從使用者研究、資訊架構、互動與視覺設計、Design Token、元件、表單、無障礙、內容、國際化、狀態設計,到效能、實作與品質驗證的 UI/UX 要求:每一條規則都說明要做到什麼、附有正確與錯誤的範例,並說明要用什麼工具或方法確認。 v3.0 全面改寫 v2.1:依 ISO 9241-210/-110/-11、ISO/IEC 25010:2023、WCAG 2.2(ISO/IEC 40500:2025)、WAI-ARIA 與 APG、EN 301 549 V4.1.1、European Accessibility Act、數位發展部「網站無障礙規範」115.11 版、金管會「數位金融服務包容性指引」、Design Tokens Format Module 2025.10 與 Core Web Vitals 重新組織內容。所有規則都有編號(UX-*)、等級與驗證方式,每節結尾都有「🔍 審查與驗證」,讓審查者能判斷 AI 或同事產出的介面是否正確。範例均以工具實際執行驗證(見 附錄 F)。框架工程細節見 前端開發指引,審查流程見 code review 指引。 目錄 0. 文件資訊 0.1 文件目的與讀者 0.2 技術與標準基準版本 0.3 規範等級與規則格式 0.4 與其他指引的關係 0.5 如何閱讀與使用本指引 0.6 例外與豁免流程 1. UX 治理與國際標準 1.1 為什麼企業需要 UI/UX 指引 1.2 國際標準與法規對照 1.3 無障礙法規與合規義務 1.4 UX 治理組織與責任 2. 以使用者為中心的設計流程 2.1 人本設計流程(ISO 9241-210) 2.2 使用者研究方法 2.3 人物誌、旅程地圖與使用情境 2.4 可用性需求與驗收條件 3. 資訊架構與導覽 3.1 資訊架構 3.2 導覽模式 3.3 頁面結構與地標 3.4 麵包屑、頁籤標題與網址 4. 互動設計原則 4.1 ISO 9241-110 互動原則與尼爾森啟發式 4.2 系統狀態與回饋 4.3 防錯、確認與復原 4.4 一致性與慣例 4.5 鍵盤與指標操作 5. 視覺設計 5.1 排版與字型 5.2 色彩與對比 5.3 間距、格線與版面 5.4 圖示與圖片 5.5 動態與動畫 5.6 資料視覺化 6. Design Token 與設計系統 6.1 Design Token 的分層 6.2 DTCG 格式與 Style Dictionary 6.3 Tailwind CSS 4 整合 6.4 主題與深色模式 7. 元件設計規範 7.1 元件的通用要求 7.2 按鈕與連結 7.3 對話框 7.4 選單、頁籤與手風琴 7.5 資料表格 7.6 通知訊息與 Toast 7.7 分頁與無限捲動 8. 表單設計與驗證 8.1 欄位標籤與說明 8.2 輸入類型與自動完成 8.3 驗證時機 8.4 錯誤訊息與錯誤摘要 8.5 多步驟表單 9. 響應式與多裝置設計 9.1 斷點與行動優先 9.2 重排與文字縮放 9.3 觸控目標與手勢 9.4 螢幕方向與容器查詢 10. 無障礙設計 10.1 WCAG 2.2 AA 符合策略 10.2 語意化 HTML 與 ARIA 使用原則 10.3 鍵盤操作與焦點管理 10.4 螢幕閱讀器與動態內容 10.5 WCAG 2.2 新增成功準則 10.6 認知無障礙 10.7 無障礙聲明與回饋管道 11. 內容設計與 UX 寫作 11.1 語氣與用語 11.2 微文案 11.3 易讀性與白話文 12. 國際化與在地化 12.1 語系與語言標示 12.2 數字、金額與日期格式 12.3 文字長度與雙向文字 13. 狀態設計 13.1 載入狀態 13.2 空狀態 13.3 錯誤狀態 13.4 離線與逾時 14. 金融情境 UX 14.1 金額、帳號與數值顯示 14.2 交易流程與確認 14.3 敏感資料遮罩與隱私 14.4 身分驗證與工作階段逾時 14.5 詐騙防範與風險提示 14.6 包容性金融服務 15. 效能與使用者體驗 15.1 Core Web Vitals 15.2 感知效能 15.3 效能預算 16. Vue 3 與 Tailwind CSS 實作落地 16.1 元件 API 設計 16.2 無障礙元件實作模式 16.3 樣式撰寫規範 16.4 元件文件與 Storybook 17. UX 品質驗證 17.1 驗證策略與金字塔 17.2 自動化無障礙檢測 17.3 手動與輔助科技測試 17.4 視覺回歸測試 17.5 可用性測試與 UX 指標 18. 設計與開發協作 18.1 設計交付 18.2 設計審查 18.3 設計系統治理與版本 19. AI 與 UX 19.1 審查 AI 產出的介面 19.2 設計 AI 功能的使用體驗 19.3 以 AI 輔助 UX 工作 附錄 A 規則總表 附錄 B 檢查清單與範本 B.1 UI 變更的 PR/MR 審查清單 B.2 設計交付與設計審查清單 B.3 螢幕閱讀器測試紀錄範本 B.4 使用者研究同意書範本 B.5 第三方 UI 元件評估清單 附錄 C 工具設定與腳本 C.1 驗證專案的結構與指令 C.2 按鈕樣式 C.3 Stylelint 規則說明 C.4 axe 設定 C.5 Playwright 設定 C.6 Lighthouse CI C.7 GitHub Actions 工作流程 C.8 GitLab CI 對應設定 附錄 D 術語表 D.1 UI/UX 與無障礙術語 D.2 產品詞彙表格式 D.3 台灣用語對照(節錄) 附錄 E 參考資料 E.1 國際標準與規範 E.2 法規 E.3 設計方法與業界實務 E.4 工具文件 附錄 F 修訂紀錄與查證紀錄 F.1 v2.1 與 v3.0 章節對照 F.2 v2.1 的錯誤與修正 F.3 查證紀錄 F.4 待確認項目 F.5 版本紀錄 0. 文件資訊 0.1 文件目的與讀者 使用者對一套系統的評價,幾乎都來自介面:按鈕按下去有沒有反應、錯誤訊息看不看得懂、轉帳前能不能確認金額、用鍵盤或螢幕閱讀器能不能完成操作。這些問題很少在需求文件中被寫清楚,卻在上線後以客訴、客服電話、交易錯誤與法規風險的形式出現。 ...

October 31, 2025 · 117 min · 24753 words · Eric Cheng