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

Copilot CLI教學手冊

GitHub Copilot CLI 教學手冊 版本:基於 GitHub Copilot CLI v1.0.39(2026-04-28 發佈) GA 日期:2026-02-25(v0.0.418 起正式 GA) 適用對象:資深工程師 / DevOps 工程師 / 架構師 技術環境:企業級 Web Application(Spring Boot 3.x / Vue 3 / 微服務架構) 適用方案:Copilot Free / Pro / Pro+ / Business / Enterprise 最後更新:2026-05-29 目錄 第 1 章:Copilot CLI 概述 1.1 什麼是 GitHub Copilot CLI 1.2 與其他 AI 工具的差異比較 1.3 適用場景 第 2 章:系統架構整合設計 2.1 Copilot CLI 在企業架構中的角色 2.2 與開發流程整合 2.3 Agentic Workflow 設計模式 第 3 章:安裝與環境設定 3.1 支援平台 3.2 前置需求 3.3 安裝步驟 3.4 身份驗證 3.5 初始化設定 3.6 常見錯誤與排除 第 4 章:核心功能教學 4.1 自然語言轉指令 4.2 Agentic Workflow 4.3 Codebase Context 分析 4.4 GitHub 整合 4.5 LSP 語言伺服器整合 4.6 Hooks 鉤子系統 4.7 Skills 技能系統 4.8 Plugin 插件生態系 4.9 Extensions 擴充機制 4.10 Copilot Memory 跨 Session 記憶 4.11 ACP(Agent Client Protocol) 4.12 OpenTelemetry 可觀測性 4.13 Critic Agent 自動審查 4.14 Remote Control 遠端控制 4.15 自訂模型供應商(Custom Model Provider) 4.16 圖片輸入支援 4.17 內建 Agent 系統 第 5 章:進階使用技巧(企業級) 5.1 Prompt Engineering(CLI 版本) 5.2 Context Engineering(讓 AI 更準) 5.3 多步驟任務拆解(Task Chaining) 5.4 與其他工具整合 5.5 Session 管理與對話引導 5.6 多儲存庫工作流程 5.7 圖片驅動開發 第 6 章:安全與治理 6.1 工具審批機制 6.2 YOLO Mode 說明與風險 6.3 企業治理策略 6.4 Hooks 安全防護 第 7 章:實戰案例 第 8 章:最佳實務(Best Practices) 8.1 如何寫好 Prompt(CLI 版本) 8.2 人機協作(Human-in-the-Loop) 8.3 適合與不適合使用的場景 8.4 官方推薦工作流程(Explore → Plan → Code → Commit) 8.5 Session 管理最佳實務 8.6 權限管理最佳實務 8.7 團隊協作與生產力量測 第 9 章:維運與升級 9.1 如何更新 Copilot CLI 9.2 版本管理策略 9.3 常見問題(FAQ) 9.4 效能與成本考量 9.5 自動更新與發佈頻道 第 10 章:附錄 10.1 常用指令速查表 10.2 Prompt 範本合集 10.3 工具權限速查表 10.4 環境變數 10.5 設定檔位置 10.6 版本演進里程碑 10.7 已移除與棄用項目 檢查清單(Checklist) 第 1 章:Copilot CLI 概述 1.1 什麼是 GitHub Copilot CLI GitHub Copilot CLI 是 GitHub 提供的命令列 AI 代理工具,讓開發者直接在終端機(Terminal)中使用 Copilot 的 AI 能力。它不僅是一個自然語言轉指令的工具,更是一個完整的 AI Agent,能夠: ...

May 29, 2026 · 42 min · 8811 words · Eric Cheng

Github Copilot Cli教學手冊

GitHub Copilot CLI 教學手冊 版本:v3.0(2026 年 2 月) 適用對象:資深工程師、DevOps 工程師、技術主管 適用平台:Windows / macOS / Linux 前置條件:具備 Git、Terminal 基礎操作能力;擁有 GitHub Copilot 授權 狀態:GitHub Copilot CLI 目前為 Public Preview(含資料保護),功能可能變更 目錄 1. GitHub Copilot CLI 架構說明 1.1 Copilot CLI 架構概念 1.2 與 GitHub Copilot IDE 版本的差異 1.3 三種使用模式 1.4 認證流程 1.5 CLI 與 GitHub 雲端服務關係 1.6 CLI 在企業環境中的位置 2. 安裝與環境建置 2.1 系統需求 2.2 Windows 安裝方式 2.3 macOS 安裝方式 2.4 Linux 安裝方式 2.5 使用 npm 安裝(跨平台) 2.6 驗證安裝成功 2.7 代理伺服器(Proxy)環境設定 2.8 防火牆與網路限制處理 3. 基本設定與認證 3.1 首次登入流程 3.2 使用 Personal Access Token 認證 3.3 企業 GitHub 組織授權 3.4 CLI 設定檔說明 3.5 信任目錄管理 3.6 安全設定建議 4. 開發應用方式 4.1 互動模式基本操作 4.2 計畫模式(Plan Mode) 4.3 程式化模式(Programmatic Mode) 4.4 檔案引用與上下文控制 4.5 程式碼產生與重構 4.6 測試程式產生 4.7 Dockerfile 與 CI/CD 產生 4.8 Git 操作與 PR 管理 4.9 工具權限管理 4.10 團隊開發最佳實踐 5. 自訂與擴充功能 5.1 自訂指令(Custom Instructions) 5.2 自訂代理(Custom Agents) 5.3 技能(Skills) 5.4 Hooks 5.5 AI 模型選擇 5.6 Copilot Memory 6. 與 MCP(Model Context Protocol)串接方式 6.1 MCP 架構概念 6.2 內建 GitHub MCP Server 6.3 新增 MCP Server 6.4 自訂 MCP Server 開發 6.5 與企業內部 API 整合 6.6 MCP 安全與權限控管 7. DevOps 整合模式 7.1 與 GitHub Actions 整合 7.2 與 CI/CD Pipeline 整合 7.3 容器化開發流程 7.4 AI 輔助 Code Review 7.5 委派工作至 Copilot Coding Agent 7.6 Commit Message 與 PR 最佳實務 8. 系統維護與治理 8.1 CLI 版本管理策略 8.2 企業升版流程 8.3 AI 使用紀錄稽核建議 8.4 使用權限控管 8.5 Session 管理 8.6 效能監控與成本控管 9. 企業導入最佳實踐 9.1 開發團隊使用規範 9.2 AI 輔助開發風險 9.3 原始碼洩漏風險管理 9.4 Prompt 設計標準化 9.5 AI 產出程式碼審核流程 9.6 內部教育訓練建議 10. 風險與限制說明 10.1 Copilot CLI 功能限制 10.2 Premium Request 配額 10.3 安全性考量 10.4 網路依賴風險 10.5 法規與合規性建議 附錄 A:新進成員檢查清單 附錄 B:常用指令速查表 附錄 C:故障排除指南 附錄 D:ACP(Agent Client Protocol) 附錄 E:參考資源 1. GitHub Copilot CLI 架構說明 1.1 Copilot CLI 架構概念 GitHub Copilot CLI 是一個獨立的命令列 AI 程式,讓開發者直接在終端機中與 Copilot 互動。它具備代理(Agent)能力,可以讀取、修改、執行檔案,並與 GitHub.com 互動。 ...

February 14, 2026 · 30 min · 6241 words · Eric Cheng