Claude Code 建立 SSDLC Agent Team 教學手冊
Claude Code 建立 SSDLC Agent Team 教學手冊 版本:1.1.0 | 最後更新:2026-04-24 | 作者:企業級 AI Agent 架構顧問團隊 適用對象:資深工程師、架構師、技術主管、DevSecOps、人員培訓 定位:企業級白皮書等級教學手冊,可直接作為團隊導入與治理規範 目錄 Ch 0:文件資訊與閱讀指南 0.1 文件基本資訊 0.2 使用前提與先決條件 0.3 閱讀地圖 0.4 功能狀態標示規則 0.5 核心名詞定義 0.6 版本變更紀錄 Ch 1:總覽:什麼是 Claude Code SSDLC Agent Team 1.1 為什麼企業需要 SSDLC Agent Team 1.2 與其他方法的差異比較 1.3 Claude Code 在 SSDLC 各階段的角色 1.4 新系統開發 vs. 舊系統逆向工程 1.5 整體架構圖 1.6 企業導入價值 1.7 典型使用情境 Ch 2:功能盤點與術語對照 2.1 14 項功能概述 2.2 功能矩陣表 2.3 平台差異比較表 2.4 概念差異比較表 2.5 功能穩定性狀態對照表 2.6 容易混淆術語表 2.7 Subagent 限制速查表 2.8 Config Hierarchy 與 CLAUDE.md 載入順序速查 Ch 3:Claude Code SSDLC Agent Team 企業架構設計 3.1 Agent Team 整體架構圖 3.2 Agent 間協作流程圖 3.3 十個 Agent 角色詳細定義 3.4 Subagents vs Agent Teams 比較圖 3.5 Subagent vs Agent Team 決策矩陣 3.6 Agent 與 SSDLC 階段對應表 3.7 Agent RACI 矩陣 3.8 必須人工審核的清單 3.9 權限過大的風險與防範 Ch 4:平台安裝與環境建置 4.1 安裝前提 4.2 Windows 安裝 4.3 macOS 安裝 4.4 Linux 安裝 4.5 VS Code Extension 安裝 4.6 CLI 認證方式 4.7 Permission Mode 比較表 4.8 公司允許模型設定 4.9 最佳起始設定 4.10 常見安裝錯誤與排除 Ch 5:專案初始化與標準目錄設計 5.1 標準目錄樹 5.2 每個檔案與目錄用途說明 5.3 核心設定檔範例 5.4 命名規範 5.5 版本控管策略 5.6 .gitignore 建議 5.7 Plugins 與 Marketplace 策略 5.8 快速初始化腳本 Ch 6:建立 Agent 與 Subagent 6.1 概念總覽:Subagent、Custom Subagent 與 Agent Team Teammate 6.2 Subagent 與主對話的差異 6.3 Subagent vs. Agent Team 比較 6.4 自動呼叫 vs. 明確呼叫 6.5 前景 vs. 背景執行與 Fork Mode 6.6 權限、Tools、Model 與 Isolation 6.7 不可巢狀限制 6.8 完整範例 6.9 Worktree Isolation 範例 6.10 Anti-Patterns(5 個常見錯誤) 6.11 Agent Team Subagent Definition 正確說明 Ch 7:建立 Prompt Library 與 Team Prompt SOP 7.1 Prompt 在 Claude Code 生態系中的定位 7.2 企業級 Prompt Catalog 架構 7.3 版本管理策略 7.4 Prompt 範本集(10 個) Ch 8:建立 Skills 8.1 Skills 定義與核心概念 8.2 Skills 與相關功能的差異 8.3 自動觸發 vs. 手動觸發 8.4 Supporting Files 8.5 context:fork 與 Compaction 注意事項 8.5.1 Skills 進階 Frontmatter 欄位 8.5.2 Agent Skills 開放標準 8.6 完整 Skill 範例(7 個) 8.7 內建 Skills 參考 Ch 9:建立 Hooks 與 Guardrails 9.1 Hooks 概述:確定性控制層 9.2 Hook 類型 9.3 Hook 事件 9.4 Matcher 語法 9.5 Hook 設定結構 9.6 Hooks 與 Permission Mode 的關係 9.7 Hook 除錯方式 9.8 範例 1:保護敏感檔案不可修改 9.9 範例 2:只允許唯讀 SQL 查詢 9.10 範例 3:變更後自動格式化 9.11 範例 4:Teammate 完成任務前的品質 Gate 9.12 範例 5:偵測設定檔變更並寫入 Audit Log 9.13 範例 6:自動補充 Compact 後的關鍵上下文 9.14 範例 7:HTTP Hook 串接企業稽核服務 9.15 實務建議 Ch 10:建立 Plugins 與 Marketplace Strategy 10.1 何時用 Plugin vs. Standalone Config 10.2 Plugin 結構 10.3 plugin.json Manifest 格式 10.4 Plugin Subagent 限制 10.5 安裝範圍 10.6 Marketplace 差異 10.7 安全與信任模型 10.8 範例 1:plugin.json 完整範例 10.9 範例 2:Skills 型 Plugin 10.10 範例 3:Agents 型 Plugin 10.11 範例 4:Hooks 型 Plugin 10.12 範例 5:Team Marketplace 設定 10.13 範例 6:Plugin 升級與版本控管策略 10.14 實務建議 Ch 11:Memory、CLAUDE.md 與知識治理 11.1 CLAUDE.md 的角色 11.2 CLAUDE.md 載入順序 11.3 Auto Memory 11.4 Memory vs. CLAUDE.md vs. Skills 11.5 Config Hierarchy 與記憶的關係 11.6 與其他文件的分工 11.7 記憶檔案避免膨脹與污染的方法 11.8 CLAUDE.md 範本 1:通用專案 11.9 CLAUDE.md 範本 2:Security 導向 11.10 CLAUDE.md 範本 3:Reverse Engineering 導向 11.11 記憶治理原則 11.12 清理與維護策略 11.13 實務建議 Ch 11-A:Output Styles(輸出風格) 11-A.1 概述 11-A.2 內建風格 11-A.3 自訂 Output Style 11-A.4 Plugin 提供的 Output Styles 11-A.5 keep-coding-instructions 欄位 11-A.6 切換 Output Style 11-A.7 SSDLC 建議 Ch 11-B:Scheduled Tasks(排程任務) 11-B.1 概述 11-B.2 建立排程任務 11-B.3 任務類型 11-B.4 /loop Skill 11-B.5 管理排程任務 11-B.6 搭配 Hooks 11-B.7 SSDLC 應用場景 11-B.8 治理建議 Ch 12:MCP 與 Tools 整合架構 12.1 什麼是 MCP(Model Context Protocol) 12.2 MCP Scope 與設定檔層級 12.3 Transport 機制:HTTP / stdio / SSE 12.4 OAuth、Headers 與安全整合 12.5 進階 MCP 功能 12.6 Claude Code 作為 MCP Server 12.7 Claude Code 作為 MCP Server 12.8 MCP 與 Plugins 的整合 12.9 MCP 與企業治理 12.10 MCP 安全風險 12.11 完整範例 12.10 MCP 安裝與驗證 12.11 list_changed Notification 12.12 實務建議 Ch 13:Programmatic CLI、GitHub Actions 與 GitLab CI/CD 13.1 CLI 互動模式 vs Programmatic CLI 13.2 Programmatic CLI 用法 13.3 Provider 差異說明 13.4 GitHub Actions 整合 🟢 GA 13.5 GitLab CI/CD 整合 🟡 Beta 13.6 API Key / OIDC / Secret 治理 13.7 何時用互動式 vs CI 自動化 13.8 CI/CD 與 Agent 自動化流程圖 13.9 實務建議 Ch 14:將 Agent、Prompt、Skills、Hooks、Memory、MCP 融入 SSDLC 14.1 為什麼需要融入 SSDLC 14.2 Agent 協作圖 14.3 SSDLC 14 階段總覽 14.4 各階段詳細設計 14.5 SSDLC SOP 總覽表 14.6 安全 Gate 建議 14.7 KPI 建議 14.8 實務建議 Ch 15:舊系統逆向工程與現代化改造專章 15.1 方法論總覽 15.2 十一項任務說明 15.3 Reverse Engineering Agent 設計 15.4 專用 Prompt 範例 15.5 專用 Skills 範例 15.6 專用 Hooks / Guardrails 範例 15.7 輸出範本:架構還原文件格式 15.8 風險與注意事項 Ch 16:提供給其他團隊使用的共享 SOP 16.1 Team Onboarding 流程 16.2 Starter Repository 設計 16.3 共享 Plugins / Skills / Agents / Hooks 治理方式 16.4 文件模板 16.5 教育訓練計畫(4 階段) 16.6 支援模式(L1/L2/L3) 16.7 FAQ(團隊導入常見問題) 16.8 變更公告機制 16.9 例外申請流程 16.10 成熟度模型(5 個等級) 16.11 啟用 Checklist 16.12 角色分工表 16.13 常見阻力與解法 16.14 實務建議 Ch 17:安全、治理、稽核與成本控管 17.1 最小權限原則 17.2 Hooks Guardrails 17.3 Secrets 管理 17.4 敏感檔案保護 17.5 Prompt Injection 風險 17.6 MCP 風險 17.7 Plugin Marketplace 風險 17.8 Agent Teams 權限與成本風險 17.9 CI 自動化風險 17.10 Logs / Audit Trail / Compliance 17.11 風險矩陣表 17.12 模型使用策略 17.13 成本監控指標表 17.14 控制點設計表 17.15 不建議做法清單 17.16 實務建議 Ch 18:系統維護、升級與相容性管理 18.1 維護總覽 18.2 各項升級 SOP 18.3 相容矩陣範例 18.4 回滾計畫 18.5 版本管理建議 18.6 Experimental → GA 調整 18.7 文件更新流程 18.8 例行巡檢 18.9 升級排程建議 18.10 實務建議 Ch 19:完整實戰案例 19.1 案例一:新建 Spring Boot Web 專案 19.2 案例二:舊系統逆向工程與現代化 19.3 兩個案例的共通學習 19.4 實務建議 Ch 20:FAQ 與 Troubleshooting 20.1 Agent Teams 為何無法啟動? 20.2 Subagent 為何沒有被自動委派? 20.3 Skills 為何沒有觸發? 20.4 Hooks 為何沒有生效? 20.5 MCP 為何沒有連上? 20.6 Plugins 為何沒有載入? 20.7 VS Code 與 CLI 為何行為不同? 20.8 GitHub Actions 與 GitLab CI/CD 該怎麼選? 20.9 Reverse Engineering 時如何降低幻覺? 20.10 何時該用 subagent,何時該用 agent team? 20.11 何時該用 hook,何時該用 skill? 20.12 如何避免記憶污染與 context 膨脹? 20.13 如何降低 token 成本? 20.14 實務建議 Ch 21:最佳實務、Anti-Patterns 與 Checklist 21.1 企業最佳實務(10 項) 21.2 團隊最佳實務(8 項) 21.3 開發者最佳實務(8 項) 21.4 Reverse Engineering 最佳實務(6 項) 21.5 常見錯誤 / Anti-Patterns(10 個) 21.6 Checklist 1:新團隊導入 Checklist 21.7 Checklist 2:專案初始化 Checklist 21.8 Checklist 3:SSDLC 各階段 Checklist 21.9 Checklist 4:上線前 Checklist 21.10 Checklist 5:升級前 Checklist 21.11 實務建議 Ch 22:附錄 — 可直接複製使用的完整範本 22.1 範本 1:CLAUDE.md 範本 22.2 範本 2:.claude/settings.json 範本 22.3 範本 3:.mcp.json 範本 22.4 範本 4:Subagent 範本 22.5 範本 5:SKILL.md 範本 22.6 範本 6:Hook 設定範本 22.7 範本 7:plugin.json 範本 22.8 範本 8:GitHub Actions Workflow 範本 22.9 範本 9:GitLab CI/CD Job 範本 22.10 範本 10:Reverse Engineering Prompt 範本 22.11 範本 11:Onboarding Checklist 範本 22.12 範本 12:Governance Policy 範本 22.13 實務建議 Ch 0:文件資訊與閱讀指南 0.1 文件基本資訊 欄位 內容 文件名稱 Claude Code 建立 SSDLC Agent Team 教學手冊 文件版本 1.1.0 最後更新日期 2026-04-24 作者 / 角色定位 企業級 AI Agent 架構顧問團隊 適用對象 資深工程師、架構師、技術主管、DevSecOps、人員培訓 前提條件 需有 Claude Code 存取權限、VS Code(v1.98.0+)、Git 授權範圍 限公司內部使用,不可外流 分類 技術白皮書 / 教學手冊 0.2 使用前提與先決條件 在閱讀本手冊前,請確認您已具備以下條件: ...