Agent Skills教學手冊
Agent Skills 教學手冊(企業級 SSDLC + GitHub Copilot + Claude Code) 版本:v1.1.0 更新日期:2026-04-1 適用對象:資深工程師、架構師、Tech Lead、DevSecOps 工程師 技術棧:Agent Skills 開放標準、GitHub Copilot Skills、Claude Code Skills、VS Code、Spring Boot、Vue 3 規範參考:Agent Skills Specification(開放標準 v1.0) 目錄 第 1 章:Agent Skills 概念與架構 1.1 什麼是 Agent Skills 1.2 與傳統 Prompt Engineering 的差異 1.3 Skills vs Prompt vs Tool vs Agent 比較 1.4 漸進式揭露(Progressive Disclosure)設計原則 1.5 Skills 組成結構 第 2 章:Skills 平台深度解析(GitHub Copilot + Claude Code) 2.1 多平台 Skills 架構 2.2 Skills 運作流程 2.3 Skills Metadata 設計(Frontmatter 完整參考) 2.3.1 開放標準欄位(agentskills.io Specification) 2.3.2 Claude Code 擴展欄位 2.3.3 字串替換(String Substitutions) 2.3.4 動態上下文注入(Dynamic Context Injection) 2.4 Claude Code 內建 Skills(Bundled Skills) 2.5 Skills 與 Agent 整合方式 2.6 Skills Repository 設計(企業級) 第 3 章:SSDLC × Skills(核心章節) 3.1 Requirements(需求階段) 3.2 Design(設計階段) 3.3 Development(開發階段) 3.4 Testing(測試階段) 3.5 Security(安全) 3.6 Deployment(部署) 3.7 Maintenance(維運) 第 4 章:Skills 設計最佳實務 4.1 高可重用性設計 4.2 低 Token 消耗策略 4.3 命名規範 4.4 模組化與版本控管 4.5 安全性與權限控管 第 5 章:Skills 實作教學(Hands-on) 5.1 範例 1:產生 API 設計文件 Skill 5.2 範例 2:程式碼審查 Skill 5.3 範例 3:Spring Boot 服務生成 Skill 第 6 章:企業級 Skills Repository 架構 6.1 建議 GitHub Repo 結構 6.2 Skills 分類策略 6.3 權限控管(RBAC) 6.4 與 CI/CD 整合 第 7 章:與開發工具整合 7.1 GitHub Copilot 整合 7.2 Claude Code 進階整合 7.3 VS Code 整合 7.4 CI/CD(GitHub Actions)整合 7.5 Issue / PR 流程整合 第 8 章:Skills 治理(Governance) 8.1 Skills 審核機制 8.2 品質控管(Quality Gate) 8.3 安全審查(Security Review) 8.4 使用追蹤與優化(Telemetry) 第 9 章:常見錯誤與反模式 9.1 過度設計 Skills 9.2 Token 爆炸問題 9.3 Skills 過於耦合 9.4 其他常見反模式 第 10 章:未來趨勢 10.1 Agentic Workflow 10.2 Multi-Agent Collaboration 10.3 Skills Marketplace 與開放生態 附錄 A:企業導入檢查清單 附錄 B:Prompt → Skill 轉換速查表 附錄 C:常用 Skills 清單 附錄 D:參考資源 第 1 章:Agent Skills 概念與架構 1.1 什麼是 Agent Skills 定義:Agent Skills 是一種基於 agentskills.io 開放標準的模組化、可重複使用「AI 能力包」(Capability Package),以資料夾形式存在,內含說明文件(SKILL.md)、腳本(Python / Bash / PowerShell)、範本(Templates)和參考資源(References)。 ...