教學

Claude Code 生態圈教學手冊 📖 版本：v3.5（企業技術白皮書版） 📅 最後更新：2026 年 9 月 24 日 🔎 查證基準：Claude Code v2.1.281（2026-09-23），逐頁比對 code.claude.com 官方文件 👥 目標讀者：資深軟體工程師、技術主管、架構師、平台／DevOps 工程師、資安與 IT 管理員 ✍️ Created by：Eric Cheng 文件資訊 適用範圍 本手冊涵蓋 Claude Code 在 Terminal CLI、VS Code／JetBrains、Desktop App、Web（claude.ai/code）、CI/CD 等介面上的使用方式，以及 Subagents、Agent Teams、Skills、Plugins、Hooks、MCP、Output Styles、排程任務、Remote Control、Channels 等擴充與協作機制，並提供企業部署、治理、成本與安全的實務建議。 閱讀指引 讀者 建議閱讀順序 第一次使用 第一部分 → 2.3 Skills → 2.5 Hooks → 3.7 疑難排解 技術主管 1.2 → 2.1／2.2 → 3.5 團隊協作 → 3.6 成本 → 4.2 CI/CD 平台／DevOps 3.3 Headless → 4.2 CI/CD → 2.4 Plugins → 2.6 MCP → 4.3 自訂開發 資安／IT 管理員 1.2.5 權限與沙箱 → 2.5.9 Hook 治理 → 2.6.5 MCP 管理 → 4.1 企業部署 → 附錄 B 標示說明 標示 意義 🆕 v3.5 新增／更新 本版依官方文件新增或更新的內容 ⚠️ v3.5 更正 舊版內容與官方文件不符，已更正（原錯誤寫法會一併說明，方便團隊清查既有設定） 🔐 安全與治理相關的重點 🏢／企業導入檢核要點 企業導入時的建議與檢核清單 v3.5 修訂重點 🆕 v3.5（2026-09-24）：以 v2.1.281 為基準，逐頁比對使用者指定的 17 個官方頁面與約 40 個延伸頁面（完整清單見附錄 H）。 ...

版本: 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 使用教學手冊 版本：7.0 更新日期：2026-08-15 適用版本：OpenSpec v1.9.0（含 Stores Beta、Profiles、OPSX 工作流程（新增 /opsx:update 核心指令）、動態指令架構、語義規格同步、Canonical Artifact Paths、retire_capabilities 能力汰除、skip_specs 純重構標記、GitHub Copilot Cloud Agent、CLI 自我升級提示、40+ 個 AI 工具支援（新增 Command Code / CodeArts Agent / Hermes Agent / MiniMax Code / Oh My Pi / ZCode / Rovo Dev CLI 等；Windsurf 已更名為 Devin Desktop、Kimi CLI 已更名為 Kimi Code）、Validator 多語言彈性化、validate --archived 封存前檢查） 適用對象：新進軟體工程師、系統分析師、尚未接觸過 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.9.0） Profiles 設定檔系統 從舊版到新版的轉變 三大架構革新（v1.0.0 起） v1.9.0 版本重要更新 v1.8.0 版本重要更新 v1.7.0 版本重要更新 v1.6.0 版本重要更新 v1.5.0 版本重要更新 v1.4.0 版本重要更新 v1.4.1 版本修補 v1.3.1 版本重要更新 v1.3.0 版本重要更新 OPSX 完整指令一覽 常見工作流程模式 流動式迭代（Fluid Iteration） 自訂 Schema 新手上路：使用 /opsx:onboard 各 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 如何從「會寫」進階到「寫得好」 第八章小結 第九章：進階主題 9.1 Progressive Rigor（漸進式嚴謹度） 9.2 Multi-Language 支援 9.3 自訂 Schema 進階用法 9.4 人類與 Agent 協作模式 9.5 Stores（Beta）—— 跨專案規格管理 9.6 業界獨立評測與導入建議 第九章小結 附錄：檢查清單（Checklist） A. OpenSpec 環境設定檢查清單 B. Spec 撰寫檢查清單 C. Spec Review 檢查清單 D. 變更完成檢查清單 E. 常用 CLI 指令速查 F. 與 AI 對話 Prompt 範本 G. 支援的 AI 工具清單 H. 疑難排解（Troubleshooting） I. 術語表（Glossary） 參考資源 官方資源 相關工具 延伸閱讀 文件資訊 前言 為什麼需要這份手冊？ 在 AI 輔助開發的時代，許多團隊開始使用 GitHub Copilot、Claude、ChatGPT 等工具來加速開發。然而，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 工具 ...

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 工具 ...

Angular 前端Framework教學手冊 目錄 1. 前言 為什麼要學習 Angular？ 專案背景 學習目標 2. 基礎篇 1. Angular 架構概念 1.1 核心概念 1.2 應用程式架構圖 2. 環境建置 2.1 必要軟體安裝 2.2 建立新專案 2.3 專案結構 3. 組件 (Components) 3.1 組件基本概念 3.2 建立組件 3.3 組件範例 4. 資料繫結 (Data Binding) 4.1 插值繫結 (Interpolation) 4.2 屬性繫結 (Property Binding) 4.3 事件繫結 (Event Binding) 4.4 雙向資料繫結 (Two-way Binding) 3. 進階篇 5. 模組 (Modules) 5.1 模組基本概念 5.2 根模組範例 5.3 功能模組建立 5.4 共用模組 6. 服務與相依性注入 (Services & Dependency Injection) 6.1 建立服務 6.2 基本服務範例 6.3 在組件中使用服務 6.4 服務注入層級 7. 路由 (Routing) 7.1 基本路由設定 7.2 子路由設定 7.3 路由導航 7.4 路由參數處理 7.5 路由守衛 4. 專案實務篇 8. 表單處理 8.1 範本驅動表單 (Template-driven Forms) 8.2 反應式表單 (Reactive Forms) 8.3 表單驗證最佳實務 9. HTTP 客戶端與 API 整合 9.1 HTTP 攔截器 9.2 API 服務封裝 10. RxJS 最佳實務 10.1 常用操作符 10.2 記憶體管理 11. 測試 (Testing) 11.1 單元測試範例 11.2 整合測試範例 11.3 指令測試範例 11.4 管道測試範例 11.5 路由測試範例 11.6 測試工具與最佳實務 5. 認證準備篇 12. Angular 官方認證考試重點 12.1 考試概要 12.2 重點知識領域 12.3 模擬考試題目 12.4 考前準備清單 13. 實戰模擬測驗 13.1 綜合練習題 13.2 進階練習題 6. 附錄 14. 常見問題 (FAQ) 14.1 開發環境問題 14.2 開發常見問題 14.3 效能問題 15. 有用的資源連結 15.1 官方資源 15.2 學習資源 15.3 工具與庫 15.4 社群資源 16. 快速參考檢查清單 16.1 新專案設置檢查清單 16.2 開發檢查清單 16.3 部署前檢查清單 16.4 程式碼審查檢查清單 17. 團隊開發規範 17.1 Git 工作流程 17.2 程式碼規範 17.3 程式碼審查標準 前言 為什麼要學習 Angular？ Angular 是由 Google 開發維護的前端框架，具有以下優勢： ...

版本：v1.1（已完成第 1-16 章與附錄 A-E；持續維護優化） 最後更新：2026-02-12（對應 JMeter 5.6.3 版本） 適用對象：完全未接觸過效能測試 / JMeter 的新進開發與測試人員 文件目標：協助 1~2 天內快速具備撰寫並執行基本壓力測試腳本的能力，並建立後續進階自學基礎。 快速導讀 若你是第一次接觸 JMeter，建議依序閱讀： Part 1（必讀）：了解 JMeter 是什麼、安裝、基礎 GUI 操作。 Part 2：學會設計一個可維護的測試計畫（參數化、控制器、Assertion）。 Part 3：掌握報表分析與常見最佳實務（非 GUI、分散式、效能瓶頸初步診斷）。 Part 4：實戰情境（API / Web / DB / 企業案例）。 Part 5：若需考 JMeter 認證或建置團隊基準能力。 附錄：錯誤排除、報告範本、學習資源、Checklist。 目錄（Table of Contents） Part 1. 基礎入門（Ch.1-3） 1. JMeter 簡介 1.1 JMeter 的定位與用途 1.2 常見測試類型 1.3 與其他工具比較 1.4 概念流程圖 1.5 本章實務案例 1.6 注意事項（初學者常犯） 2. 安裝與環境設定 ...

Bash 使用教學手冊 📚 手冊說明 本手冊專為團隊新進開發同仁設計，旨在提供完整的 Bash 學習指引，讓同仁能夠： 掌握 Bash 基礎與進階技能 在專案開發中正確使用 Bash 腳本 具備考取 Linux 相關認證的能力 遵循團隊 Bash 開發規範 📋 完整目錄結構 目錄 第 1 部分：基礎入門 1.1 認識 Bash 與 Shell 1.2 Bash 與 Linux/Unix 的關係 1.3 Bash 環境與版本檢查 1.4 常見開發環境介紹 1.5 基本命令列操作 1.6 編輯器使用 第 2 部分：Bash 核心語法 2.1 變數與資料型態 2.2 參數與引數 2.3 運算子與算術計算 2.4 條件判斷 2.5 迴圈結構 2.6 函式 2.7 輸入與輸出 2.8 管線與重新導向 第 3 部分：進階主題 3.1 陣列與字串處理 3.2 正則表達式與文字處理 3.3 檔案與目錄操作自動化 3.4 使用 cron 與排程任務 3.5 Bash 腳本除錯 3.6 錯誤處理 3.7 最佳實務 第 4 部分：專案應用實戰 4.1 自動化專案建置腳本 4.2 系統環境初始化 4.3 日誌分析與檔案過濾 4.4 檔案批次處理 4.5 自動化檔案傳輸 4.6 CI/CD 腳本整合 第 5 部分：考試準備 5.1 Bash 認證考試介紹 5.2 常見考試範疇與題型解析 5.3 範例考題與練習題 5.4 模擬測驗與解答解析 5.5 考試技巧與時間管理 第 6 部分：附錄 6.1 常用 Bash 指令速查表 6.2 Shell 腳本錯誤排查清單 6.3 Bash 相關學習資源 6.4 專案內部 Bash 腳本規範 第 1 部分：基礎入門 1.1 認識 Bash 與 Shell 📖 簡介 Bash（Bourne Again Shell）是一個命令列介面程式，也是一種腳本語言。它是 Linux 和 macOS 系統的預設 Shell，用於執行命令、自動化任務和系統管理。 ...