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 的使用方式。 ...

OpenSpec 使用教學手冊 版本：5.0 更新日期：2026-04-27 適用版本：OpenSpec v1.3.1（含 Profiles、OPSX 工作流程、動態指令架構、語義規格同步、Canonical Artifact Paths、Junie / Lingma / ForgeCode / IBM Bob 新工具支援） 適用對象：新進軟體工程師、系統分析師、尚未接觸過 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.3.x） v1.3.1 版本重要更新 v1.3.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 如何從「會寫」進階到「寫得好」 第八章小結 第九章：進階主題 9.1 Progressive Rigor（漸進式嚴謹度） 9.2 Multi-Language 支援 9.3 自訂 Schema 進階用法 9.4 人類與 Agent 協作模式 第九章小結 附錄：檢查清單（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 助手在沒有明確規格的情況下，容易產生不符合需求的程式碼，或是理解偏差導致返工。 ...

Spec-Kit 使用教學手冊 版本: 9.0 最後更新: 2026年5月14日 適用於: Spec-Kit v0.8.9+ / Spec Kit Templates - 0.8.9 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 倉庫分支與版本控制建議 2.7 擴充系統 (Extension System) 2.8 預設系統 (Presets System) 2.9 CLI 診斷指令 (doctor / status) 2.10 Plugin Architecture（v0.4.4-0.4.5 重大架構變革） 2.11 整合管理指令 (specify integration) 2.12 Git 擴充 (Bundled Git Extension) 2.13 工作流引擎 (Workflow Engine, v0.7.0) 2.14 –integration 旗標（v0.7.1 取代 –ai） 2.15 Self Management 指令（v0.7.5 新增） 2.16 預設組合策略 (Composition Strategies, v0.8.0) 2.17 Skills-Based Scaffolding（v0.8.0 新增） 2.18 feature.json 自訂分支支援（v0.8.1 新增） 2.19 –no-git 旗標棄用與 GITHUB_TOKEN 認證（v0.8.2 新增） 2.20 目錄探索 CLI 與 Devin 整合（v0.8.3 新增） 2.21 Constitution 上下文載入與治理擴充（v0.8.4–v0.8.6 新增） 2.22 Lingma 整合與 Agent Orchestrator（v0.8.7 新增） 2.23 Config-Driven 認證與排程擴充（v0.8.8 新增） 2.24 治理生態系擴充與 BrownKit（v0.8.9 新增） 第三章:使用流程詳細說明 3.1 Step 1:撰寫 Spec (/speckit.specify) 3.2 Step 1a:澄清模糊需求 (/speckit.clarify) 3.3 Step 2:撰寫 Plan (/speckit.plan) 3.3a Step 2a:驗證 Plan (Plan Validation) 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 社群實作範例 (Community Walkthroughs) 6.5 社群工具生態系 (Community Friends) 6.6 術語表 6.7 快速指令參考 6.8 版本異動紀錄 (Changelog 摘要) 結語 前言 目的與適用對象 本手冊旨在幫助開發團隊快速掌握 Spec-Driven Development (SDD) 方法論,並透過 Spec-Kit 工具組與 AI 助手協作,建立高品質、可維護的軟體系統。 ...

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 助手協作,建立高品質、可維護的軟體系統。 ...

Visual Studio Code 使用教學手冊 完整的 VS Code 開發環境設定與實戰指南 涵蓋前端 (Vue 3 + TypeScript) 與後端 (Spring Boot) 開發，適用於團隊協作與企業級專案開發 📋 目錄 1. VS Code 安裝與環境設定 1.1 安裝步驟 1.2 推薦字型與主題 1.3 專案必要的 Extensions 清單 1.3.1 基礎開發工具 1.3.2 前端開發 1.3.3 後端開發 1.3.4 Python 開發 1.3.5 AI 輔助開發 1.3.6 一鍵安裝指令 1.4 設定同步功能 1.5 實務案例與注意事項 2. 專案開發環境配置 2.1 如何開啟專案 2.2 前端、後端工作區設定 2.3 編碼規範設定 2.3.1 前端編碼規範 (ESLint + Prettier) 2.3.2 後端編碼規範 (Checkstyle) 2.3.3 Maven 獨立安裝設定 2.4 容器化開發環境 (Dev Containers) 2.5 實務案例與注意事項 3. 日常開發操作 3.1 Git 與 GitHub/GitLab 整合 3.2 常用快捷鍵 3.3 偵錯與斷點設定 3.4 終端機與多工作區使用 3.5 程式碼片段 (Snippets) 使用 3.6 AI 輔助開發 — GitHub Copilot 3.6.1 程式碼自動完成與 Next Edit Suggestions 3.6.2 Copilot Chat 對話式助手 3.6.3 Inline Chat（行內聊天） 3.6.4 智慧動作 3.6.5 Agent 模式與 Agent Sessions 3.6.6 Autopilot 與 Agent 權限控制 3.6.7 Plan Agent（計畫代理） 3.6.8 自訂指示檔 3.6.9 MCP 伺服器整合 3.6.10 Custom Agents（自訂代理） 3.6.11 Agent Skills（代理技能） 3.6.12 Prompt Files（提示檔案） 3.6.13 Hooks（生命週期鉤子） 3.6.14 語言模型選擇 3.7 實務案例與注意事項 4. 專案特定開發流程指引 4.1 前端開發流程 4.2 後端開發流程 4.3 全端開發工作流程 4.4 程式碼品質檢查 4.5 效能監控與分析 4.6 實務案例與注意事項 4.7 Python 開發環境設定 4.7.1 Python 專案結構 4.7.2 Python 環境設定 4.7.3 Python 開發工具設定 4.7.4 Python 偵錯設定 4.7.5 Python 任務設定 4.7.6 Python 專案範例 4.7.7 Python 開發最佳實務 5. 協作開發功能 5.1 Live Share 即時協作 5.2 多人開發設定 5.3 程式碼審查工具 5.3.1 GitHub Pull Request 整合 5.3.2 GitLab Merge Request 整合 5.3.3 程式碼審查檢查清單 5.4 團隊協作最佳實務 6. 進階功能與擴充 6.1 自訂程式碼片段 6.2 擴充功能開發入門 6.3 工作流程自動化 6.3.1 Task 自動化 6.3.2 GitHub Actions 整合 6.3.3 GitLab CI/CD 整合 6.4 效能優化進階技巧 6.5 遠端開發與 SSH 6.6 工作區管理進階技巧 6.7 設定檔 (Profiles) 管理 6.8 Chat Customizations 編輯器 7. 最佳實務 7.1 常見問題 (FAQ) 與解決方式 7.2 建議的工作習慣 7.3 效能最佳化 7.4 安全性最佳實務 7.5 團隊協作規範 8. 檢查清單 8.1 新進成員快速上手檢查清單 8.2 日常開發檢查清單 8.3 部署前檢查清單 8.4 故障排除檢查清單 9. 附錄 9.1 參考資源 9.2 版本歷程 1. VS Code 安裝與環境設定 1.1 安裝步驟 1.1.1 下載與安裝 前往 Visual Studio Code 官方網站 點擊 “Download for Windows” 下載安裝檔 執行安裝檔，建議勾選以下選項： ✅ 新增至 PATH (在重新啟動後可用) ✅ 在檔案總管中的檔案上顯示「使用 Code 開啟」動作 ✅ 在檔案總管中的目錄上顯示「使用 Code 開啟」動作 ✅ 將 Code 註冊為支援的檔案類型的編輯器 1.1.2 首次啟動設定 啟動 VS Code 選擇適合的色彩主題 登入 Microsoft 帳戶（可選，用於同步設定） 1.2 推薦字型與主題 1.2.1 推薦字型 建議安裝並使用以下等寬字型： ...