Github Repositories 建立教學手冊

Github Repositories 建立與維運教學手冊 — 企業級實戰指南 版本:v2.1(2026-07-03) 適用對象:技術主管 / 架構師 / 資深工程師 / DevOps 團隊 / 專案經理 定位:企業標準技術白皮書 參考標準:GitHub Docs(2026) / GitHub Enterprise Best Practices / DevSecOps / SSDLC 最後審閱日期:2026-07-03 變更紀錄: v2.0 — 新增 Repository 限制與配額、Rulesets 深入指南、Merge Queue、Git LFS、Codespaces、Packages、Private Vulnerability Reporting 等章節;全面校閱並對齊 GitHub 官方文件(2026 年版) v2.1 — 校正 Git LFS 配額表(改採 2025 年後用量計費模式);更新 GHAS 功能矩陣以反映 Secret Protection / Code Security 拆分方案;擴充 Rulesets 個人 Bypass Actor 與分支更名規則;補強 Merge Queue GA 狀態與運作細節;新增 8.8 Actions 安全性強化與 2026 路線圖、9.9 開源授權合規檢查;更新 Private Vulnerability Reporting 2026 年營運現況;新增 13.8 GitHub Copilot Code Review、13.9 Copilot 平台最新動態與方案,並擴充 13.6 Coding Agent 進階能力;補充 Codespaces 資料落地與 GitHub CLI Discussions 子指令;修正附錄 A 目錄缺漏與清單格式(改為 GitHub Task List 語法);全面校對並對齊 GitHub 官方文件(2026 年 7 月版) 閱讀指引 本手冊涵蓋 GitHub Repository 從建立到維運的完整生命週期,依讀者角色建議閱讀路徑: ...

July 3, 2026 · 69 min · 14675 words · Eric Cheng

Compound Engineering 教學手冊

Compound Engineering 教學手冊 版本:v3.16.0(2026-06-30) 適用平台:Claude Code / Cursor / Codex / OpenCode / GitHub Copilot / Kimi Code / Antigravity (agy) / Factory Droid / Qwen Code / Pi 等 授權:MIT License GitHub:https://github.com/EveryInc/compound-engineering-plugin 文件等級:企業標準技術白皮書 最後更新:2026-06-30 目錄 第一章:概述 1.1 什麼是 Compound Engineering(複利工程) 1.2 與傳統 AI Coding 工具比較 1.3 核心設計哲學 1.4 適用場景 1.5 開發成熟度階段模型 第二章:系統架構整合 2.1 整體架構圖 2.2 Plugin 元件總覽 2.3 核心概念詞彙表 2.4 與企業系統整合方式 2.5 Skill Workflow 設計 2.6 知識庫(Knowledge Base)設計 第三章:安裝與環境建置 3.1 前置需求 3.2 Claude Code 安裝 3.3 Cursor 安裝 3.4 Codex 安裝(App / CLI) 3.5 GitHub Copilot 安裝 3.6 其他平台安裝 3.7 升級現有安裝 3.8 ce-setup 環境診斷與初始化 3.9 Windows 環境設定 3.10 CI/CD 環境設定 3.11 本地開發模式 第四章:核心功能教學 4.1 核心工作流總覽 4.2 /ce-ideate — 創意探索 4.3 /ce-brainstorm — 需求發散 4.4 /ce-plan — 計畫制定 4.5 /ce-work — 開發執行 4.6 /ce-simplify-code — 程式碼精簡 4.7 /ce-code-review — 結構化品質審查 4.8 /ce-compound — 知識沉澱 4.9 /ce-debug — 除錯追蹤 4.10 /ce-optimize — 最佳化迴圈 4.11 /ce-pov — 技術裁決 4.12 /ce-strategy — 策略定錨 4.13 /ce-product-pulse — 產品脈搏 4.14 /ce-dogfood — 自動化瀏覽器 QA 4.15 /ce-test-browser — 瀏覽器測試 4.16 /ce-test-xcode — iOS 應用測試 4.17 /lfg — 全自動工程工作流 4.18 錯誤案例與修正 第五章:企業級開發流程設計 5.1 AI Agent 開發流程(SSDLC 整合) 5.2 與 Git Flow 整合 5.3 與 CI/CD 整合 5.4 Code Review 自動化 5.5 測試策略 第六章:最佳實務(Best Practices) 6.1 Prompt Engineering — 如何寫好 ce-plan 6.2 Context Engineering — 上下文管理 6.3 Knowledge Reuse — 複利最大化 6.4 防止 AI Hallucination 6.5 隱私與安全政策 6.6 Agent-Native 架構設計 6.7 需要放下的信念 第七章:系統維運(Maintenance) 7.1 知識庫管理策略 7.2 Plugin 效能調校 7.3 Log / Monitoring 設計 7.4 問題排查(Troubleshooting) 第八章:系統升級(Upgrade Strategy) 8.1 Plugin 升級流程 8.2 知識庫版本控制 8.3 向下相容策略 8.4 災難復原(Disaster Recovery) 第九章:企業導入建議 9.1 導入策略(Pilot → Rollout) 9.2 團隊角色轉變 9.3 KPI 設計 9.4 教育訓練計畫 9.5 團隊協作模式 第十章:完整實戰案例 10.1 案例背景 10.2 ce-brainstorm — 需求發散 10.3 ce-plan — 任務拆解 10.4 ce-work — 產生程式碼 10.5 ce-simplify-code — 精簡程式碼 10.6 ce-code-review — 改善品質 10.7 ce-compound — 知識沉澱 附錄 A:Skills 完整參考表 附錄 B:Specialist Prompt Assets 參考表 附錄 C:常用指令 Cheat Sheet 附錄 D:新進成員檢查清單(Checklist) 附錄 E:參考資源與延伸閱讀 第一章:概述 1.1 什麼是 Compound Engineering(複利工程) Compound Engineering(複利工程)是由 Every Inc. 提出的軟體工程方法論,以開源 Plugin 形式實現。其核心理念為: ...

June 30, 2026 · 28 min · 5892 words · Eric Cheng

GitNexus教學手冊

GitNexus 教學手冊(企業級完整版) 版本:v1.6.8(2026-06 基準,含 PDG / Taint Analysis、MCP Trace 工具、Private Repos via PAT、DevContainer、MCP HTTP Server) 適用對象:資深工程師 / 架構師 / DevOps / AI Agent 開發者 授權:PolyForm Noncommercial 1.0.0(企業授權另洽 akonlabs.com) 維護單位:內部 AI 開發組 GitHub:github.com/abhigyanpatwari/GitNexus (⭐ 43.3k+ Stars / 163+ Contributors) OpenSSF Scorecard:securityscorecards.dev ⚠️ 重要警告:GitNexus 沒有官方加密貨幣、代幣或硬幣。任何在 Pump.fun 或其他平台上使用 GitNexus 名稱的代幣/硬幣,均非本專案或其維護者所屬、認可或建立。請勿購買任何聲稱與 GitNexus 相關的加密貨幣。 目錄 第 1 章:GitNexus 概述 1.1 GitNexus 是什麼 1.2 核心理念 1.3 與傳統工具比較 1.4 適用場景 第 2 章:系統架構說明 2.1 整體架構圖 2.2 核心組件說明 2.3 Web UI vs CLI 架構差異 2.4 Multi-Repo MCP 架構 第 3 章:安裝與環境設定 3.1 系統需求 3.2 CLI 安裝 3.3 Web UI 使用 3.4 MCP 編輯器設定 3.5 Docker 部署 3.6 常見問題排除 第 4 章:基本操作教學 4.1 建立 Knowledge Graph 4.2 CLI 常用指令 4.3 查詢程式碼關聯 4.4 視覺化圖譜操作 4.5 Repository 群組管理 第 5 章:進階應用 5.1 Graph RAG 使用方式 5.2 Impact Analysis(影響分析) 5.3 Process-Grouped Search 5.4 360 度 Symbol Context 5.5 Git-Diff 變更偵測 5.6 Multi-File Rename 5.7 Cypher 原生查詢 5.8 Wiki 自動生成 5.9 Incremental Indexing(增量索引) 5.10 PDG / 程式依賴圖分析 5.11 Taint Analysis(污染分析) 5.12 Trace(呼叫路徑追蹤) 5.13 Private Repos 與 Azure DevOps Server 5.14 HTTP Route Extraction(HTTP 路由提取) 5.15 DevContainer 開發環境 第 6 章:整合企業開發流程 6.1 與 GitHub / GitLab 整合 6.2 與 AI 工具整合 6.3 與開發架構整合 6.4 DevOps 整合 6.5 Community Integrations(社群整合) 6.6 開發文件與貢獻指南 6.7 understand-quickly 公開註冊 第 7 章:銀行 / 大型系統應用案例 7.1 案例一:批次系統依賴分析 7.2 案例二:跨系統 API 呼叫分析 7.3 案例三:DB Schema 影響分析 第 8 章:安全與隱私(SSDLC) 8.1 Zero-Server 優勢 8.2 原始碼保護 8.3 本地 AI 模型風險 8.4 權限控管建議 8.5 安全強化歷史與已知修復 8.6 Taint Analysis 安全審計應用 8.7 供應鏈保護(Supply-Chain Protection) 第 9 章:系統升級與維運 9.1 GitNexus 升級流程 9.2 Graph 重建策略 9.3 Repository 更新同步 9.4 效能優化建議 9.5 LadybugDB 遷移指南 9.6 Edge Type 遷移(OVERRIDES → METHOD_OVERRIDES) 第 10 章:最佳實務(Best Practices) 10.1 大型專案使用建議 10.2 Monorepo vs Multi-repo 10.3 團隊導入策略 10.4 使用限制與風險 第 11 章:常見問題 FAQ 第 12 章:未來發展與建議 12.1 Graph RAG 未來趨勢 12.2 與 Agent 系統整合 12.3 企業導入 Roadmap 附錄 A:快速檢查清單(Checklist) 附錄 B:CLI 指令速查表 附錄 C:MCP 工具速查表 附錄 D:語言能力詳細矩陣 附錄 E:Edge Type(關係類型)速查表 附錄 F:Docker 部署速查表 附錄 G:.gitnexusrc 專案配置速查表 附錄 H:PDG / Taint 邊類型速查表 第 1 章:GitNexus 概述 1.1 GitNexus 是什麼 🎯 目的:讓團隊成員在 5 分鐘內理解 GitNexus 的定位與價值。 ...

June 30, 2026 · 40 min · 8485 words · Eric Cheng

Gstack教學手冊

gstack 企業級教學手冊 參考版本:v1.58.5.0 | 更新日期:2026-06-30 GitHub 星數:118,000+ ⭐ | Forks:17,600+ | 貢獻者:81 位 | 授權:MIT 適用對象:資深工程師、架構師、DevOps 工程師、技術主管、創辦人與技術主管 適用場景:新創公司、企業平台、微服務架構、金融系統、iOS 開發 參考來源:https://github.com/garrytan/gstack 目錄 gstack 概述 1.1 什麼是 gstack 1.2 背景:Garry Tan 與 YC 1.3 與傳統 Prompt Engineering 的差異 1.4 與 GitHub Copilot / AI Agent 的比較 1.5 適用場景 1.6 版本與現況 核心架構設計 2.1 企業級系統整體架構 2.2 AI Agent 協作架構圖 2.3 分庫分表設計 2.4 Clean Architecture(後端服務) 2.5 gstack 內部架構 安裝與環境建置 3.1 必備環境 3.2 安裝 Claude Code 3.3 安裝 gstack(推薦:Team Mode) 3.4 加入專案供團隊共用(選用) 3.5 多平台安裝支援 3.6 OpenClaw 整合 3.7 語音輸入支援 3.8 設定 CLAUDE.md 3.9 常見安裝錯誤排除 Sprint 工作流程與技能體系 4.1 Sprint 核心哲學 4.2 技能串聯關係 4.3 完整技能目錄(30+ 個) 4.4 Builder Ethos(建構者信條) 虛擬開發團隊設計(企業實戰) 5.1 團隊架構總覽 5.2 /office-hours(YC 辦公室時光) 5.3 /plan-ceo-review(CEO 視角) 5.4 /plan-eng-review(工程主管視角) 5.5 /plan-design-review(設計師視角) 5.6 /review(資深工程師審查) 5.7 /qa(QA 主管) 5.8 /cso(首席資安官) 5.9 /ship(發布工程師) 5.10 /investigate(系統偵錯) 端到端開發流程 6.1 完整開發流程圖 6.2 各步驟執行指令 6.3 分支策略與 PR 規範 實戰案例:會員管理系統 7.1 系統設計概覽 7.2 API 設計 7.3 DB Schema 7.4 Clean Architecture 後端實作 7.5 前端(Vue 3) 7.6 gstack 技能參與對照表 DevOps 與自動化 8.1 CI/CD 架構圖 8.2 GitHub Actions CI 設定 8.3 Dockerfile(多階段建置) 8.4 /land-and-deploy 一鍵部署 8.5 /canary 金絲雀監控 8.6 /benchmark 效能基準 並行 Sprint 與瀏覽器模式 9.1 並行 Sprint 架構 9.2 Conductor 整合 9.3 瀏覽器模式(/browse) 9.4 真實 Chrome 模式($B connect) 9.5 CSS Inspector 與 Live Style 編輯 9.6 瀏覽器交接(Browser Handoff) 9.7 持續檢查點模式(Continuous Checkpoint) 9.8 Domain Skills 與 CDP Escape Hatch 系統維運 10.1 日誌策略(Log4j2 + ELK) 10.2 監控儀表板(Prometheus + Grafana) 10.3 AI 協助 Debug(gstack Investigate Mode) 10.4 錯誤追蹤(Sentry 整合) 系統升級與擴展 11.1 gstack 升級策略 11.2 多平台自動升級 11.3 自訂 SKILL.md 擴展 11.4 多專案管理 11.5 Plugin 與 Skill 擴充 11.6 解除安裝 企業級安全設計 12.1 /cso 安全審查流程 12.2 身份驗證(OAuth2 + JWT) 12.3 RBAC 權限控管 12.4 SAST / DAST 整合 12.5 AI 生成代碼安全風險管控 12.6 瀏覽器模式安全加固 12.7 Layer C 反偵測機制 最佳實務 Best Practices 13.1 企業導入十二大建議 13.2 常見錯誤 13.3 Anti-patterns 對照表 GBrain 持久知識系統 14.1 GBrain 概觀 14.2 安裝路徑 14.3 Per-Repo 信任機制 14.4 記憶同步與安全 14.5 Conductor 環境變數 隱私與遙測 15.1 遙測機制 15.2 資料收集範圍 15.3 本地分析報告 附錄:快速上手 Checklist 1. gstack 概述 1.1 什麼是 gstack gstack 是由 Y Combinator President & CEO Garry Tan 開源的 AI 編碼代理虛擬工程團隊技能套件,開源於 github.com/garrytan/gstack,目前已累積超過 118,000 顆星、17,600+ Forks,是目前最受矚目的 AI 輔助開發工具之一。 ...

June 30, 2026 · 40 min · 8481 words · Eric Cheng

Everything Claude Code 教學手冊

Everything Claude Code (ECC) 教學手冊 版本:v2.0.0(2026 年 6 月) 適用對象:軟體工程師(初階~資深)、架構師、DevOps / SRE、AI 工程師 授權:MIT License 官方 GitHub:https://github.com/affaan-m/ECC 官方網站:https://ecc.tools GitHub Marketplace:https://github.com/marketplace/ecc-tools Discord 社群:https://discord.gg/36yGMHGFbR 社群統計:224K+ Stars ∣ 34.3K+ Forks ∣ 289+ Contributors ∣ 12+ 語言生態系 官方指南: — Shorthand Guide(入門首選) — Longform Guide(進階深入) — Security Guide(安全防護) 📑 目錄 第一章:Everything Claude Code 架構總覽 1.1 ECC 是什麼 1.2 與傳統 Prompt Engineering 差異 1.3 Context Engineering 與 Harness Engineering 1.4 ECC 整體架構圖 1.5 Agent / Skills / Hooks / Commands 關係圖 1.6 版本演進歷程 第二章:ECC 核心組件解析 2.1 Agents(代理) 2.2 Skills(技能) 2.3 Commands & Hooks 2.4 Rules(規則) 2.5 記憶與上下文管理 2.6 Contexts(動態上下文注入) 2.7 MCP Server 配置 第三章:安裝與環境建置 3.1 前置需求 3.2 Plugin 安裝(推薦) 3.3 手動安裝 3.4 Windows PowerShell 安裝 3.5 跨 Harness 整合(Cursor / Codex / Copilot / Zed / OpenCode) 3.6 環境變數設定 3.7 Dashboard GUI 3.8 套件管理器偵測 3.9 故障復原與診斷 第四章:企業級 Web 系統架構設計(搭配 ECC) 4.1 企業系統架構背景 4.2 ECC Agent 分工架構 4.3 Orchestrator 家族(v2.0.0) 4.4 系統架構圖 4.5 Agent 協作流程 第五章:開發流程(AI 驅動) 5.1 AI 驅動開發總覽 5.2 /plan — 需求規劃 5.3 /design — 架構設計 5.4 /implement(TDD)— 實作 5.5 /test — 測試 5.6 /code-review — 程式碼審查 5.7 /deploy — 部署 5.8 /verify — 驗證迴圈 第六章:測試與品質控管 6.1 TDD Skill 實作 6.2 自動 Code Review 6.3 Plankton 程式碼品質 6.4 AgentShield 安全掃描 6.5 CI/CD 整合測試流程 6.6 驗證迴圈與評估框架 第七章:安全(SSDLC) 7.1 ECC 安全架構 7.2 安全檢查自動化 7.3 OWASP Top 10 防護 7.4 Secret Detection 7.5 GateGuard 安全閘門 第八章:部署與維運(DevOps) 8.1 CI/CD 整合 8.2 監控與日誌 8.3 AI Agent 監控 第九章:系統維護與升級 9.1 ECC 版本升級策略 9.2 Skills / Agents 管理 9.3 相容性與故障排除 第十章:最佳實踐(Best Practices) 10.1 避免上下文污染 10.2 Agent 設計原則 10.3 Skill 設計模式 10.4 Token 最佳化 10.5 平行化策略 第十一章:常見問題與排錯 第十二章:進階應用 12.1 多 Agent 協作(Multi-Agent System) 12.2 與其他 AI 工具整合 12.3 自訂 Agent 12.4 ECC 2.0 Control-Pane Substrate 12.5 NanoClaw v2 12.6 GAN 風格產生器-評估器框架 12.7 Operator Status Snapshots 12.8 Cross-Harness Architecture 附錄 A. 常用指令 Cheat Sheet B. Skills 範例模板 C. Agent 設計模板 D. 跨工具功能對照表 E. 檢查清單(Checklist) F. 生態系工具與社群資源 G. 版本變更摘要 第一章:Everything Claude Code 架構總覽 1.1 ECC 是什麼 Everything Claude Code(ECC)是一個開源的 Agent Harness Operating System(代理控制操作系統),由 Anthropic 黑客松冠軍 Affaan Mustafa 建立。 ...

June 30, 2026 · 35 min · 7394 words · Eric Cheng

Get Shit Done(GSD)教學手冊

GSD Core(Get-Shit-Done)企業級教學手冊 版本:4.0 GSD Core 版本:v1.6.0(2026-06-23 — 新 repo)/v1.42.3(2026-05-18 — 舊 repo 最終版) 適用對象:資深工程師、技術主管、架構師 最後更新:2026-06-30 定位:實戰與維運導向的內部開發規範文件 官方資源:GitHub(GSD Core) | 舊 GitHub(已歸檔) | 官方網站 | 文件站 | Discord 重要通知:GSD 專案已於 2026 年 5 月遷移至 open-gsd/gsd-core,舊 repo gsd-build/get-shit-done 已於 2026-06-26 正式歸檔(Archive),設為唯讀狀態。npm 套件名稱統一為 @opengsd/gsd-core。所有新的開發、Issues 與 Releases 均在新 repo 進行。 目錄 第一章:GSD 概述 1.1 GSD 是什麼 1.2 支援的 AI Runtime 1.3 與傳統開發的差異 1.4 與 Agile / DevOps / AI Coding 的關係 1.5 GSD 版本演進 第二章:核心概念 2.1 Meta Prompting 2.2 Context Engineering 2.3 Spec-Driven Development 2.4 Multi-Agent Orchestration 2.5 Context Rot 問題與解法 2.6 XML Prompt Formatting 2.7 Atomic Git Commits 2.8 Capability System(v1.4.0+) 2.9 Edge & Prohibition Coverage(v1.3.0+) 2.10 Decision Coverage Gates(v1.4.0+) 2.11 MemPalace 記憶整合(v1.4.0+) 第三章:系統架構設計(企業級) 3.1 GSD + AI Agent 架構圖 3.2 與 Web Application(前後端)整合方式 3.3 微服務 / Clean Architecture / Hexagonal Architecture 3.4 與資料庫整合 3.5 與 MQ / Cache / API Gateway 整合 第四章:安裝與環境建置 4.1 GSD 安裝步驟 4.2 Claude Code 設定 4.3 Gemini CLI 設定 4.4 Kimi CLI 設定(v1.4.0+) 4.5 其他 Runtime 設定 4.6 VS Code 開發環境配置 4.7 Windows / Linux 環境差異 第五章:GSD 開發流程(核心) 5.0 流程總覽 5.1 /gsd-new-project 5.2 /gsd-discuss-phase 5.3 /gsd-spec-phase — Socratic 規格釐清(v1.3.0+) 5.4 /gsd-plan-phase 5.5 /gsd-execute-phase 5.6 /gsd-verify-work 5.7 /gsd-ship 5.8 /gsd-quick — 快速任務模式 5.9 /gsd-fast — 即時內嵌任務 5.10 /gsd-progress — 狀態與流程推進 5.11 /gsd-autonomous — 全自動推進 5.12 里程碑管理 5.13 Workstreams — 並行工作流 5.14 /gsd-capture — 統一捕獲命令 5.15 Session 管理 5.16 /gsd-workspace — 工作區管理 5.17 /gsd-phase — ROADMAP 管理(v1.3.0+) 5.18 /gsd-mvp-phase — MVP 導向規劃(v1.3.0+) 5.19 /gsd-plan-review-convergence — 跨 AI 計畫收斂(v1.3.0+) 5.20 /gsd-manager — 多 Phase 指揮中心(v1.3.0+) 5.21 /gsd-surface — Skill 叢集切換(v1.2.0+) 第六章:實戰案例(Web Application) 6.1 案例背景 6.2 Phase 1:需求 → Spec 6.3 Phase 2:Spec → Plan 6.4 Phase 3:Plan → Code 6.5 Phase 4:Code → 驗證 第七章:AI 協作最佳實踐 7.1 如何避免 AI 幻覺 7.2 如何控制上下文 7.3 Prompt 設計技巧 7.4 多 Agent 協作模式 第八章:系統維運與監控 8.1 Logging 最佳實踐 8.2 Monitoring 架構 8.3 錯誤追蹤 8.4 效能調校 8.5 成本控制(AI Token) 第九章:系統升級與擴展 9.1 GSD 升級策略 9.2 Prompt Versioning 9.3 Spec Versioning 9.4 與 CI/CD 整合 第十章:安全強化機制 10.1 GSD 內建安全防護 10.2 Package Legitimacy Gate 10.3 敏感檔案保護 10.4 企業安全合規整合 10.5 Prompt Injection Guard(v1.4.0+) 10.6 Read-Injection Scanner(v1.4.0+) 10.7 OWASP ASVS Level 整合(v1.5.0+) 第十一章:企業導入策略 11.1 團隊導入流程 11.2 開發規範制定 11.3 Governance(治理) 11.4 安全與權限控管 第十二章:GSD 完整命令參考 12.1 核心工作流命令 12.2 推進與導航命令 12.3 快速執行命令 12.4 品質與安全命令 12.5 專案分析命令 12.6 捕獲與構思命令 12.7 上下文管理命令 12.8 系統管理命令 12.9 版本控制命令 12.10 工作區與里程碑命令 12.11 進階規劃命令 12.12 使用者與審計命令 12.13 Namespace Meta-Skills(路由器) 12.14 Capability 管理命令(v1.4.0+) 12.15 模型與路由命令(v1.5.0+) 12.16 狀態與漂移檢測命令(v1.5.0-v1.6.0) 12.17 CLI 工具命令 第十三章:GSD 設定參考 13.1 config.json 完整 Schema 13.2 Model Profiles 13.3 Workflow Toggles 13.4 Git Branching 策略 13.5 Hook 設定 13.6 Install Profiles 13.7 Model Policy Presets(v1.5.0+) 13.8 Dynamic Routing 設定(v1.5.0+) 13.9 Effort Control(v1.5.0+) 13.10 State Rebuild 合約(v1.5.0+) 13.11 Observability 審計追蹤(v1.5.0+) 第十四章:常見問題(FAQ) 14.1 常見錯誤 14.2 Debug 方法 14.3 Anti-Patterns 第十五章:.planning/ 目錄結構參考 15.1 完整目錄樹狀圖 15.2 核心檔案說明 15.3 Context 目錄 15.4 Specs 與 Plans 目錄 15.5 Checkpoints 與 Reports 目錄 15.6 .gitignore 建議 附錄:檢查清單(Checklist) 第一章:GSD 概述 1.1 GSD 是什麼 GSD(Get-Shit-Done)是一套輕量級 Meta-Prompting 系統,適用於 Claude Code 及其他主流 AI Coding Runtime,透過結構化的 Slash Commands 驅動 AI Agent 完成高品質的軟體交付。 ...

June 30, 2026 · 79 min · 16716 words · Eric Cheng

GitHub CLI 教學手冊

GitHub CLI 教學手冊 版本:基於 GitHub CLI v2.74.0(2026-05 最新穩定版)/GitHub Copilot CLI v1.0.65(2026-06-24 最新穩定版) 適用對象:資深工程師 / DevOps 工程師 / 架構師 / SRE / AI 團隊 技術環境:企業級 Web Application(Spring Boot / Vue / 微服務架構) 最後更新:2026-06-30 目錄 第 1 章:GitHub CLI 概述 1.1 GitHub CLI 是什麼 1.2 為何企業要導入 GitHub CLI 1.3 GitHub CLI 架構 1.4 GitHub CLI 與 Git 的差異 1.5 GitHub CLI 與 GitHub API 的關係 1.6 GitHub CLI 使用情境 1.7 GitHub CLI 優缺點 第 2 章:GitHub CLI 安裝與環境建置 2.1 Windows 安裝 2.2 macOS 安裝 2.3 Linux 安裝 2.4 WSL 安裝 2.5 驗證安裝 2.6 Proxy 設定 2.7 公司內網設定 2.8 SSH Key 建立 2.9 GPG Key 建立 2.10 Git 設定 2.11 GitHub Login 2.12 Token 管理 2.13 PAT 管理 第 3 章:GitHub Authentication 與安全管理 3.1 gh auth login 3.2 gh auth status 3.3 gh auth refresh 3.4 gh auth logout 3.5 SSH Authentication 3.6 HTTPS Authentication 3.7 PAT Token 3.8 Fine-grained Token 3.9 SSO 3.10 Enterprise Authentication 3.11 最佳安全實務 3.12 Token Rotation 3.13 Secret 管理 3.14 Least Privilege 原則 第 4 章:GitHub Repo 管理 4.1 建立 Repo 4.2 Clone Repo 4.3 Fork Repo 4.4 Rename Repo 4.5 Delete Repo 4.6 Archive Repo 4.7 Template Repo 4.8 Monorepo 4.9 Polyrepo 4.10 Repo 命名規範 4.11 Repo Governance 4.12 Repo 權限管理 4.13 Team 管理 第 5 章:Source Code 上架與管理 5.1 Git 初始化 5.2 Push Source Code 5.3 Branch 管理 5.4 Git Flow 5.5 Trunk Based Development 5.6 Feature Branch 5.7 Release Branch 5.8 Hotfix Branch 5.9 Commit Convention 5.10 Pull Request Flow 5.11 Code Review Flow 第 6 章:文件管理策略 6.1 Markdown 文件管理 6.2 docs 結構 6.3 ADR 管理 6.4 Architecture 文件 6.5 API 文件 6.6 README 標準化 6.7 Wiki 管理 6.8 GitHub Pages 第 7 章:GitHub CLI 常用指令大全 7.1 gh repo 7.2 gh pr 7.3 gh issue 7.4 gh release 7.5 gh workflow 7.6 gh run 7.7 gh api 7.8 gh alias 7.9 gh extension 7.10 gh browse 7.11 gh codespace 7.12 gh gist 7.13 gh project 7.14 gh search 7.15 gh cache 7.16 gh attestation 7.17 gh ruleset 7.18 gh label 7.19 gh variable 7.20 gh secret 7.21 gh status 7.22 gh config 第 8 章:GitHub Actions 與 Workflow Automation 8.1 GitHub Actions 架構 8.2 Workflow 基礎 8.3 Runner 與 Self-hosted Runner 8.4 Matrix Build 8.5 Cache 與 Artifact 8.6 Secret 與 Environment 8.7 CI Workflow 範例 8.8 CD Workflow 範例 8.9 Release Workflow 範例 8.10 Security Scan Workflow 8.11 AI Workflow 第 9 章:SSDLC 與 Security 9.1 Secret Scanning 9.2 Dependabot 9.3 CodeQL 9.4 Security Policy 9.5 Branch Protection 9.6 CODEOWNERS 9.7 Signed Commit 9.8 Supply Chain Security 與 SBOM 9.9 OWASP 與 DevSecOps 9.10 SAST 與 DAST 第 10 章:GitHub CLI 自動化腳本 10.1 Bash Script 10.2 PowerShell Script 10.3 Windows Batch 10.4 Python Script 10.5 Repo 初始化自動化 10.6 Branch Protection 自動化 10.7 Release Automation 第 11 章:AI 整合與 Copilot CLI 11.1 GitHub Copilot CLI 概述 11.2 Copilot CLI 安裝與設定 11.3 核心操作模式 11.4 Slash Commands 指令大全 11.5 MCP Server 整合 11.6 自訂 Agent、Skills 與 Plugins 11.7 Session 管理與記憶 11.8 Fleet 模式與子代理人 11.9 LSP 整合 11.10 Hooks 系統 11.11 企業級 Copilot CLI 管理 11.12 觀測性與監控 11.13 gh copilot 擴充套件(Legacy) 11.14 Copilot 在 PR Review 中的應用 11.15 AI-Powered Workflow 11.16 Copilot CLI 最佳實務與 AI Agent 整合策略 第 12 章:企業級最佳實務 12.1 Organization 管理 12.2 Repository Governance 12.3 Inner Source 策略 12.4 合規與稽核 12.5 Token 與權限管理 12.6 GitHub Projects 管理 12.7 多帳戶與跨平台管理 第 13 章:維運與監控 13.1 API Rate Limit 監控 13.2 Workflow 執行監控 13.3 Repo 活躍度監控 13.4 Security Alert 監控 13.5 Billing 與用量 13.6 通知管理 第 14 章:實戰案例 14.1 案例一:微服務團隊快速啟動 14.2 案例二:Release 流程自動化 14.3 案例三:Security 合規自動化 14.4 案例四:PR Review 流程優化 14.5 案例五:跨 Repo 標準化 第 15 章:故障排除(Troubleshooting) 15.1 常見錯誤與解決方案 15.2 CLI 升級與相容性 15.3 Debug 模式 15.4 Copilot CLI 常見問題 第 16 章:最佳實務總覽 16.1 日常開發 16.2 團隊協作 16.3 安全 16.4 CI/CD 16.5 自動化 第 17 章:附錄 17.1 Cheat Sheet 17.2 環境變數 17.3 設定檔位置 17.4 常用 jq 語法 17.5 FAQ 檢查清單(Checklist) 第 1 章:GitHub CLI 概述 1.1 GitHub CLI 是什麼 GitHub CLI(指令為 gh)是 GitHub 官方開發的開源命令列工具,以 Go 語言撰寫,讓開發者直接在終端機中與 GitHub 平台互動。它將 Pull Request、Issue、GitHub Actions、Release 等 GitHub 核心功能帶入命令列,消除在瀏覽器與終端機之間頻繁切換的低效工作模式。 ...

June 30, 2026 · 83 min · 17604 words · Eric Cheng

Hermes Agent生態系教學手冊

Hermes Agent 生態系教學手冊(Enterprise Edition) 版本:v0.17.0(v2026.6.19 — 涵蓋 The Foundation Release + The Velocity Release + The Surface Release + The Reach Release) 適用對象:資深工程師 / 架構師 / DevOps 團隊 授權:MIT License 官方網站:hermes-agent.nousresearch.com GitHub:github.com/NousResearch/hermes-agent 官方文件:hermes-agent.nousresearch.com/docs Desktop 下載:hermes-agent.nousresearch.com(macOS / Windows / Linux) Skills Hub:agentskills.io LLM 友善文件:llms.txt / llms-full.txt 最後更新:2026 年 6 月 30 日 📑 目錄 第一章:Hermes Agent 概述 1.1 技術背景與發展 1.2 與傳統 AI 的差異 1.3 Agent vs Workflow vs RPA 比較 1.4 核心設計理念 1.4.1 Learning Loop(學習迴圈) 1.4.2 Skill System(技能系統) 1.4.3 Persistent Memory(持久記憶) 1.4.4 Model Agnostic(模型無關) 1.4.5 Voice Mode(語音模式) 1.4.6 Web Dashboard(v0.9.0+) 1.4.7 Transport 架構(v0.11.0+) 1.4.8 Autonomous Curator(v0.12.0+) 1.4.9 Multi-agent Kanban(v0.13.0+) 1.4.10 Persistent Goals(v0.13.0+) 1.4.11 Post-write Delta Lint(v0.13.0+) 1.4.12 i18n 多語言支援(v0.13.0+) 1.4.13 hermes proxy — OpenAI 相容本地代理(v0.14.0+) 1.4.14 PyPI 套件安裝(v0.14.0+) 1.4.15 /handoff 即時 Session 轉移(v0.14.0+) 1.4.16 Promptware 防禦(v0.15.0+) 1.4.17 Bitwarden Secrets Manager(v0.15.0+) 1.4.18 Skill Bundles(v0.15.0+) 1.4.19 Hermes Desktop App(v0.16.0+) 1.4.20 Background Subagents(v0.17.0+) 1.4.21 Image Editing(v0.17.0+) 1.4.22 Automation Blueprints(v0.17.0+) 1.4.23 Memory Atomic Batch Operations(v0.17.0+) 第二章:整體系統架構 2.1 架構設計概述 2.2 分層架構圖 2.3 各層級說明 2.4 多 Agent 協作架構 2.5 高可用與擴展性設計 第三章:Hermes Agent 核心機制解析 3.1 Learning Loop(學習迴圈) 3.2 Skill System(技能系統) 3.3 Memory System(記憶系統) 3.4 Planning / Execution Flow 3.5 Tool Calling 機制 3.6 Model Routing(多模型切換) 3.7 Autonomous Curator(自動技能維護) 3.8 Persistent Goals 與 Ralph Loop 3.9 Post-write Delta Lint(自動語法檢查) 3.10 Checkpoints v2(狀態持久化) 第四章:安裝與環境建置 4.1 系統需求 4.2 快速安裝(Linux / macOS / WSL2) 4.3 Native Windows 安裝 4.4 Docker / Podman 部署 4.5 Nix Flake 安裝 4.6 設定 API Key 4.7 設定檔說明 第五章:快速開始(Quick Start) 5.1 第一次對話 5.2 建立 AI Coding Agent 5.3 設定 Memory 5.4 設定 Tools 5.5 執行任務範例 第六章:進階開發(企業級) 6.1 自訂 Skill(技能封裝) 6.2 多 Agent 協作設計 6.3 Multi-agent Kanban 實戰 6.4 長期記憶設計(Vector DB) 6.5 任務拆解(Task Decomposition) 6.6 Workflow Orchestration 6.7 SOUL.md 與 Personality 系統 6.8 Context Files(專案上下文檔案) 6.9 Plugin 系統(v0.12.0+ / v0.13.0 擴充) 第七章:Voice Mode(語音模式) 7.1 語音模式概述 7.2 支援的 STT / TTS 提供者 7.3 CLI 語音互動 7.4 Telegram / Discord 語音互動 7.5 Discord Voice Channel 即時語音 7.6 企業語音整合建議 第八章:Web Application 整合 8.1 整合架構設計 8.2 FastAPI 後端整合 8.3 Spring Boot 後端整合 8.4 前端整合(Vue / React) 8.5 Agent-as-a-Service API 設計 第九章:企業級最佳實踐 9.1 安全性設計 9.1.4 安全強化(v0.5.0 — v0.13.0 持續強化) 9.2 成本控制 9.3 效能優化 9.4 Logging / Monitoring 9.5 錯誤處理與重試機制 9.6 Tips & Best Practices 第十章:部署與維運(DevOps) 10.1 Docker 部署 10.2 Kubernetes 部署 10.3 CI/CD 流程 10.4 滾動升級 10.5 災難復原(DR) 第十一章:升級與版本管理 11.1 升級策略 11.1.6 v0.13.0 升級特別注意事項 11.2 相容性管理 11.3 Migration 設計 第十二章:實戰案例 12.1 AI Coding Agent 12.2 智慧客服 Agent 12.3 銀行流程自動化 Agent 12.4 多媒體創作 Agent 第十三章:常見問題(FAQ) 第十四章:Hermes Desktop App(v0.16.0+) 附錄 A:檢查清單(Checklist) 附錄 B:指令速查表 附錄 C:環境變數參考 附錄 D:Provider 完整清單 第一章:Hermes Agent 概述 1.1 技術背景與發展 Hermes Agent 是由 Nous Research 開發的開源自我改進 AI Agent。Nous Research 是知名的 AI 研究實驗室,以訓練 Hermes、Nomos、Psyche 等開源模型聞名。 ...

June 30, 2026 · 72 min · 15230 words · Eric Cheng

Mattpocock Skills 教學手冊

mattpocock/skills 教學手冊 使用 mattpocock/skills 建構企業級 AI Coding Agent 工程治理平台 項目 說明 版本 v4.0.0 更新日期 2026-07-22 適用對象 資深工程師、架構師、Tech Lead、DevSecOps 工程師、AI 導入推動者 技術棧 mattpocock/skills(CHANGELOG v1.1.0/plugin.json v1.2.0)、Claude Code / Codex 等 Coding Agent、skills.sh 生態系、agentskills.io 開放標準、CONTEXT.md、ADR 參考來源 mattpocock/skills GitHub(180,641 stars、15,434 forks,MIT License,GitHub API 查證於 2026-07-22) 前置知識 AI Coding Agent 基本操作、Git 版本控制、基礎軟體工程概念 版本說明:本次改版(v4.0.0)已針對 mattpocock/skills v1.1.0(2026-07-08 發布)的重大重構逐項核對原始碼(SKILL.md、.claude-plugin/plugin.json、CHANGELOG.md),其中最關鍵的變動是:to-prd 更名為 to-spec、to-issues 與已刪除的 to-plan 合併為 to-tickets、wayfinder(原名 decision-mapping)由實驗性的 in-progress 轉正為正式 Engineering Skill、新增可背景執行的調研 Skill research、resolving-merge-conflicts 結束過渡期首次正式收錄進 plugin.json。另需留意:.claude-plugin/plugin.json 的版號(1.2.0)目前領先於 package.json/CHANGELOG 記載的正式版本(1.1.0),兩者尚未對齊,屬治理上的落差,詳見第 24.6 節版本紀錄與第 23 章 FAQ。 ...

May 15, 2026 · 50 min · 10486 words · Eric Cheng

GitHub Copilot 逆向工程教學手冊

GitHub Copilot 逆向工程教學手冊(Java Web) 版本:2.0 最後更新:2026-04-02 適用對象:資深工程師、架構師、技術主管 技術棧:Java 21+ / Spring Boot 3.x~4.x / GitHub Copilot(Chat / Agent Mode / Cloud Agent / CLI / MCP) 📑 目錄 第 1 章 概論 1.1 什麼是逆向工程(Reverse Engineering) 1.2 Legacy System 現代化挑戰 1.3 GitHub Copilot 在逆向工程的角色 1.4 適用情境 第 2 章 三種逆向工程策略 2.1 黑箱逆向(Black-box Reverse Engineering) 2.2 白箱逆向(White-box Reverse Engineering) 2.3 灰箱逆向(Gray-box / Hybrid) 2.4 三種策略比較總覽 第 3 章 SDLC 對應逆向工程流程 3.1 需求分析(Requirement Analysis) 3.2 系統設計(System Design) 3.3 開發(Implementation) 3.4 測試(Testing) 3.5 部署(Deployment) 第 4 章 GitHub Copilot 實戰流程 4.1 Step 1:分析舊系統 4.2 Step 2:建立理解模型(Domain Model) 4.3 Step 3:產出文件(AI 自動生成) 4.4 Step 4:建立新專案(Spring Boot) 4.5 Step 5:逐步重構 4.6 Step 6:驗證與測試 4.7 Agent Mode 加速逆向工程 第 5 章 Copilot Prompt Engineering 5.1 Prompt 設計原則 5.2 程式碼分析類 Prompt 5.3 語言轉換類 Prompt 5.4 文件產出類 Prompt 5.5 測試生成類 Prompt 5.6 Prompt 模板庫 5.7 Custom Instructions(專案級指令) 5.8 Agent Mode 專用 Prompt 設計 第 6 章 架構設計(企業級) 6.1 微服務 vs 單體架構決策 6.2 分層架構設計 6.3 資料庫遷移設計 6.4 中介軟體整合 第 7 章 風險與最佳實務 7.1 常見錯誤 7.2 逆向工程失敗案例分析 7.3 資料遺失風險與對策 7.4 安全性考量 7.5 AI 治理與企業合規 第 8 章 完整案例(實戰) 8.1 案例背景:VB6 客戶管理系統 8.2 Copilot 分析過程 8.3 新系統 Spring Boot 實作 8.4 案例二:舊 Java Servlet 轉 Spring Boot 第 9 章 工具整合 9.1 VS Code 配置 9.2 GitHub Copilot Chat 9.3 Copilot CLI 9.4 SonarQube 整合 9.5 Swagger / OpenAPI 9.6 Copilot Agent Mode 與 Cloud Agent 9.7 MCP Server 整合 9.8 Copilot Code Review 9.9 Copilot Spaces 與 Memory 第 10 章 結論 10.1 三種逆向策略比較表 10.2 推薦最佳實務 附錄 A:逆向工程檢查清單(Checklist) 附錄 B:Prompt 快速參考卡 附錄 C:常用工具版本對照 附錄 D:成本效益分析(ROI 評估) 第 1 章 概論 1.1 什麼是逆向工程(Reverse Engineering) 逆向工程是指從「已存在的系統產出物(程式碼、執行檔、資料庫)」出發,反向推導出系統的: ...

April 2, 2026 · 47 min · 9892 words · Eric Cheng