PostgreSQL 19.x 教學手冊

PostgreSQL 19.x 教學手冊 文件性質:企業內部教育訓練教材/團隊開發規範文件 適用對象:Junior/Backend/Frontend/Full Stack Developer、Database Developer、DBA、System Administrator、DevOps/DevSecOps Engineer、Software/Solution/Enterprise Architect、Data Engineer、AI Engineer、AI Agent Developer、PM、Technical Lead 內容取向:實戰與維運導向,可直接作為專案團隊內部規範採用 技術基準:PostgreSQL 18(現行正式支援版本)/PostgreSQL 19(Beta 3,尚未 GA) 查證基準日:2026-08-19(全書所有「截至目前」均指此日) 主要參考來源: PostgreSQL 官方網站:https://www.postgresql.org/ PostgreSQL 官方 Documentation:https://www.postgresql.org/docs/ PostgreSQL 19 Documentation:https://www.postgresql.org/docs/19/index.html PostgreSQL Release Notes:https://www.postgresql.org/docs/release/ PostgreSQL 19 Release Notes:https://www.postgresql.org/docs/19/release-19.html PostgreSQL Versioning Policy:https://www.postgresql.org/support/versioning/ PostgreSQL Development Roadmap:https://www.postgresql.org/developer/roadmap/ PostgreSQL Beta Testing 說明:https://www.postgresql.org/developer/beta/ ⚠️ 版本狀態重要聲明 請務必先讀完本節,再決定你的團隊要如何使用本手冊。 截至 2026-08-19,經查證 PostgreSQL 官方網站與官方公告,事實如下: 項目 現況 佐證來源 目前 Production 正式支援版本 PostgreSQL 18(2025 年 9 月 GA),官方支援至 2030-11-14 PostgreSQL Versioning Policy PostgreSQL 19 目前狀態 Beta 階段:Beta 1(2026-06-04)→ Beta 2(2026-07-16)→ Beta 3(2026-08-13,最新),尚未正式 GA postgresql.org 官方新聞稿 PostgreSQL 19 預計 GA 時間 官方 Roadmap 明確標示目標為 2026 年 9 月;查證當下尚未釋出 RC,精確 GA 日期仍待官方公告 PostgreSQL Development Roadmap 即將 EOL 的版本 PostgreSQL 14 將於 2026-11-12 EOL,屆時只剩最後一次修補版本 PostgreSQL Versioning Policy PostgreSQL 19 尚未正式 GA 時,不建議直接用於 Production;企業正式環境應依 PostgreSQL 官方支援版本與組織驗證政策決定。 本手冊中標示為「PostgreSQL 19(Beta)」的功能,其語法、參數名稱、預設值皆有可能在 RC/GA 階段調整。正式導入前,請務必重新比對當時的官方 Release Notes。 ...

August 19, 2026 · 65 min · 13796 words · Eric Cheng

OfficeCLI 教學手冊

OfficeCLI 教學手冊 OfficeCLI — 為 AI Agent 而生的 Office 自動化命令列工具:以確定性的路徑定址(path addressing)與固定 JSON schema,讓 LLM 直接讀寫 Word/Excel/PowerPoint,免安裝 Office、免自行解析 OOXML 適用對象:資深後端/全端工程師、AI Agent 架構師、MCP 整合工程師、Document Engineering/Reverse Engineering 團隊、企業 IT 治理與導入負責人 文件性質:企業內部「AI Office Automation Platform」建置與維運教材+開發規範參考+大型軟體開發流程應用指南 版本基準:OfficeCLI(iOfficeAI/OfficeCLI,2026-03-15 建立、Apache License 2.0、單一 .NET 執行檔/C# 撰寫;最新版本 v1.0.143,發布於 2026-07-28);本次撰寫查證時間點 2026-08-05 ⚠️ 重要聲明(請務必先讀) OfficeCLI 仍在高速迭代中。 專案於 2026-03-15 建立,不到五個月內成長迅速。截至本次撰寫(2026-08-05,直接呼叫 api.github.com/repos/iOfficeAI/OfficeCLI 查證,非憑記憶)已有 25,503 Stars、1,714 Forks、73 Subscribers、44 個開放 Issue,自 2026-06-21 起多次登上 GitHub Trending 第一名。其 CLI 參數、JSON schema、Wiki 頁面結構在版本之間可能持續變動,任何指令與旗標在正式導入前,務必以最新官方 Repository/內建 officecli help 為準;本手冊所列數字與行為僅為查證當下快照。 本手冊的定位是「理解、彙整、分析、重組、補充最佳實務」,而非官方文件翻譯。 不直接翻譯 README、不大量抄錄原文,而是以企業教育訓練教材角度重新組織、加入架構圖、比較表、最佳實務與導入建議。 內容分兩類: 官方已確認事實:內文一律使用 repo 內實際指令/路徑/旗標名稱,不使用意譯替代。本次核校已透過 GitHub API 直接讀取 repo metadata、README.md/README_zh.md、SKILL.md、GitHub Wiki(Home/command-reference/command-view 等頁面)逐一比對,非僅憑記憶或二手轉述。 作者補充:凡屬作者依企業(含金融業、保險業、政府機關)導入 AI Agent Office Automation 之實務經驗所補充或推論之處,會標註 (作者建議) 或 (作者推論)。這些是最佳實務參考,非官方保證。 特別澄清(避免讀者對專案與架構產生誤解): 命名衝突警告:GitHub 上另有一個完全不同、不相關的專案同樣以「OfficeCLI」自稱(officecli/officecli,主打「AI document generation CLI」、npm 安裝+託管試用),與本手冊主題 iOfficeAI/OfficeCLI(25k+ Stars、Apache 2.0、單一二進位執行檔)並非同一專案。自行搜尋資料時請務必核對組織帳號 iOfficeAI,避免誤植指令或誤信功能。 OfficeCLI 本質上是一支 CLI/DOM 編輯器,MCP 只是它眾多整合介面之一(另有 Python SDK officecli-sdk、Node.js SDK @officecli/sdk、SKILL.md/load_skill 技能系統)。執行 officecli mcp <host> 才會啟動/設定 MCP Server,並非常駐預設行為。 PNG 輸出不是獨立的「渲染層」,而是 view screenshot 這個輸出模式,底層與 view html(HTML 預覽)共用同一套渲染引擎;且 view html 與 view svg 目前僅支援 PowerPoint(.pptx),並非任意格式皆可轉 HTML/SVG(查證自 Wiki command-view 頁面)。 PDF 匯出與 forms(互動表單欄位列舉)屬於「外掛相依」(plugin-dependent)功能,非核心二進位內建;官方文件明確寫著「Export the document to PDF via an installed exporter plugin」。 未見官方對舊版二進位格式(.doc/.xls/.ppt)或 CSV 作為第一類讀寫格式的原生支援證據;CSV 目前僅以 add --type csv 形式匯入 Excel,並非通用匯出格式。原始需求若涉及這些項目,本手冊會在對應章節明確標註「⚠️ 目前版本不支援,可透過 YYY 替代」,不會虛構不存在的指令。 未見官方 Docker Hub / GHCR 上架的正式容器映像;iOfficeAI 組織下的姊妹專案(AionUi)雖有內含 OfficeCLI 呼叫的 Dockerfile 範例,但那是應用層 Dockerfile,不等於 OfficeCLI 官方提供的映像。第三章的容器化安裝內容標註為**(作者建議)**的自建 Dockerfile 作法。 授權條款請留意「範圍界線」:OfficeCLI 本身(程式碼)採 Apache License 2.0,可自由商用、修改、內部散布。但這不代表經過 OfficeCLI 處理的文件內容本身著作權隨之開放——那是你自己或客戶的文件。金融業、保險業、政府機關導入前,仍應將「OfficeCLI 本機執行 vs. 透過 MCP 交給雲端 LLM 讀取內容」兩種情境的資料外洩風險分開評估(作者建議,詳見第十八章)。 官方權威來源與本次查證所用 URL/時間戳,請見〈附錄 A・參考資料〉。 目錄(Table of Contents) 符號約定 版本與相容性速查表 第一章 OfficeCLI 介紹 1.1 一句話定義 1.2 誕生背景與發展脈絡 1.3 解決哪些 AI Agent 痛點 1.4 設計理念與設計哲學 1.5 適用情境 1.6 不適用情境/限制 1.7 與傳統 Office Automation 的差異 1.8 核心特色 1.9 優勢 1.10 限制 1.11 未來發展方向與 Roadmap 1.12 AI Prompt 範例 1.13 本章 Checklist 與小結 第二章 OfficeCLI 系統架構 2.1 架構總覽 2.2 三層架構詳解(L1 → L2 → L3) 2.3 Resident Mode 常駐架構 2.4 CLI Layer 與指令分派 2.5 JSON Extractor/DOM 抽象層 2.6 與 OpenXML 的關係 2.7 Rendering Engine 概覽 2.8 MCP Server 架構 2.9 Watch Mode/Preview Server 架構 2.10 端到端資料流 2.11 AI Agent/LLM 整合點總覽 2.12 AI Prompt 範例 2.13 本章 Checklist 與小結 第三章 安裝 3.1 安裝路徑總覽 3.2 Windows 安裝 3.3 Linux 安裝 3.4 macOS 安裝 3.5 WSL 安裝 3.6 npm 安裝(跨平台) 3.7 Docker/Container 安裝 🧩(作者建議) 3.8 企業環境安裝:Air-gap/Offline Installation(作者建議) 3.9 企業代理(Proxy)設定(作者建議) 3.10 版本管理與更新 3.11 PATH 與環境變數 3.12 安裝驗證 Checklist 3.13 常見安裝錯誤 3.14 AI Prompt 範例 3.15 本章 Checklist 與小結 第四章 CLI 使用教學 4.1 指令總覽表 4.2 全域旗標與慣例 4.3 路徑定址語法 4.4 單位與數值慣例 4.5 create:建立空白文件 4.6 view:語意化讀取 4.7 get / query:查詢元素 4.8 set / add / remove / move / swap 4.9 raw / raw-set:L3 保底手段 4.10 validate 4.11 batch:原子化多指令執行 4.12 dump / merge 4.13 open / close:常駐模式操作 4.14 mcp:MCP Server 設定 4.15 install / plugins / skills / load_skill 4.16 help:內建三層說明系統 4.17 JSON 輸出格式與錯誤處理 4.18 錯誤案例與除錯 4.19 最佳實務 4.20 常見錯誤與 Anti-Pattern 4.21 AI Prompt 範例 4.22 本章 Checklist 與小結 第五章 支援格式 5.1 格式總覽表 5.2 DOCX(Word) 5.3 XLSX(Excel) 5.4 PPTX(PowerPoint) 5.5 Legacy 二進位格式(.doc/.xls/.ppt) 5.6 PDF 🧩 5.7 HTML/SVG(⚠️ 僅 PowerPoint) 5.8 JSON 5.9 PNG 5.10 Markdown(⚠️ 不支援原生輸出) 5.11 CSV(僅匯入 Excel) 5.12 格式選擇決策樹 5.13 最佳實務 5.14 常見錯誤 5.15 AI Prompt 範例 5.16 本章 Checklist 與小結 第六章 Rendering Engine 6.1 渲染引擎總覽 6.2 HTML Render 6.3 Image Render/PNG 6.4 Preview(watch 即時預覽) 6.5 Diff/增量更新機制 6.6 Page Layout 6.7 字型 6.8 圖片渲染 6.9 Table 渲染 6.10 Chart 渲染 6.11 SmartArt 渲染 6.12 最佳實務 6.13 常見錯誤與 Anti-Pattern 6.14 AI Prompt 範例 6.15 本章 Checklist 與小結 第七章 JSON Extraction 7.1 為什麼 JSON 是 OfficeCLI 與 LLM 之間的共同語言 7.2 JSON Envelope Schema 總覽(複習+深化) 7.3 Document Structure(outline) 7.4 Table/Cell 7.5 Paragraph/Run 7.6 Image 7.7 Header/Footer 7.8 Style 7.9 Metadata(stats/issues) 7.10 dump:完整可重播 JSON 7.11 --output-schema-crc:Schema 版本指紋 7.12 JSON 在 AI Workflow 中的角色 7.13 最佳實務 7.14 常見錯誤 7.15 AI Prompt 範例 7.16 本章 Checklist 與小結 第八章 Office Editing 8.1 建立文件 8.2 Word 編輯 8.3 Excel 編輯 8.4 PowerPoint 編輯 8.5 圖片插入與格式設定(跨格式共通模式) 8.6 圖表建立速查表 8.7 樣式與格式化最佳實務 8.8 批次編輯 Workflow 8.9 最佳實務 8.10 常見錯誤與 Anti-Pattern 8.11 AI Prompt 範例 8.12 本章 Checklist 與小結 第九章 MCP Server 9.1 MCP 協定簡介 9.2 OfficeCLI 的 MCP 實作架構 9.3 officecli mcp 指令完整參考 9.4 Claude Code 設定 9.5 Claude Desktop 設定(⚠️ 作者補充,非官方一鍵指令) 9.6 Cursor 設定 9.7 VS Code/GitHub Copilot 設定 9.8 LM Studio 設定 9.9 Gemini CLI 設定(⚠️ 作者補充,非官方一鍵指令) 9.10 OpenAI Codex CLI 設定(⚠️ 作者補充,非官方一鍵指令) 9.11 MCP Tool 呼叫範例集 9.12 load_skill:動態技能載入 9.13 MCP Security 概覽 9.14 最佳實務 9.15 常見錯誤 9.16 AI Prompt 範例 9.17 本章 Checklist 與小結 第十章 Watch Mode 10.1 定位:watch 與其他預覽方式的差異 10.2 啟動與基本用法 10.3 HTTP Server 細節 10.4 Live Reload/Auto Reload 機制 10.5 API 端點 10.6 互動選取與 Marks 審閱工作流程 10.7 Browser 自動開啟與 Auto-Scroll 10.8 Hot Reload 情境示範 10.9 Debug 除錯技巧 10.10 最佳實務 10.11 常見錯誤與 Anti-Pattern 10.12 AI Prompt 範例 10.13 本章 Checklist 與小結 第十一章 AI Agent 整合 11.1 整合模式分類 11.2 Claude Code(官方支援) 11.3 Cursor(官方支援) 11.4 GitHub Copilot/VS Code(官方支援) 11.5 OpenAI Codex CLI(MCP 標準,需手動設定) 11.6 Gemini CLI(MCP 標準,需手動設定) 11.7 Windsurf(官方支援・Skill 檔自動偵測) 11.8 Shell-Exec 類 Agent 整合總表 11.9 選型建議 11.10 最佳實務 11.11 常見錯誤 11.12 AI Prompt 範例 11.13 本章 Checklist 與小結 第十二章 AI Workflow 12.1 端到端流程總覽 12.2 各階段詳解 12.3 範例 Walkthrough:月報自動化 12.4 範例 Walkthrough:合約套版審閱 12.5 人工確認關卡設計 12.6 失敗重試與回滾策略 12.7 最佳實務 12.8 常見錯誤 12.9 AI Prompt 範例 12.10 本章 Checklist 與小結 第十三章 Reverse Engineering 13.1 為什麼 Office 文件是 Legacy System 的隱藏規格書 13.2 Word 規格書 → 功能分析 13.3 Excel 試算表 → Database Schema 推導 13.4 PowerPoint 簡報 → 需求分析 13.5 從文件擷取 API/介面定義 13.6 產出正式規格書 13.7 與 Migration/Framework Upgrade 的銜接 13.8 案例 Walkthrough:舊保單管理系統文件化 13.9 最佳實務 13.10 常見錯誤 13.11 AI Prompt 範例 13.12 本章 Checklist 與小結 第十四章 Web Application 開發 14.1 OfficeCLI 在企業級 Web Application 開發流程中的定位 14.2 需求分析 14.3 Use Case 文件自動產出 14.4 ERD:從 Excel 欄位表到關聯圖 14.5 API/Swagger/OpenAPI 14.6 SDD/Spec 文件 14.7 Architecture/Sequence/Class/Component/Deployment Diagram 14.8 與 Spec Repository 的銜接 14.9 完整 Walkthrough:從 PRD 到 API 規格書 14.10 最佳實務 14.11 常見錯誤 14.12 AI Prompt 範例 14.13 本章 Checklist 與小結 第十五章 Framework Upgrade 15.1 為什麼升版評估需要文件工程 15.2 Spring Boot/Spring Framework 15.3 Jakarta EE/Java 15.4 Vue/Angular/React 15.5 .NET/Node.js 15.6 Maven/Gradle 15.7 通用 Upgrade Checklist 產生流程 15.8 Migration Plan 文件產出 15.9 案例 Walkthrough 15.10 最佳實務 15.11 常見錯誤 15.12 AI Prompt 範例 15.13 本章 Checklist 與小結 第十六章 AI 文件工程 16.1 從「AI 輔助」到「AI 原生」的典範轉移 16.2 Document Engineering(文件工程) 16.3 Prompt Engineering(文件情境) 16.4 Context Engineering(上下文工程) 16.5 Knowledge Engineering(知識工程):RAG 與知識圖譜 16.6 Spec Engineering(規格工程) 16.7 五大工程領域的協作關係 16.8 最佳實務 16.9 常見錯誤 16.10 AI Prompt 範例 16.11 本章 Checklist 與小結 第十七章 系統維運 17.1 維運總覽 17.2 Monitoring 17.3 Logging 17.4 Troubleshooting 17.5 Performance ⚡ 17.6 Memory 17.7 Rendering 效能 17.8 Cache 17.9 CI/CD 整合範例 17.10 Kubernetes 部署範例(作者建議,批次渲染 Job) 17.11 最佳實務 17.12 常見錯誤 17.13 AI Prompt 範例 17.14 本章 Checklist 與小結 第十八章 安全性 18.1 威脅模型總覽 18.2 Office Macro/惡意文件 18.3 權限 18.4 Sandbox 18.5 MCP Security 18.6 JSON/指令注入 18.7 Prompt Injection(文件內藏惡意指令) 18.8 Secrets 18.9 最佳實務 18.10 常見錯誤 18.11 AI Prompt 範例 18.12 本章 Checklist 與小結 第十九章 最佳實務 19.1 大型企業導入原則總覽 19.2 銀行最佳架構 19.3 政府機關最佳架構 19.4 最佳流程 19.5 最佳 Prompt 原則 19.6 最佳資料夾結構(作者建議) 19.7 最佳 Git 規範 19.8 最佳 CI/CD 19.9 綜合案例 19.10 常見錯誤與 Anti-Pattern 19.11 AI Prompt 範例 19.12 本章 Checklist 與小結 第二十章 常見問題 FAQ 20.1 基礎與定位(Q1–Q10) 20.2 安裝與環境(Q11–Q20) 20.3 CLI 與路徑定址(Q21–Q32) 20.4 格式支援(Q33–Q42) 20.5 JSON 與資料擷取(Q43–Q50) 20.6 Rendering/Watch(Q51–Q60) 20.7 MCP 與 AI Agent 整合(Q61–Q70) 20.8 效能與維運(Q71–Q80) 20.9 安全性(Q81–Q92) 20.10 企業導入與治理(Q93–Q108) 20.11 本章 Checklist 與小結 第二十一章 Case Study 21.1 銀行|放款契約自動套版審閱 21.2 銀行|舊核心系統規格書逆向工程 21.3 保險|理賠報告自動產出 21.4 保險|舊保單管理系統文件化 21.5 政府機關|Air-gap 環境公文範本自動化 21.6 政府機關|招標規格書比對稽核 21.7 製造業|品保報告自動彙整 21.8 製造業|舊 ERP 欄位對照表現代化 21.9 AI 文件分析|大量合約條款風險掃描 21.10 AI 文件分析|財報簡報自動生成 21.11 Framework Upgrade|Spring Boot 3 → 4 升版盤點 21.12 Framework Upgrade|前端 Vue 2 → Vue 3 遷移文件化 21.13 跨國企業|多語系月報自動化 21.14 新創 SaaS|MCP 驅動的客製化提案簡報產生器 21.15 教育機構|學習歷程報告批次產出 21.16 集團內部|企業知識庫 RAG 建置 21.17 最佳實務(跨案例共通觀察) 21.18 常見錯誤 21.19 AI Prompt 範例 21.20 本章 Checklist 與小結 第二十二章 與其它工具比較 22.1 第一個關鍵區分:讀取/解析 vs. 讀寫/編輯 22.2 讀寫/編輯類比較 22.3 唯讀解析/擷取類比較(RAG/LLM 前處理導向) 22.4 綜合評分表(依五個面向,5 分制,作者依本章比較資料之主觀評分) 22.5 定位象限圖 22.6 選型決策樹 22.7 最佳實務 22.8 常見錯誤 22.9 AI Prompt 範例 22.10 本章 Checklist 與小結 第二十三章 OfficeCLI + AI Agent 最佳架構 23.1 完整企業架構圖 23.2 各層職責說明 23.3 GitHub/GitLab 雙軌並存的實務考量 23.4 RAG/向量資料庫/知識圖譜的資料流 23.5 Reverse Engineering/Framework Upgrade 在架構中的位置 23.6 分階段導入建議 23.7 最佳實務 23.8 常見錯誤 23.9 AI Prompt 範例 23.10 本章 Checklist 與小結 第二十四章 Prompt Library 24.1 文件分析類(General Document Analysis) 24.2 Excel 分析類 24.3 PPT 分析類 24.4 Word 修改類 24.5 Migration 類 24.6 Architecture 類 24.7 Requirement 類 24.8 Spec 類 24.9 Testing 類 24.10 Review 類 24.11 十大類別總覽 24.12 最佳實務 24.13 常見錯誤 24.14 AI Prompt 範例(如何擴充本 Library) 24.15 本章 Checklist 與小結 第二十五章 完整企業導入指南 25.1 導入流程總覽 25.2 教育訓練 25.3 治理框架 25.4 版本管理 25.5 AI Agent 治理 25.6 MCP 治理 25.7 文件治理 25.8 ROI 衡量 25.9 成熟度模型 25.10 KPI 範例 25.11 最佳實務 25.12 常見錯誤 25.13 AI Prompt 範例 25.14 本章 Checklist 與小結 附錄 附錄 A・參考資料 附錄 B・全書 Checklist 總表 附錄 B.1・情境式 Checklist(跨章節整合) 附錄 C・FAQ 索引 附錄 D・版本歷程(本手冊) 結語 目錄將於全書完稿後以 python tools/markdown/generate_toc.py 重新產生並校正,撰寫期間之標題編號以此為準。 ...

August 5, 2026 · 78 min · 16505 words · Eric Cheng

Maven 4.x 教學手冊

Maven 4.x 教學手冊 文件性質:企業內部教育訓練教材/團隊開發規範文件 適用對象:資深 Java 工程師、軟體架構師、DevOps/SRE、平台工程團隊、Tech Lead、建置與發布負責人 內容取向:實戰與維運導向,可直接作為專案團隊內部規範採用 技術基準:Apache Maven 4.0.0-rc-5(2025-11-13)/Apache Maven 3.9.16(2026-05-13) 查證基準日:2026-07-28(全書所有「截至目前」均指此日) 主要參考來源: Apache Maven 官方網站:https://maven.apache.org/ What’s new in Maven 4:https://maven.apache.org/whatsnewinmaven4.html Maven 3 至 Maven 4 遷移指南:https://maven.apache.org/guides/mini/guide-migration-to-mvn4.html Maven 版本歷史:https://maven.apache.org/docs/history.html Maven 4.0.0-rc-5 Release Notes:https://maven.apache.org/docs/4.0.0-rc-5/release-notes.html ⚠️ 版本狀態重要聲明 請務必先讀完本節,再決定你的團隊要如何使用本手冊。 截至 2026-07-28,經查證 Apache Maven 官方網站,事實如下: 項目 現況 佐證來源 Maven 4 最新版本 4.0.0-rc-5,發布於 2025-11-13 Maven Releases History Maven 4 是否已 GA 尚未正式發布(Not GA) Maven Releases History 官方對生產環境的立場 原文:“Maven 4.x is currently under development, so while we are encouraging users to try it and report any issues, it is NOT safe for production use.” Maven Download 頁面 Maven 3 現行穩定版 3.9.16,發布於 2026-05-13 Maven Releases History Maven 3 新分支 3.10.0-rc-1,發布於 2026-07-09 Maven Releases History 執行 Maven 4 的最低需求 Java 17(僅「執行 Maven 本身」需要,專案仍可編譯至 Java 8) What’s new in Maven 4 此外,官方的 What’s new in Maven 4 頁面(最後發布日 2026-07-27)內文仍寫著 “This article will continuously be updated at least until Maven 4.0.0 is released.",是 Maven 4.0.0 尚未 GA 的第二個獨立佐證。 ...

July 28, 2026 · 163 min · 34568 words · Eric Cheng

SonarQube教學手冊

SonarQube 教學手冊 企業級 AI Coding Quality / Reverse Engineering / Framework Upgrade Validation / Secure SDLC / DevSecOps / Code Governance / AI Native Governance 全方位實戰教學 📋 目錄 (Table of Contents) 第一部分:基礎概念與架構 SonarQube 概論 SonarQube 版本比較 SonarQube 系統架構 第二部分:安裝部署與設定 安裝與部署 SonarQube 設定 SonarScanner Quality Gate 第三部分:AI Coding 整合實戰 AI Coding 與 SonarQube Claude Code 整合實戰 GitHub Copilot 整合實戰 第四部分:SonarQube 原生 AI 治理與進階安全 SonarQube 原生 AI 治理 SonarQube Advanced Security 第五部分:Legacy 與升級治理 Legacy System 逆向工程 Framework Upgrade 第六部分:安全治理框架 SSDLC DevSecOps 第七部分:CI/CD 實戰整合 GitHub Actions 整合 GitLab CI/CD 整合 Jenkins 整合 第八部分:API 與維運 SonarQube API 維運管理 升級策略 第九部分:企業導入與案例 企業導入最佳實務 銀行級實戰案例 第十部分:FAQ、Prompt Library 與附錄 常見問題 FAQ Prompt Library 附錄 📖 文件說明 🎯 文件目標 本手冊將 SonarQube 定位為企業七大平台: ...

June 25, 2026 · 54 min · 11409 words · Eric Cheng

Codebase Memory Mcp 教學手冊

codebase-memory-mcp 教學手冊 AI Coding Agent 知識圖譜引擎與超大型專案程式碼理解平台 文件版本控制表 項目 內容 文件版本 v1.1 撰寫/修訂日期 2026-06-25 依據官方專案版本 DeusData/codebase-memory-mcp v0.8.1(官方發布日 2026-06-12) 主要參考來源 官方 README/Releases/SECURITY.md、GitHub Pages 文件、論文 Codebase-Memory: Tree-Sitter-Based Knowledge Graphs for LLM Code Exploration via MCP(arXiv:2603.27277) 授權 codebase-memory-mcp 本體為 MIT License 開源專案 適用對象 系統分析師、系統架構師、軟體架構師、後端工程師、前端工程師、DevOps / DevSecOps 工程師、AI Engineer、Claude Code 使用者、GitHub Copilot 使用者、MCP 開發者 閱讀建議 本手冊偏向「實戰與維運」,建議依角色挑選章節 —— 架構師優先看第 2、3、20 章;導入負責人優先看第 19、22 章;第一線工程師優先看第 4~10 章;維運人員優先看第 16、17、18 章 v1.1 修訂摘要 對照官方 v0.8.1 補充環境變數、安裝參數、壓縮格式、安全機制(SLSA/cosign/CodeQL)細節;新增 Tree-sitter 語言分級、Leiden 社群偵測說明;對 ingest_traces 全文加註實驗性(Stub)警語;新增第 18 章已知限制小節;補充專案活躍度數據;目錄擴充為章/節兩層並修正簡體字與誤字 ⚠️ 時效性聲明:codebase-memory-mcp 為快速迭代的開源專案,本手冊內容以撰寫當下查證到的 v0.8.1 為準,使用前請以官方最新 Releases 與文件為最終依據,特別留意標註「實驗性/Stub」的功能是否已在更新版本中完整實作。 ...

June 25, 2026 · 37 min · 7736 words · Eric Cheng

Gitlab and Gitlab Cli 教學手冊

GitLab 與 GitLab CLI(glab)完整企業級教學手冊 本手冊以 2026 年最新版 GitLab(GitLab.com SaaS / GitLab Self-Managed / GitLab Dedicated)、GitLab CLI(glab)、GitLab Duo、GitLab CI/CD、GitLab Runner、GitLab Kubernetes Agent、GitLab Security、GitLab API、GitLab MCP Server 等官方文件與最佳實務為基礎撰寫,目標是讓初學者到資深架構師、DevOps / Platform / SRE 團隊都能在同一份文件中找到所需的知識與可直接複製貼上的操作指令。 📌 使用建議: 第一次接觸 GitLab 的同仁,建議依序閱讀第一章~第七章。 已熟悉 Git 的開發者,可直接從第四章(glab CLI)開始。 DevOps / Platform / SRE 團隊,請聚焦第八、十一、十九、二十章。 想了解 AI 協作開發(Claude Code、GitHub Copilot、MCP)的同仁,請見第十三~十八章。 本文件與既有的《GitLab使用教學.md》為獨立文件,內容不互相依賴,可單獨閱讀。 📖 目錄 💡 點擊章節可跳至本文對應位置;每個章節下方的子項為該章節的小節(##)連結。 第一章 GitLab 介紹 1.1 GitLab 發展歷史 1.2 GitLab 核心理念 1.3 GitLab 與 GitHub 比較 1.4 GitLab 與 Azure DevOps 比較 1.5 GitLab 與 Bitbucket 比較 1.6 GitLab SaaS / Self-Managed / Dedicated 差異比較 第二章 GitLab 整體架構 2.1 端到端架構總覽 2.2 核心元件運作方式 2.3 GitLab Architecture Tiers(部署規模分級) 第三章 GitLab 安裝與部署 3.1 GitLab CE 與 EE 差異 3.2 Linux Package(Omnibus)安裝 — Ubuntu 3.3 Linux Package 安裝 — RHEL / Rocky Linux 3.4 Docker 安裝 3.5 Podman 安裝(Rootless) 3.6 Helm Chart(Kubernetes)安裝概覽 第四章 GitLab CLI(glab) 4.1 glab 是什麼 4.2 glab 架構 4.3 glab 主要功能分類 4.3.1 glab 指令穩定度分級(Stable / Beta / Experimental) 4.4 安裝 glab 4.5 登入與認證 第五章 GitLab CLI 指令大全 5.1 glab auth — 認證管理 5.2 glab repo — 專案管理 5.3 glab mr — Merge Request 5.4 glab issue — Issue 管理 5.5 glab pipeline 與 glab ci — CI/CD 操作 5.6 glab release — 版本發布 5.7 glab variable — CI/CD 變數管理 5.8 glab project — 專案層級設定 5.9 glab api — 通用 API 呼叫 5.10 glab duo — GitLab Duo AI 功能 5.11 glab mcp — 啟動 MCP Server 5.12 glab stack — Stacked Diff 管理 5.13 glab search — 跨專案搜尋 5.14 glab schedule — Pipeline 排程管理 5.15 glab runner — Runner 管理 5.16 glab orbit — Knowledge Graph 查詢 5.17 glab skills — Agent 技能管理 5.18 glab attestation — 軟體供應鏈驗證 5.19 glab cluster — Kubernetes Agent 管理 5.20 glab container-registry — 容器倉庫管理 5.21 glab incident — 事件管理 5.22 glab work-items — 統一規劃項目 5.23 其他工具型指令速查 第六章 GitLab Flow 6.1 三種主流分支策略比較 6.2 GitLab Flow 的兩種變體 6.3 企業建議 第七章 CI/CD 7.1 .gitlab-ci.yml 核心概念 7.2 Java / Spring Boot 完整 CI/CD 範例 7.3 Node.js / Vue 完整 CI/CD 範例 7.4 React 完整 CI/CD 範例 7.5 Python 完整 CI/CD 範例 7.6 include 拆分與共用範本 第八章 GitLab Runner 8.1 Runner 類型總覽 8.2 安裝 GitLab Runner 8.3 設定要點 8.4 維護、升級、故障排除 第九章 Container Registry 9.1 GitLab Container Registry 概念 9.2 基本操作 9.3 Image 掃描(Container Scanning) 9.4 Image Promotion(多環境晉升流程) 9.5 最佳實務 9.6 Container Virtual Registry(聚合上游倉庫) 9.7 多架構 Image 支援(Multi-Architecture) 第十章 Package Registry 10.1 支援的套件格式總覽 10.2 Maven 設定與發布 10.3 npm / pnpm 設定與發布 10.4 NuGet 發布 10.5 PyPI 發布 10.6 Generic Package(任意檔案) 第十一章 GitLab Security 11.1 GitLab 安全掃描總覽 11.2 SAST(靜態應用程式安全測試) 11.3 DAST(動態應用程式安全測試) 11.4 Dependency Scanning 11.4.1 AI 輔助安全:Agentic SAST 與 Duo 誤報偵測 11.5 Container Scanning 11.6 Secret Detection 11.7 License Compliance 11.8 Security Dashboard 與 Vulnerability Management 11.9 企業導入策略 第十二章 GitLab API 12.1 REST API 與 GraphQL API 選用建議 12.2 Access Token 種類 12.3 curl 範例 12.4 Java / Spring Boot 範例 12.5 Python 範例 12.6 TypeScript 範例 第十三章 GitLab Duo 13.1 GitLab Duo 功能總覽 13.2 GitLab Duo Chat 13.3 Code Suggestions(程式碼建議) 13.4 Code Review(MR 自動審查) 13.5 Vulnerability Explanation 13.6 Test Generation 與 Refactoring 13.7 Prompt Engineering 最佳實務 第十四章 GitLab + Claude Code 14.1 整合架構總覽 14.2 實戰案例:Claude Code 自動建立並提交 Merge Request 14.3 實戰案例:Claude Code 自動 Review 程式碼 14.4 實戰案例:Pipeline 失敗時自動診斷 14.5 CLAUDE.md 專案規範整合建議 第十五章 GitLab + GitHub Copilot 15.1 為什麼會在 GitLab 上使用 GitHub Copilot 15.2 Agent Mode 與 Coding Agent 操作模式 15.3 如何與 GitLab 協作(實務整合建議) 第十六章 GitLab + MCP 16.1 Model Context Protocol 簡介 16.2 GitLab MCP Server 現況與安裝 16.3 設定 Claude Code 連接 GitLab MCP Server 16.4 權限管理 16.5 實際案例:多步驟 Agent 工作流程 16.6 GitLab Orbit(Knowledge Graph)與 AI Agent 第十七章 AI 協助 Legacy System 逆向工程 17.1 為什麼 Legacy System 逆向工程適合導入 AI 17.2 實戰步驟:將 Legacy 程式碼匯入 GitLab 並建立分析基線 17.3 實戰案例:AI Agent 自動分析 Legacy System 17.4 各 Legacy 技術的 AI 逆向工程要點 17.5 文件生成與架構分析範本 17.6 逆向工程後的重構規劃 第十八章 Framework 升級專案 18.1 升級專案的 GitLab 治理框架 18.2 Spring Boot 2 → 3 / Java 8 → 21 實戰流程 18.3 Vue2 → Vue3 升級實戰流程 18.4 Angular 升級實戰流程 18.5 升級專案的企業治理建議 第十九章 大型企業 DevSecOps 平台設計 19.1 依規模分級的架構設計原則 19.2 大型企業架構圖 19.3 權限模型設計 19.4 Group 策略與 Project 策略 19.5 Branch 策略 第二十章 GitLab 維運手冊 20.1 備份與還原 20.2 監控(Prometheus + Grafana) 20.3 Logging 20.4 升級 20.5 高可用性(HA)與災難復原(DR) 第二十一章 GitLab 最佳實務 21.1 命名規範 21.2 Branch Strategy 21.3 MR Strategy 21.4 Pipeline Strategy 21.5 Release Strategy 21.6 Security Strategy 第二十二章 常見問題 FAQ 22.1 開發類 22.2 CI/CD 類 22.3 Security 類 22.4 Runner 類 22.5 Kubernetes 類 22.6 AI 類 22.7 GitLab Duo 類 22.8 glab 類 第二十三章 附錄 23.1 常用 glab 指令速查表 23.2 CI/CD 通用範本 23.3 Spring Boot 範本 23.4 Vue3 範本 23.5 Kubernetes 範本 23.6 Docker 範本(多階段建置) 23.7 Helm 範本 23.8 十大 AI Agent 實戰情境總覽 23.9 企業導入檢查清單 第一章 GitLab 介紹 1.1 GitLab 發展歷史 GitLab 最初由 Dmitriy Zaporozhets 與 Valery Sizov 於 2011 年以 Ruby on Rails 開發,作為一套開源的 Git 版本控制管理工具。早期僅是「GitHub 的開源替代品」,但 GitLab 團隊很快意識到軟體交付不只是「管程式碼」,而是一個從規劃、開發、測試、安全掃描、部署到監控的完整生命週期。 ...

June 24, 2026 · 62 min · 13121 words · Eric Cheng

Postman 教學手冊

版本:2.0 最後更新:2026 年 5 月 19 日 適用對象:後端工程師、前端工程師、QA 工程師、系統架構師、DevOps 工程師 定位:企業內部標準教材 文件維護:內部技術團隊 適用於:Postman v12.x(2026 年最新穩定版,向下相容 v11.x) Created by:Eric Cheng Postman 教學手冊 📋 教學大綱 Postman 簡介與概觀 1.1 Postman 是什麼? 1.2 核心功能總覽 1.3 Postman 平台架構 1.4 版本與授權方案 1.5 與同類工具比較 1.6 適用場景與不適用場景 安裝與環境設定 2.1 桌面應用程式安裝 2.2 網頁版與 VS Code Extension 2.3 帳號註冊與登入 2.4 介面導覽 2.5 企業網路設定(Proxy / SSL) 2.6 團隊初始化設定 核心概念 3.1 Workspaces(工作區) 3.2 Collections(集合) 3.3 Environments 與 Variables 3.4 Authorization(認證與授權) 3.5 Postman Console 發送 API 請求 4.1 建立與發送 HTTP 請求 4.2 Request Body 格式 4.3 Response 檢視與分析 4.4 GraphQL 請求 4.5 gRPC 與 WebSocket 4.6 Cookie 與 Certificate 管理 變數與環境管理 5.1 變數作用域與優先順序 5.2 動態變數 5.3 環境切換策略 5.4 Postman Vault(敏感資料管理) 5.5 資料檔案驅動(CSV / JSON) 腳本開發(Tests & Scripts) 6.1 Pre-request Script 6.2 Post-response Script(測試斷言) 6.3 pm API 完整參考 6.4 Chai Assertion Library 6.5 請求鏈結(Chaining Requests) 6.6 常見測試範例 6.7 可重用腳本(Package Library) Collection Runner 與自動化測試 7.1 Collection Runner 使用 7.2 執行順序控制 7.3 Data-Driven Testing 7.4 效能測試 7.5 整合測試與回歸測試 Postman CLI 與 CI/CD 整合 8.1 Postman CLI 安裝與設定 8.2 命令列執行 Collection 8.3 Newman(傳統 CLI) 8.4 GitHub Actions 整合 8.5 Jenkins / Azure DevOps 整合 API 設計與文件 9.1 Spec Hub(OpenAPI / AsyncAPI) 9.2 Mock Server 設定 9.3 API 文件產生與發布 9.4 版本管理與 Native Git 9.5 SDK Generation(SDK 產生) 9.6 API Catalog(Enterprise) Postman Flows 10.1 Flows 概念與用途 10.2 建立視覺化工作流 10.3 實務案例 AI 功能(Agent Mode) 11.1 Postman AI 功能總覽 11.2 Agent Mode 深度指南 11.3 MCP Server 與 MCP Client 整合 11.4 AI Credits 管理與最佳化 團隊協作 12.1 團隊建立與管理 12.2 角色與權限 12.3 Version Control(Fork / Pull Request / Merge) 12.4 團隊工作區最佳實務 安全治理與 API Governance 13.1 Postman Secret Scanner 13.2 Postman Vault 與第三方整合 13.3 API Governance Rules 13.4 SSO / SCIM / Audit Log 13.5 BYOK 與 Data Residency 監控與效能 14.1 Monitor 設定與排程 14.2 效能指標與告警 14.3 Insights(Enterprise) 整合與擴充 15.1 第三方工具整合 15.2 Postman API 使用 15.3 Webhook 與自訂整合 企業導入策略 16.1 評估與導入路線圖 16.2 方案選擇與團隊培訓 16.3 標準化規範 最佳實務與反模式 17.1 最佳實務 17.2 常見反模式 常見問題與除錯(FAQ) 附錄 19.1 pm API 速查表 19.2 Chai Assertion 速查表 19.3 HTTP Status Code 速查表 19.4 快捷鍵速查表 19.5 新人上手 Checklist 19.6 API 測試 Checklist 19.7 安全性 Checklist 1. Postman 簡介與概觀 1.1 Postman 是什麼? Postman 是全球領先的 AI 原生 API 平台,為超過 4,000 萬開發者與 50 萬以上的組織提供 API 開發、測試、文件化、監控與協作的統一解決方案。Fortune 500 企業中有 98% 使用 Postman 作為其 API 開發流程的核心工具。根據 2025 年 State of the API 報告,90% 的開發者正在使用 API,74% 已採用 API-First 策略,而 AI 驅動的 API 流量在 2024 年增長了 73%。 ...

May 19, 2026 · 45 min · 9393 words · Eric Cheng

Chrome DevTools MCP(Model Context Protocol)教學手冊

Chrome DevTools MCP(Model Context Protocol)教學手冊 版本:v2.0 最後更新:2026-02-14 適用對象:前端工程師、全端工程師、AI 工具整合工程師、DevOps 工程師、架構師 適用環境:Windows / macOS / Linux Chrome DevTools MCP 版本:v0.17.0+(套件名稱:chrome-devtools-mcp) 官方 GitHub:https://github.com/ChromeDevTools/chrome-devtools-mcp npm 套件:https://www.npmjs.com/package/chrome-devtools-mcp 目錄 第一章:總覽與架構設計 1.1 MCP 是什麼? 1.2 Chrome DevTools MCP 架構說明 1.3 系統元件圖 1.4 互動流程圖 1.5 適用場景說明 1.6 與傳統 AI 靜態分析比較 第二章:系統架構設計 2.1 單機開發架構 2.2 團隊共享架構 2.3 CI/CD 整合架構 2.4 雲端整合架構 2.5 安全隔離建議 2.6 權限控制建議 2.7 沙箱執行模式建議 第三章:安裝與環境建置 3.1 系統需求 3.2 Chrome 版本需求 3.3 Node.js 版本需求 3.4 安裝步驟 3.5 啟動參數完整說明 3.6 連接模式說明 3.7 User Data Directory 說明 3.8 Docker 安裝方式 3.9 工具類別控制 3.10 常見錯誤排除 第四章:設定與整合 ...

February 14, 2026 · 29 min · 6177 words · Eric Cheng

Chrome DevTools 教學手冊

Chrome DevTools 教學手冊 版本:Chrome 151+(2026 年 8 月最新穩定版) 適用對象:前端工程師、後端工程師、架構師、DevOps 工程師、AI Coding Agent 使用者 定位:企業級實戰與維運教學手冊 最後更新:2026-08-19 目錄 第一章:Chrome DevTools 架構與核心原理 1.1 DevTools 整體架構說明 1.2 Browser 與 Rendering Pipeline 1.3 DOM / CSSOM / Render Tree 1.4 JavaScript Engine(V8)運作原理 1.5 Network Request Lifecycle 1.6 DevTools 與 Chromium 架構關係 第二章:安裝與環境設定 2.1 Chrome 最新版安裝 2.2 開啟 DevTools 的方式 2.3 常用快捷鍵整理 2.4 常用設定 2.5 與 VS Code 整合 2.6 Source Map 設定 2.7 Local Overrides 設定方式 2.8 Device Mode(裝置模擬模式) 2.9 Command Menu(命令選單) 第三章:Elements 面板完整教學 3.1 DOM 即時編輯 3.2 CSS 即時修改 3.3 Box Model 分析 3.4 Layout Debug 3.5 Grid / Flexbox 視覺化工具 3.6 事件監聽器檢查 3.7 強制狀態(:hover / :active) 第四章:Console 深入教學 4.1 Console API 使用 4.2 進階 Console API 4.3 樣式化 Console 輸出 4.4 Console 工具函式 4.5 操作 DOM 的 Console 技巧 4.6 Performance 分析 Console 技巧 第五章:Sources 面板(JS 除錯核心) 5.1 設定 Breakpoint(中斷點) 5.2 Conditional Breakpoint(條件斷點) 5.3 XHR / Fetch Breakpoint 5.4 Event Listener Breakpoint 5.5 Watch 變數 5.6 Call Stack 分析 5.7 Async Stack Trace 5.8 Blackbox Script(忽略腳本) 5.9 Snippets 使用 第六章:Network 面板(API 與效能分析) 6.1 Network 面板概覽 6.2 Request / Response 結構 6.3 Header / Payload 分析 6.4 API Debug 技巧 6.5 模擬慢速網路 6.6 Cache 行為分析 6.7 HTTP/1.1 vs HTTP/2 分析 6.8 WebSocket 除錯 第七章:Performance 面板(效能優化核心) 7.1 Recording 操作 7.2 FPS 分析 7.3 Main Thread 分析 7.4 Long Task 問題診斷 7.5 Reflow / Repaint 分析 7.6 Lighthouse 使用方式 7.7 Core Web Vitals 分析 7.8 Rendering 面板 7.9 Performance 進階功能 第八章:Memory 面板 8.1 Memory 面板概覽 8.2 Heap Snapshot 8.3 Allocation Timeline 8.4 記憶體洩漏診斷流程 8.5 SPA 常見 Memory Leak 問題 第九章:Application 面板 9.1 LocalStorage / SessionStorage 9.2 IndexedDB 9.3 Cookies 9.4 Service Worker 9.5 PWA Debug 第十章:Security 面板 10.1 HTTPS 分析 10.2 Mixed Content 問題 10.3 CORS Debug 10.4 CSP 分析 第十一章:Recorder 面板、AI 輔助與其他進階功能 11.1 Recorder 面板(使用者流程錄製) 11.2 AI 輔助功能(Gemini 整合) 11.3 其他實用面板 11.4 遠端除錯 第十二章:Chrome DevTools MCP — AI Coding Agent 整合 12.1 什麼是 Chrome DevTools MCP 12.2 安裝與設定 12.3 工具能力總覽 12.4 企業應用場景 12.5 安全性與治理考量 第十三章:企業級 Web Application Debug 標準流程 13.1 前端問題診斷流程 13.2 API 錯誤排查流程 13.3 效能瓶頸診斷流程 13.4 記憶體問題診斷流程 13.5 生產環境 Debug 建議 13.6 團隊 Debug SOP 第十四章:最佳實踐與團隊規範 14.1 團隊使用規範 14.2 Debug Checklist 14.3 效能優化 Checklist 14.4 Code Review 與 DevTools 使用建議 附錄 A:常見問題 FAQ Q1:DevTools 開啟後頁面變慢,是正常的嗎? Q2:為什麼 Console 的 console.log 顯示的物件值與預期不同? Q3:如何在 DevTools 中除錯 minified(壓縮後)的 JavaScript? Q4:Network 面板中 (blocked:mixed-content) 是什麼意思? Q5:為什麼 Lighthouse 每次跑分不一樣? Q6:DevTools 的 Elements 修改為什麼刷新後就消失了? Q7:如何在手機上使用 Chrome DevTools? Q8:如何將 DevTools 中的修改轉換為程式碼修改? 附錄 B:面試常考 DevTools 問題 基礎題 進階題 架構師題 附錄 C:團隊培訓建議 培訓計劃 建議培訓方式 附錄 D:延伸學習資源 官方資源 社群資源 Chrome DevTools Protocol 多語言用戶端函式庫 DevTools 生態擴充功能 推薦工具 附錄 E:檢查清單(Checklist) 新進成員 DevTools 入門清單 日常開發 Checklist 第一章:Chrome DevTools 架構與核心原理 1.1 DevTools 整體架構說明 Chrome DevTools 是內建於 Chromium 核心的開發者除錯工具組,透過 Chrome DevTools Protocol(CDP) 與瀏覽器核心通訊。 ...

February 14, 2026 · 45 min · 9480 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