教學

微前端教學手冊 版本：1.0 最後更新：2026 年 1 月 適用對象：資深工程師 / Tech Lead / Architect 最後更新: 2026年1月23日 適用於: 微前端 Created by: Eric Cheng 微前端（Micro-Frontend）教學手冊 版本：1.0 適用對象：資深前端/全端工程師、Tech Lead、架構師 最後更新：2026 年 1 月 目錄 微前端的核心價值與真正要解決的問題 1.1 什麼是微前端？ 1.2 微前端真正要解決的問題 1.3 什麼情況「不該用微前端」 1.4 微前端 vs 單體前端 vs Monorepo 1.5 本章實務案例 微前端主流架構模式比較 2.1 基座（Shell / Container）模式 2.2 Runtime Integration vs Build-time Integration 2.3 iframe / Web Components / Module Federation 比較 2.4 主流框架方案比較 2.5 本章實務案例 Module Federation 深度解析 ...

Claude Agent Skills 使用教學手冊 版本：1.0 最後更新：2026 年 1 月 適用對象：新進軟體工程師、系統分析師、AI 導入成員 最後更新: 2026年1月8日 適用於: Claude Code Created by: Eric Cheng 目錄 前言 文件目的 適用對象 如何使用本手冊 第一章：Claude Agent 與 Agent Skills 基礎概念 1.1 什麼是 Claude Agent 1.2 什麼是 Agent Skills 1.3 Agent / Tool / Skill 的差異與關係 1.4 為什麼要使用 Agent Skills 第二章：Agent Skills 的設計理念 2.1 Skill 的責任邊界（Single Responsibility） 2.2 Skill 與 Prompt 的差異 2.3 Skill 是可重用、可組合的能力單元 2.4 官方 Skills Repo 的設計原則 第三章：官方 Skills Repository 結構說明 3.1 Skills GitHub 專案的目錄結構 3.2 Skill 的命名慣例 3.3 Skill 定義中的關鍵元素 第四章：Agent Skills 的使用方式 4.1 如何在 Agent 中呼叫 Skill 4.2 Skill 在任務流程中的角色 4.3 單一 Skill vs 多 Skill 組合 第五章：實務範例 5.1 需求文件產生 Skill 5.2 程式碼 Review / 重構 Skill 5.3 測試案例產生 Skill 第六章：新手常見錯誤與最佳實務 6.1 Skill 設計過大或過小的問題 6.2 把 Skill 當成一次性 Prompt 的錯誤用法 6.3 如何讓 Skill 更容易被重用 6.4 如何讓 Agent 行為更穩定 第七章：團隊導入建議 7.1 適合先從哪些類型的 Skill 開始 7.2 如何建立內部 Skill Library 7.3 與既有開發流程整合 7.4 導入成熟度階段建議 附錄：檢查清單（Checklist） Skill 建立前檢查 SKILL.md 撰寫檢查 Skill 發布前檢查 團隊導入檢查 參考資源 官方資源 延伸閱讀 前言 文件目的 本手冊旨在協助團隊成員快速理解並導入 Claude Agent Skills，透過系統化的教學內容，讓新進同仁能夠： ...

版本: 1.0 最後更新: 2026年1月9日 適用於: Claude Code Created by: Eric Cheng Anthropic Model Context Protocol (MCP) 教學手冊 版本資訊：本手冊基於 MCP 規範版本 2025-11-25 最後更新：2026 年 1 月 適用對象：資深軟體開發工程師、系統架構師 目錄 第一章：MCP 概述與核心概念 1.1 什麼是 MCP？ 1.2 為什麼需要 MCP？ 1.3 MCP 架構概覽 第二章：MCP 技術架構深度解析 2.1 分層架構 2.2 資料層協議（Data Layer Protocol） 2.3 MCP 核心原語（Primitives） 2.4 通知機制（Notifications） 第三章：傳輸層深度解析 3.1 STDIO Transport 3.2 Streamable HTTP Transport 第四章：實戰開發指南 4.1 開發環境設置 4.2 開發 MCP Server 4.3 開發 MCP Client 4.4 整合到 AI 應用 第五章：完整實戰範例 5.1 範例一：檔案系統 MCP Server 5.2 範例二：資料庫查詢 MCP Server 5.3 範例三：API 整合 MCP Server 第六章：最佳實踐與設計模式 6.1 MCP Server 設計原則 6.2 效能優化 6.3 安全性考量 6.4 測試策略 第七章：進階主題 7.1 Tasks 實驗性功能 7.2 自訂傳輸層 7.3 多語言 SDK 比較 7.4 偵錯與監控 第八章：疑難排解 8.1 常見錯誤與解決方案 8.2 除錯技巧 8.3 錯誤訊息參考 第九章：實際案例研究 9.1 案例一：企業知識庫 MCP Server 9.2 案例二：DevOps 整合 MCP Server 第十章：資源與參考 10.1 官方資源 10.2 社群資源 10.3 開發環境建議 10.4 版本相容性 10.5 快速參考 附錄：檢查清單（Checklist） A. Server 開發檢查清單 B. 部署檢查清單 C. 程式碼審查檢查清單 D. 故障排除檢查清單 第一章：MCP 概述與核心概念 1.1 什麼是 MCP？ 1.1.1 MCP 的定義與核心價值 Model Context Protocol（MCP） 是由 Anthropic 開發的一個開放標準協議，旨在為 AI 應用程式提供一個統一的方式來連接各種資料來源、工具和服務。 ...

版本: 3.0 最後更新: 2026年3月26日 適用於: Claude Code v2.x (GA, 2025-2026) Created by: Eric Cheng Claude Code 生態圈教學手冊 📖 版本: v3.0 📅 最後更新: 2026年3月26日 👥 目標讀者: 資深軟體工程師、技術主管、架構師 📋 基於官方文件: Claude Code Documentation 🆕 本版新增: Desktop App、Channels & Dispatch、Agent Skills Open Standard、Cowork 協同開發章節、Output Styles、Scheduled Tasks、完整 Plugin Marketplace 體系 目錄 第一部分：基礎概念 (Foundation) 1.1 Claude Code 簡介 1.1.1 產品定位與核心價值 1.1.2 多平台支援總覽 1.1.3 適用場景與限制 1.1.4 安裝與環境配置 1.1.5 Claude Code 的運作原理 1.1.6 Desktop App 與 Web 介面 1.1.7 Channels 與 Dispatch 1.2 核心架構概覽 1.2.1 系統架構圖 1.2.2 各組件之間的關係 1.2.3 資料流與執行流程 1.2.4 記憶體與設定架構 1.2.5 權限與安全模型 1.2.6 工具系統詳解 1.2.7 Agentic Loop 深入解析 1.3 快速上手實戰 1.3.1 第一次對話 1.3.2 建立 CLAUDE.md 1.3.3 常見操作範例 1.3.4 效率提升技巧 第二部分：核心功能詳解 2.1 Subagents (子代理) 2.1.1 概念說明 2.1.2 內建子代理類型 2.1.3 自訂子代理 2.1.4 使用場景與實作範例 2.1.5 進階技巧 2.1.6 Subagent 完整實戰範例 2.2 Agent Teams（多代理協作） 2.2.1 Agent Teams 概述 2.2.2 啟動與使用 Agent Teams 2.2.3 Agent Teams 的協調機制 2.2.4 應用場景與最佳實踐 2.2.5 Agent Teams 進階模式 2.2.6 Agent Teams 搭配 Hooks 2.3 Skills（技能系統） 2.3.1 Skills 概述 2.3.2 內建 Skills（Slash Commands） 2.3.3 SKILL.md 檔案格式 2.3.4 Agent Skills（附加在 Agent 上的 Skills） 2.3.5 開發自訂 Skills 2.3.6 Skills 最佳實踐 2.3.7 Skill 進階範例集 2.4 Plugins（插件系統） 2.4.1 Plugin 概述 2.4.2 Plugin 目錄結構 2.4.3 Plugin 的發現與安裝 2.4.4 開發自訂 Plugin 2.4.5 Plugin 安全與信任 2.4.6 Plugin 實戰範例 2.4.7 Plugin 與其他機制的關係 2.5 Hooks（鉤子機制） 2.5.1 Hooks 系統概述 2.5.2 Hook 事件類型（25+ 種） 2.5.3 Hook 類型（4 種） 2.5.4 Hook 配置詳解 2.5.5 實用 Hook 範例 2.5.6 Hook 執行規則與最佳實踐 2.5.7 進階 Hook 架構模式 2.6 MCP（Model Context Protocol） 2.6.1 MCP 概述 2.6.2 配置 MCP Server 2.6.3 工具搜尋（Tool Search） 2.6.4 MCP 認證 2.6.5 企業級 MCP 管理 2.6.6 常見 MCP Server 推薦 2.6.7 自行開發 MCP Server 2.6.8 MCP 除錯與疑難排解 2.7 Output Styles（輸出風格） 2.7.1 Output Styles 概述 2.7.2 配置 Output Styles 2.7.3 自訂輸出範本 2.7.4 場景化輸出風格 2.7.5 Output Styles 覆寫機制 2.7.6 與 Agent/Skill 結合 2.8 Scheduled Tasks（排程任務） 2.8.1 Scheduled Tasks 概述 2.8.2 配置排程任務 2.8.3 應用場景 2.8.4 排程任務搭配 Headless 模式 2.8.5 排程任務監控與通知 2.8.6 排程任務最佳實踐 第三部分：整合與最佳實踐 3.1 VS Code Extension 整合 3.1.1 安裝與啟用 3.1.2 核心功能 3.1.3 Checkpoints（檢查點） 3.1.4 Worktree 整合 3.1.5 第三方 AI Provider 3.1.6 VS Code 快捷鍵與命令總覽 3.1.7 Plan Mode（規劃模式）詳解 3.1.8 URI Handler 與 Plugin 管理 UI 3.1.9 VS Code 多實例與 Terminal 整合 3.2 Remote Control（遠端控制） 3.2.1 概述 3.2.2 啟動與連接 3.2.3 API 操作 3.2.4 應用場景 3.2.5 Remote Control 進階整合模式 3.3 Headless 模式與 SDK 3.3.1 Headless 模式 3.3.2 SDK 整合 3.3.3 應用場景 3.3.4 Headless 模式進階用法 3.4 整合工作流程 3.4.1 端到端開發流程 3.4.2 多元件協作實例 3.4.3 自動化配置組合範例 3.4.4 完整工作流程範例：從 Issue 到 PR 3.4.5 完整配置檔整合範例 3.5 團隊協作指南 3.5.1 共享配置管理 3.5.2 協作模式 3.5.3 知識共享 3.5.4 新人入職（Onboarding）工作流程 3.5.5 Code Review 工作流程 3.5.6 團隊開發標準化流程 3.6 效能優化 3.6.1 Token 使用優化 3.6.2 Context 管理優化 3.6.3 執行效率優化 3.6.4 成本控制策略 3.7 疑難排解 3.7.1 常見問題與解決方案 3.7.2 診斷方法 3.7.3 效能問題排查 3.7.4 取得幫助 3.8 Cowork 協同開發實戰 3.8.1 Cowork 概念與模式 3.8.2 團隊共享 CLAUDE.md 策略 3.8.3 多人協作工作流程 3.8.4 Agent Teams 協同開發 3.8.5 跨團隊 Plugin Marketplace 3.8.6 Remote Control 遠端協作 3.8.7 Channels 與 Dispatch 即時協作 3.8.8 Cowork 最佳實踐與防踩坑指南 第四部分：進階主題 4.1 企業級部署 4.1.1 企業管理架構 4.1.2 安全性配置 4.1.3 SSO 與認證整合 4.1.4 稽核日誌與合規性 4.1.5 企業部署架構模式 4.1.6 企業級配置管理策略 4.2 CI/CD 整合 4.2.1 GitHub Actions 整合 4.2.2 GitLab CI/CD 整合 4.2.3 通用 CI/CD 整合模式 4.2.4 CI/CD 最佳實踐 4.2.5 進階 CI/CD 場景 4.3 自訂開發 4.3.1 開發自訂 MCP Server 4.3.2 開發自訂 Skill 4.3.3 開發自訂 Plugin 4.3.4 自訂開發整合模式 4.4 Channels 與 Dispatch 深入解析 4.4.1 Channels 架構與協定 4.4.2 支援的通訊管道 4.4.3 Dispatch 行動端整合 4.4.4 自建 Channel MCP Server 4.4.5 企業級 Channel 部署 4.5 Agent Skills Open Standard 4.5.1 開放標準概述 4.5.2 agentskills.io 規範 4.5.3 跨工具互通性 4.5.4 社群生態與未來發展 第五部分：附錄 附錄 A：CLI 命令參考 A.1 啟動與基本操作 A.2 Slash Commands（互動式模式） A.3 Custom Slash Commands A.4 CLI 配置命令 A.5 進階 CLI 選項 A.6 CLI 環境變數 A.7 退出碼（Exit Codes） A.8 CLI 使用範例集 附錄 B：配置檔案參考 B.1 配置檔案一覽 B.2 settings.json 完整結構 B.3 .mcp.json 完整結構 B.4 CLAUDE.md 建議結構 B.5 managed-settings.json（企業管理員配置） B.6 managed-mcp.json（企業 MCP 管理） B.7 .claudeignore 語法 B.8 配置優先級完整圖 附錄 C：Hook Events 完整參考 C.1 所有事件 C.2 Hook 類型 C.3 環境變數 C.4 各事件詳細範例 C.5 常見 Hook 配方集 C.6 Hook 執行流程與錯誤處理 附錄 D：常見 MCP Servers 一覽 D.1 官方 MCP Servers D.2 社群熱門 MCP Servers D.3 依場景選擇 MCP Server D.4 MCP Server 配置範本 D.5 MCP Server 開發快速入門 D.6 MCP Server 除錯與監控 D.7 MCP Server 安全最佳實踐 附錄 E：術語表 附錄 F：常見問題 FAQ F.1 安裝與設定 F.2 使用技巧 F.3 企業使用 F.4 成本與效能 F.5 MCP 整合 F.6 Agent Teams 與協作 F.7 Skills 與 Plugins F.8 安全與隱私 結語 第一部分：基礎概念 (Foundation) 1.1 Claude Code 簡介 1.1.1 產品定位與核心價值 Claude Code 是 Anthropic 推出的 AI 輔助程式開發工具，定位為開發者的智慧協作夥伴，而非單純的程式碼生成器。 ...

版本: 1.0 最後更新: 2026年1月9日 適用於: Claude Code Created by: Eric Cheng Claude Code 使用教學手冊（資深同仁版） 版本：1.0 適用對象：資深工程師 / Tech Lead / 系統分析師 / 架構師 最後更新：2026 年 1 月 目錄 第一章：Claude Code 是什麼？（給資深工程師的視角） 1.1 Claude Code 與傳統 Copilot / ChatGPT Coding 的差異 1.2 適合用來做什麼？不適合做什麼？ 1.3 在企業環境中的合理定位 第二章：資深工程師使用 Claude Code 的正確心法 2.1 把 AI 當成「資深 Pair Programmer」而非新人工具 2.2 為什麼「規格比程式碼更重要」 2.3 Prompt 即設計文件的延伸 第三章：高品質 Prompt 設計原則 3.1 好 Prompt vs 壞 Prompt 對照 3.2 Prompt 必備元素 3.3 常見錯誤 Prompt 範例與改寫示範 第四章：Claude Code 在實務開發流程中的應用 4.1 需求釐清 / PRD 補強 4.2 架構設計與技術選型 4.3 程式碼生成與重構 4.4 測試案例補齊 4.5 技術文件與 README 生成 第五章：企業級實戰範例 5.1 範例一：協助重構 Legacy Code 5.2 範例二：根據規格產生模組骨架 5.3 範例三：產生測試與安全檢查建議 第六章：風險、限制與最佳實踐 6.1 AI 可能產生的風險 6.2 如何做 Code Review 與 AI Output Review 6.3 在銀行 / 企業內部的安全使用原則 第七章：團隊導入建議 7.1 適合哪些角色優先使用 7.2 與現有開發流程的整合方式 7.3 建議的內部使用規範 第八章：進階技巧與模式 8.1 Prompt Chain 設計模式 8.2 多輪對話策略 8.3 與 Spec-Driven Development 整合 附錄：檢查清單（Checklist） A. 使用前準備清單 B. Prompt 撰寫清單 C. 程式碼審查清單 D. 整合上線清單 E. 團隊導入清單 版本紀錄 參考資源 第一章：Claude Code 是什麼？（給資深工程師的視角） 1.1 Claude Code 與傳統 Copilot / ChatGPT Coding 的差異 作為資深工程師，您可能已經使用過多種 AI 編程輔助工具。以下是 Claude Code 與其他工具的核心差異： ...

版本: 1.0 最後更新: 2026年1月9日 適用於: Claude Code Created by: Eric Cheng Claude Code 使用教學手冊（新進同仁版） 版本：1.0 最後更新：2026 年 1 月 適用對象：新進軟體工程師（PG / SA / Tech Lead 初階） 先決條件：具備基本程式設計能力 目錄 第 1 章：Claude Code 是什麼？ 1.1 Claude Code 的定位 1.2 與一般聊天式 AI 的差異 1.3 適合與不適合的使用情境 1.4 Claude Code 在企業開發流程中的角色 第 2 章：Claude Code 的基本操作觀念 2.1 Prompt ≠ 問問題 2.2 好 Prompt 的核心結構 2.3 單輪 vs 多輪對話策略 2.4 如何逐步收斂出可用結果 第 3 章：新進工程師必學的 Prompt 範本 3.1 程式碼解讀 Prompt 3.2 新功能開發 Prompt 3.3 舊系統重構 Prompt 3.4 Bug 分析 Prompt 3.5 單元測試產生 Prompt 3.6 Code Review Prompt 3.7 規格補齊 Prompt 第 4 章：Claude Code 在實務開發中的典型流程 4.1 從需求文字到程式碼 4.2 從舊程式碼到可維護設計 4.3 從「我看不懂」到「我能修改」 4.4 搭配 Git / PR / Review 的使用方式 第 5 章：常見錯誤與 Anti-Pattern 5.1 問太籠統 5.2 一次丟太多責任 5.3 沒有限制輸出格式 5.4 盲目相信 AI 結果 5.5 沒做人工驗證 第 6 章：Claude Code 使用最佳實務（Best Practices） 6.1 Prompt 模組化 6.2 對話紀錄如何保存 6.3 與團隊共用 Prompt 的方式 6.4 什麼情況不該用 Claude Code 第 7 章：企業內部使用注意事項 7.1 資安與機敏資料原則 7.2 原始碼與客戶資料保護 7.3 法遵與稽核觀點 7.4 AI 產出責任歸屬說明 第 8 章：進階應用（選讀） 8.1 Spec-Driven Development（SDD） 8.2 將 Claude Code 當成虛擬 Pair Programmer 8.3 長任務拆解技巧 8.4 Prompt Chain 與角色切換 附錄：新進同仁檢查清單（Checklist） 延伸閱讀與資源 前言：如何使用本手冊 本手冊專為「新進軟體工程師」設計，協助您快速掌握 Claude Code 的使用方式。 ...

Java25升版教學 版本: 1.0 最後更新: 2025年12月31日 適用於: java 25 Created by: Eric Cheng +++ Java 1.7 → Java 25 升版教學手冊 版本：1.0 最後更新：2025 年 12 月 適用對象：具備 Java 1.7～8 基礎的開發人員 目標：企業升版實務 + Java OCP 認證準備 📋 目錄 前言 第一章：Java 平台演進總覽（1.7 → 25） 1.1 Java 版本生命週期說明（LTS vs 非 LTS） 1.2 為何企業應升級至 Java 17 / 21 / 25 1.3 Java 設計哲學的重大轉變 1.4 Java 與 JVM、生態系的角色變化 第一章小結 第二章：Java 7 → Java 8（現代 Java 的分水嶺） 2.1 Lambda Expression 2.2 Functional Interface 2.3 Stream API 2.4 Optional 的正確使用方式 2.5 Default Method 2.6 實務對照：Java 7 vs Java 8 2.7 常見誤用與 OCP 考點 第二章小結 第三章：Java 9 ～ Java 11（模組化與平台重整） 3.1 Java Platform Module System（JPMS） 3.2 jlink / jdeps 工具 3.3 移除 Java EE 模組的影響 3.4 HTTP Client API 3.5 var（區域型別推斷） 3.6 TLS / Security 強化 3.7 升版衝擊與因應策略 第三章小結 第四章：Java 12 ～ Java 16（語言精煉期） 4.1 Switch Expression 4.2 Text Blocks 4.3 Records 4.4 Pattern Matching for instanceof 4.5 ZGC / Shenandoah 簡介 4.6 Preview Feature 使用與風險 第四章小結 第五章：Java 17（LTS，企業升版首選） 5.1 Java 17 作為企業基準版的理由 5.2 Sealed Class 5.3 強封裝（Strong Encapsulation） 5.4 移除與淘汰 API 清單 5.5 與 Spring Boot / Jakarta EE 的相容性 第五章小結 第六章：Java 18 ～ Java 20（為並行革命鋪路） 6.1 Foreign Function & Memory API 6.2 Vector API 6.3 JVM 效能最佳化重點 6.4 新 GC 行為觀察 第六章小結 第七章：Java 21（LTS，Virtual Thread 時代） 7.1 Virtual Thread（Project Loom） 7.2 Structured Concurrency 7.3 Scoped Value 7.4 傳統 Thread Pool vs Virtual Thread 7.5 對 Web / Batch / MQ 系統的影響 7.6 實務建議 第七章小結 第八章：Java 22 ～ Java 25（未來 Java 的樣貌） 8.1 Pattern Matching 完整體系 8.2 Record Pattern 8.3 Class File API 8.4 最新 GC / JVM 優化 8.5 Java 在 Cloud-Native、AI、High Concurrency 的定位 第八章小結 第九章：舊系統升版實務指南（企業必讀） 9.1 Java 1.7 → 17 / 21 / 25 升版路線圖 9.2 常見升版風險 9.2.1 Unsafe API 9.2.2 反射存取 9.2.3 ClassLoader 問題 9.2.4 編碼 / TLS / 加密 9.3 建議升版策略（分階段） 9.4 升版 Checklist 第九章小結 第十章：Java OCP 認證對照與準備建議 10.1 Java OCP（新版）考試範圍對照 10.2 必考語言特性整理 10.3 常見陷阱題解析方向 10.4 建議學習與實作順序 第十章小結 第十一章：總結與學習地圖 11.1 Java 現代化能力成熟度模型 11.2 從 Java 7 工程師 → Java 25 架構師 11.3 持續學習建議與官方資源 第十一章小結 附錄：升版檢查清單（Checklist） A. 完整升版檢查清單 B. 快速參考卡 結語 前言 為什麼需要這份手冊？ Java 自 1995 年誕生以來，已經走過近 30 年的歷程。從 Java 1.7 到 Java 25，Java 經歷了翻天覆地的變化： ...

OpenSpec 使用教學手冊 版本：3.1 更新日期：2026-03-23 適用版本：OpenSpec v1.2.0（含 Profiles、OPSX 工作流程、動態指令架構與語義規格同步） 適用對象：新進軟體工程師、系統分析師、尚未接觸過 SDD 或 OpenSpec 的同仁 官方網站：openspec.dev 目錄 前言 為什麼需要這份手冊？ 本手冊的目標 閱讀建議 第一章：OpenSpec 是什麼？ 1.1 為什麼會有 OpenSpec 1.2 與傳統 PRD / SRS / 設計文件的差異 1.3 OpenSpec 在 SDD 中扮演的角色 第二章：Spec-Driven Development（SDD）核心概念 2.1 規格優先（Spec First） 2.2 規格即合約（Spec as Contract） 2.3 規格可被 AI 理解與執行 第二章小結 第三章：OpenSpec 文件結構說明 3.1 常見 Spec 類型 3.2 每一種 Spec 的用途與撰寫原則 3.3 好的 Spec 與壞的 Spec 範例比較 第三章小結 第四章：使用 OpenSpec 的標準工作流程 4.1 從需求想法到 Spec 4.2 OPSX 工作流程與 Profiles 系統（v1.2.0） 三大架構革新（v1.0.0 起） 各 AI 工具的指令語法差異 4.3 與 AI 互動修正 Spec 的方式 4.4 Spec 如何驅動設計、程式碼與測試 第四章小結 第五章：新進同仁實作範例 5.1 案例說明：帳戶餘額查詢 API 5.2 從需求描述到 OpenSpec 文件 5.3 示範如何向 AI 詢問與優化 Spec 第五章小結 第六章：常見錯誤與反模式（Anti-Patterns） 6.1 規格寫得像程式碼 6.2 規格過於抽象或過度細節化 6.3 把 AI 當成自動寫 Code 工具 常見反模式總覽 第六章小結 第七章：導入 OpenSpec 的最佳實務 7.1 團隊協作方式 7.2 Spec Review 重點 7.3 如何版本控管 Spec 第七章小結 第八章：給新進同仁的學習建議 8.1 上手順序 8.2 常見卡關點 8.3 如何從「會寫」進階到「寫得好」 第八章小結 附錄：檢查清單（Checklist） A. OpenSpec 環境設定檢查清單 B. Spec 撰寫檢查清單 C. Spec Review 檢查清單 D. 變更完成檢查清單 E. 常用 CLI 指令速查 F. 與 AI 對話 Prompt 範本 G. 支援的 AI 工具清單 H. 疑難排解（Troubleshooting） 參考資源 官方資源 相關工具 延伸閱讀 文件資訊 前言 為什麼需要這份手冊？ 在 AI 輔助開發的時代，許多團隊開始使用 GitHub Copilot、Claude、ChatGPT 等工具來加速開發。然而，AI 助手在沒有明確規格的情況下，容易產生不符合需求的程式碼，或是理解偏差導致返工。 ...

BMAD-METHOD 使用教學手冊 文件版本：3.0 最後更新：2026 年 3 月 適用版本：BMAD METHOD v6.0.4（穩定版） 適用對象：新進軟體工程師、系統分析師、專案成員 前置知識：基本軟體開發概念、版本控制基礎 Created by：Eric Cheng 目錄 前言 第一章：BMAD-METHOD 是什麼 1.1 方法論背景與設計目的 1.2 BMAD 與傳統開發流程的差異 1.3 為什麼 BMAD 特別適合 AI 協作開發 第二章：BMAD-METHOD 的核心概念 2.1 四大核心階段概覽 2.2 Analysis（分析）階段 2.3 Planning（規劃）階段 2.4 Solutioning（方案設計）階段 2.5 Implementation（實作）階段 2.6 各階段的目標、輸入與輸出 2.7 安裝與設定指南 2.8 官方模組總覽 2.9 Skills 架構深入解說 2.10 專案上下文管理（Project Context） 2.11 官方模組深入解說 2.12 Quick Flow 完整實戰指南 2.13 Dev Loop 自動化開發循環 2.14 新增工作流程參考 第三章：BMAD-METHOD 整體流程說明 3.1 從需求發想到交付的完整流程 3.2 每個階段與 AI 的互動方式 3.3 建議的文件與產出物 第四章：各階段詳細教學 4.1 Analysis 階段詳細教學 4.2 Planning 階段詳細教學 4.3 Solutioning 階段詳細教學 4.4 Implementation 階段詳細教學 第五章：AI Prompt 實戰範例 5.1 Analysis 階段 Prompt 範例 5.2 Planning 階段 Prompt 範例 5.3 Solutioning 階段 Prompt 範例 5.4 Implementation 階段 Prompt 範例 5.5 銀行與大型系統專用 Prompt 實戰對話 5.6 BMAD v6 Skills 實戰 Prompt 範例 第六章：BMAD-METHOD 與其他方法論比較 6.1 與 Scrum / SAFe 的差異 6.2 與 SDD / Spec-Kit 的差異 6.3 適用與不適用情境 第七章：新進同仁快速上手指南 7.1 第一週可以怎麼用 BMAD 7.2 建議學習順序 7.3 團隊內導入建議 第八章：常見問題（FAQ） Q1：BMAD 是否會取代 SA / PG？ Q2：BMAD 是否一定要用 AI？ Q3：如何在既有（Brownfield）系統中導入？ Q4：BMAD 產出的文件品質如何？ Q5：如何處理 AI 產出的錯誤？ Q6：BMAD 適合什麼規模的團隊？ Q7：如何評估 BMAD 導入效果？ Q8：Skills 和舊版 Slash Commands 有什麼差別？ Q9：如何選擇適當的 IDE？ Q10：project-context.md 需要手動維護嗎？ Q11：如何處理多個 AI 代理之間的上下文切換？ Q12：BMAD 如何與 CI/CD 整合？ Q13：如何在離線環境中使用 BMAD？ 疑難排解（Troubleshooting） 常見問題排除 效能最佳化建議 進階主題：BMAD 客製化與擴展 進階 1：使用 BMB 建立客製化代理 進階 2：建立組織專屬的工作流程範本 進階 3：多模組整合架構 進階 4：llms-full.txt 與 AI 自助學習 進階 5：Brownfield 專案遷移策略 附錄：檢查清單（Checklist） A. BMAD 專案啟動檢查清單 B. 各階段完成檢查清單 C. AI 協作品質檢查清單 D. 新進同仁學習進度檢查清單 術語表（Glossary） 代理角色快速對照 常用 Skill ID 快速對照 參考資源 版本紀錄 前言 為什麼需要這份手冊？ 在人工智慧快速發展的時代，軟體開發方式正經歷革命性變化。傳統的開發流程往往無法充分發揮 AI 助手的潛力，導致： ...

TDD（Test-Driven Development）測試驅動開發使用教學手冊 📚 目錄 一、前言 1.1 教學目的 1.2 適用對象 1.3 預期學習成果 1.4 教學手冊架構說明 二、TDD 概念與原則 2.1 什麼是 TDD（Test-Driven Development） 2.2 TDD 的核心循環：Red → Green → Refactor 2.3 TDD 與傳統開發流程的差異 2.4 為什麼使用 TDD：好處與挑戰 2.5 單元測試 vs. 集成測試 vs. 系統測試 三、TDD 實踐步驟 3.1 Step 1：撰寫失敗的測試（Red） 3.2 Step 2：撰寫最簡單的實作通過測試（Green） 3.3 Step 3：重構程式碼（Refactor） 3.4 Step 4：重複循環與迭代開發 3.5 驗收標準（Definition of Done）與測試覆蓋率要求 四、TDD 開發環境與工具 4.1 測試框架介紹 4.2 IDE 與工具設定 4.3 持續整合（CI）與自動化測試 4.4 測試覆蓋率工具 4.5 測試資料與 Mock 工具 ...