Hermes Agent生態系教學手冊

Hermes Agent 生態系教學手冊(Enterprise Edition) 版本:基於 Hermes Agent v0.23.0(Git tag v0.23.0,2026 年 11 月 5 日 — The Hearth Release;涵蓋 v0.22.0 The Threshold 與 v0.21.1–v0.22.7 全部補丁);文件版本 v9.0.0 適用對象:資深工程師 / 架構師 / DevOps 團隊 / 技術採購與風險評估決策者 軟體授權:MIT License(Hermes Agent 本體完全開源、免費、可自架;下述訂閱方案僅為選用的 Nous Portal 代管服務,非軟體授權費) 官方網站:hermes-agent.nousresearch.com GitHub:github.com/NousResearch/hermes-agent 官方文件:hermes-agent.nousresearch.com/docs Desktop 下載:hermes-agent.nousresearch.com(macOS 13+ Apple Silicon 簽章 DMG/Windows 11 22H2+ MSIX 或 Microsoft Store;官方不提供 Linux 與 Intel macOS 桌面套件) Skills Hub:agentskills.io / skills.sh LLM 友善文件:llms.txt / llms-full.txt 最後更新:2026 年 11 月 8 日 資料來源聲明:本文所有版本資訊、功能敘述均逐條核對 GitHub Releases API(v0.21.0 起 18 份 release notes)、GitHub REST API(倉庫即時數據)、v0.23.0 tag 的原始碼與 website/docs/(435 頁)、GitHub Advisory 資料庫;指令、設定鍵與環境變數另以實際安裝的 v0.23.0 驗證(真實 argparse 指令樹、hermes config set 使用的設定鍵驗證器、官方環境變數參考),方法與結果見附錄 E;價格類數字凡標示「二手來源」者,代表官方定價頁在查證當下回應 HTTP 429,未能以一手頁面直接核實,建議上線前至 portal.nousresearch.com/manage-subscription 覆核。 ...

June 30, 2026 · 144 min · 30461 words · Eric Cheng

Multica 教學手冊

Multica 教學手冊(企業級實戰版) 項目 內容 手冊版本 v3.0(2026-11-10) 產品基準 Multica v0.8.2(2026-11-10,commit b7f8efcaa,go.mod Go 1.26.9);前一版手冊 v2.0 基準為 v0.6.1 適用對象 資深工程師、架構師、DevOps/平台工程師、資安與技術主管 技術棧 Go 後端(Chi + sqlc + gorilla/websocket)、Next.js 16 Web、Electron 44 Desktop、Expo iOS、PostgreSQL 17(pgcrypto + pg_trgm)、Redis(選用)、本機 Agent Daemon、Qoder Cloud Agents 橋接 授權 Multica License(Apache License 2.0 全文,加上託管/嵌入、品牌、署名三類附加條件) 文件等級 企業標準技術白皮書 本手冊使用下列標記: 標記 意義 ⚠️ 注意 不遵守會造成資料遺失、安全風險或服務中斷的事項 💡 實務建議 來自官方文件或社群經驗、可直接採用的做法 📘 建議實務 本手冊依企業導入經驗補充的治理/流程建議,非 Multica 官方功能或規範 v0.x.y+ 該功能自此版本起提供(依官方 changelog) 本手冊所有 CLI 指令與旗標均已對照 v0.8.2 原始碼中的 cobra 指令定義;所有環境變數均已對照 v0.8.2 原始碼與官方文件;官方文件與原始碼不一致時以原始碼為準並列入更正表。驗證方法與待確認事項見附錄 F,v3.0 的變更見附錄 E。 ...

June 30, 2026 · 140 min · 29676 words · Eric Cheng

Oh My Openagent(Oh My OpenCode, OMO)教學手冊

oh-my-openagent(Oh My OpenCode, OMO)教學手冊 版本:v6.0|最後更新:2026-06-30 對應 OMO 版本:v4.14.1(208 releases) 適用對象:資深工程師、架構師、技術主管 定位:企業級 Multi-Harness AI Agent OS 教學手冊 GitHub:https://github.com/code-yeongyu/oh-my-openagent 官網:https://omo.dev/ 📑 目錄 第 1 章:總覽(Overview) 第 2 章:系統架構設計(Architecture) 第 3 章:安裝與環境建置(Installation) 第 4 章:設定與專案初始化(Configuration) 第 5 章:Agent 系統詳解(Discipline Agents) 第 6 章:開發流程(ultrawork / Plan / Build) 第 7 章:Team Mode(v4.0 新增) 第 8 章:Boulder 追蹤系統(v4.1 新增) 第 9 章:Web Application 實戰 第 10 章:測試與品質(Testing & Quality) 第 11 章:維運與除錯(Maintenance) 第 12 章:升級與版本管理(Upgrade) 第 13 章:安全(SSDLC) 第 14 章:團隊導入策略(Enterprise Adoption) 第 15 章:最佳實務(Best Practices) 第 16 章:常見問題(FAQ) 第 17 章:遙測與隱私(Telemetry & Privacy) 第 18 章:附錄(Appendix) 檢查清單(Checklist) 第 1 章:總覽(Overview) 1.1 什麼是 oh-my-openagent(OMO) oh-my-openagent(簡稱 OMO,又稱 Oh My OpenCode)是由 code-yeongyu 開發的 Multi-Harness AI Agent OS,以 TypeScript 編寫(86.2%),專為將 OpenCode(開源終端 AI 編碼代理)升級為一個具備**紀律型多代理協作(Discipline Agents)**能力的 AI 開發團隊。自 v4.3.0 起,OMO 進行了 Multi-Harness 重構,將核心邏輯拆分為 9 個獨立 workspace packages,支援 OpenCode、Codex CLI 等多種 Harness 平台。 ...

June 30, 2026 · 50 min · 10595 words · Eric Cheng

OpenClaw生態系教學手冊

OpenClaw 生態系教學手冊 手冊版本: 4.0.0(2026-11-08) 基準版本: OpenClaw 2026.11.1(npm latest,build 4ffdd20,2026-11-05)/2026.9.36(npm extended-stable,LTS 九月線)/2026.11.5-beta.1(npm beta) 最後更新: 2026 年 11 月 8 日 適用對象: 企業開發團隊、DevOps 工程師、AI 架構師、資安與稽核人員 授權: MIT License(治理單位:非營利的 OpenClaw Foundation) 官方資源: openclaw.ai · docs.openclaw.ai · GitHub · ClawHub · Discord · Trust · DeepWiki 驗證方式: 本手冊所有 openclaw.json 範例皆以 2026.11.1 的 openclaw config validate --json 實測通過;所有 CLI 範例皆比對 2026.11.1 的 630 個指令路徑;Java 範例以 Maven 實際編譯與測試;TypeScript 範例以 tsc --strict 型別檢查。詳見附錄 F。 文件總覽 本手冊是 OpenClaw 生態系的企業級教學指引,涵蓋核心概念、系統架構、安裝部署、開發實戰、企業治理、維運監控、升級策略、DevOps、資安設計、實戰案例、多人協作與分散式執行等十二大主題,並附導入檢查清單、疑難排解、名詞解釋、參考資源、升級遷移指南與驗證紀錄。內容依據 OpenClaw 官方文件(v2026.11.1 的 docs/ 原始檔)、GitHub Release Notes 與 CHANGELOG、Security Advisories 重新消化整理,以繁體中文撰寫;整合範例以 Java 21/Spring Boot 4 為主,Plugin SDK 與 Gateway Protocol 等官方以 TypeScript 定義契約之處則以 TypeScript 示範。 ...

June 30, 2026 · 177 min · 37634 words · Eric Cheng

Playwright 教學手冊

Playwright 教學手冊(企業級完整版) 版本:基於 Playwright v1.62.1(2026 年 7 月) 適用對象:資深工程師、SDET、QA Lead、DevOps 工程師、技術決策者 授權:Apache 2.0(Playwright 開源授權) 最後更新:2026-08-15 執行摘要(Executive Summary) Playwright 是 Microsoft 主導開發的開源瀏覽器自動化框架,自 2020 年首次發布以來,已成為端對端(E2E)測試領域成長最快的解決方案。根據 2026 年業界調查,Playwright 在新專案採用率已達 45.1%,首度超越 Selenium(22.1%)與 Cypress(14.4%),npm 週下載量突破 1,300 萬次,GitHub 星數超過 9.4 萬顆,反映其在測試社群的主流地位。 對企業而言,導入 Playwright 的核心價值在於三個面向: 降低維護成本:內建 Auto-wait 與 Web-First Assertions 機制,實測可減少約六成因時序問題(Race Condition)導致的 Flaky Test,顯著降低 SDET 團隊的除錯負擔。 降低基礎設施成本:原生支援跨瀏覽器(Chromium/Firefox/WebKit)與平行測試,無需額外部署 Selenium Grid 一類的叢集基礎設施,即可於 CI/CD 中橫向擴展。 加速 AI 導入測試流程:透過 Playwright MCP、Playwright CLI 與 Playwright Agents(Planner/Generator/Healer),企業可將 LLM Coding Agent 導入測試規劃、產生與自動修復流程,是目前主流測試框架中對 AI Agent 生態系整合最完整的方案。 本手冊以「企業級落地」為核心設計,涵蓋從系統架構設計、多環境配置、CI/CD 整合、安全合規到團隊導入的完整生命週期,適合作為 SDET / QA Lead 規劃導入策略、DevOps 工程師建置 Pipeline,以及技術決策者評估投資報酬率(ROI)的參考文件。內文所有版本標註(如 v1.60+)皆對應 Playwright 官方 Release Notes,讀者可據此判斷所屬環境的相容性。 ...

June 30, 2026 · 52 min · 11009 words · Eric Cheng

Superpowers教學手冊

Superpowers 教學手冊(企業標準技術白皮書) 版本:v7.0|基於:Superpowers Framework v6.3.0(by Jesse Vincent / obra @ Prime Radiant) 最後更新:2026-08-18|適用對象:資深工程師、Tech Lead、AI Agent 團隊|語言:繁體中文 GitHub:https://github.com/obra/superpowers ⭐ 273k+ stars · 24.4k+ forks · 49+ Contributors(實測查證,obra/superpowers) Plugin Marketplace:https://claude.com/plugins/superpowers(Anthropic Verified · 1,000,000+ installs) Discord 社群:https://discord.gg/35wsABTejz Commercial Support:sales@primeradiant.com License:MIT 目錄 第 1 章:Superpowers 概述 1.1 什麼是 Superpowers 1.2 與 Prompt Engineering / Agent Framework 的差異 1.3 適用場景 1.4 核心價值:工程紀律 1.5 支援平台總覽 1.6 版本演進歷程 第 2 章:整體系統架構設計 2.1 Superpowers 在 AI 開發架構中的位置 2.2 Plugin 架構與多平台支援 2.3 技能自動觸發機制 2.4 Hooks 系統 2.5 與 CI/CD 系統整合 2.6 整體技術堆疊 第 3 章:安裝與環境建置 3.1 前置要求 3.2 安裝步驟 3.3 專案初始化 3.4 建議目錄結構 3.5 Dev Container 配置(選用) 3.6 升級方式 3.7 驗證安裝 第 4 章:核心 Skills 詳解 4.1 完整技能庫總覽 4.2 The Basic Workflow(7 步驟) 4.3 Brainstorming(需求釐清)+ Visual Companion 4.4 TDD — 測試驅動開發 4.5 Writing Plans(微步驟計畫)+ Document Review 4.6 Subagent-Driven Development(Subagent 分工開發) 4.7 Systematic Debugging(系統化除錯) 4.8 Git Worktrees(隔離開發環境) 4.9 其他重要技能 第 5 章:實戰開發流程(End-to-End) 5.1 開發流程總覽(The Basic Workflow) 5.2 完整範例:電商訂單結帳功能 5.3 流程時間線總覽 第 6 章:與企業系統整合 6.1 整合架構總覽 6.2 與 Spring Boot 整合 6.3 與微服務架構整合 6.4 與資料庫整合 6.5 與訊息佇列整合(Kafka / RabbitMQ) 6.6 與 API Gateway 整合 第 7 章:CI/CD 與 DevOps 7.1 CI/CD Pipeline 架構 7.2 GitHub Actions Workflow 7.3 SonarQube 品質控管 7.4 ArchUnit 架構測試 7.5 自動部署流程 第 8 章:系統維運(Maintenance) 8.1 AI 產出品質維持 8.2 技術債控制 8.3 Debug 流程標準化 8.4 Log / Monitoring 第 9 章:系統升級與版本管理 9.1 Superpowers 升級策略 9.2 Skills 版本控管(Plugin 架構) 9.3 相容性矩陣 9.4 完整版本歷程摘要 第 10 章:最佳實務(Best Practices) 10.1 AI 不可跳過測試 10.2 強制 Planning 10.3 小步提交 10.4 Clean Architecture 10.5 Subagent-Driven Development 最佳實務 10.6 Document Review System 最佳實務 第 11 章:反模式(Anti-patterns) 11.1 反模式總覽 11.2 開發反模式詳解 11.3 流程反模式詳解 11.4 組織反模式詳解 11.5 v5.0 新增反模式 第 12 章:企業導入策略 12.1 團隊導入路線圖 12.2 Governance(治理) 12.3 Code Review 機制 12.4 AI 使用規範 第 13 章:完整範例專案 13.1 專案概述 13.2 專案架構 13.3 範例程式碼 13.4 測試案例 13.5 開發流程示範 附錄 A:AI Agent Team 協作模式 附錄 B:與 MCP 整合 附錄 C:新進成員檢查清單(Checklist) 附錄 D:詞彙表 附錄 E:完整版本歷程摘要 附錄 F:v5.0.6 重大變更——Inline Self-Review 取代 Subagent Review Loops 附錄 G:v5.1.0 重大變更——Factory Droid、Worktree 重寫與 SDD 連續執行 附錄 H:v6.0.0 重大變更——SDD 審查重寫、Vendor-Neutral 與三新平台 附錄 I:v6.2.0 重大變更——Gemini CLI 回歸與 SDD 生命週期改造 附錄 J:v6.3.0 重大變更——四大新平台、儀式感分級與 SDD 煞車機制 第 1 章:Superpowers 概述 章節摘要:本章介紹 Superpowers 的核心理念、與其他 AI 開發方法論的差異、支援平台、版本演進,以及它為企業團隊帶來的「工程紀律」價值。 ...

June 30, 2026 · 91 min · 19279 words · Eric Cheng

VS Code + GitHub Copilot 開發 Java Web 應用程式教學手冊(3)

VS Code + GitHub Copilot 開發 Java Web 應用程式教學手冊(3) 版本:v3.0(2026-06-30) 前版:v2.0(2026-03-27) 適用對象:初學者 / 中階工程師 / 企業團隊 技術棧:VS Code 1.126(2026-06-24 發布)· GitHub Copilot(含 Chat、Autopilot、Agent Mode、Agents Window、CLI Agent、Cloud Agent、Research Agent)· Java 21+ · Spring Boot 3.4.x · Maven 定位:企業標準技術白皮書 — 可直接用於專案團隊內部開發規範文件 變更說明:根據 VS Code 1.123–1.126 Release Notes、Agents Window、Autopilot、MCP OAuth、1M Context Window 等重大更新全面改版 目錄 1. 總覽 1.1 VS Code 在 Java 開發的優勢 1.2 GitHub Copilot 在開發流程中的角色 1.3 VS Code 1.123–1.126 重要新功能摘要 1.4 VS Code vs IntelliJ 差異分析 2. 開發環境安裝與設定 2.1 必備工具 2.2 VS Code Extension 推薦 2.3 環境設定步驟 2.4 Copilot 自訂化設定 3. 建立第一個 Spring Boot 專案 3.1 使用 Spring Initializr 3.2 專案結構說明 3.3 執行與測試 API 3.4 使用整合式瀏覽器測試 Web 應用 4. GitHub Copilot 實戰應用 4.1 基本用法 — Inline Completion 與 Inline Chat 4.2 Copilot Chat 進階用法 4.3 Agent Mode 與 Autopilot 深度指南 4.4 Agents Window 與 Session 管理 4.5 Research Agent 深度研究 4.6 Prompt Engineering 4.7 MCP Server 整合 4.8 Custom Instructions / Agent Skills / Custom Agents 5. 專案架構設計(企業級) 5.1 Clean Architecture / Hexagonal Architecture 5.2 分層設計 5.3 DTO / VO / Entity 分離 6. 安全性與最佳實務 6.1 Spring Security 基本設定 6.2 API 驗證(JWT) 6.3 Copilot 生成程式碼的安全檢查 7. 測試與除錯 7.1 單元測試(JUnit 5) 7.2 API 測試 7.3 VS Code Debug 技巧 7.4 使用 Copilot 協助除錯 7.5 整合式瀏覽器 Agent 測試 8. CI/CD 與版本控管 8.1 Git 基本流程 8.2 GitHub Actions 基本 CI/CD 8.3 Copilot 協助產生 Pipeline 8.4 Cloud Agent 與 PR 協作(Preview) 9. 系統維護與升級 9.1 VS Code 更新策略 9.2 Extension 管理 9.3 Copilot 模型更新與成本管理 10. 團隊導入建議(企業級) 10.1 開發規範 10.2 Copilot 使用規範 10.3 Code Review 流程 10.4 AI 輔助開發治理 11. 常見問題與最佳解法(FAQ) 12. 附錄 12.1 常用指令速查表 12.2 範例 Prompt 清單 13. 檢查清單(Checklist) 1. 總覽 1.1 VS Code 在 Java 開發的優勢 VS Code 從輕量級編輯器發展至今,已成為企業級 Java 開發的主流選擇之一。主要優勢: ...

June 30, 2026 · 45 min · 9540 words · Eric Cheng

Vscode_copilot_java_web_manual(1)

使用 VS Code 與 GitHub Copilot 開發 Java Web 應用程式教學手冊(1) 版本:2026 年 6 月版(對應 VS Code 1.126) | 適用對象:初中階 Java 開發人員 | 維護單位:資深架構師團隊 目錄 前言與環境概述 1.1 為什麼選擇 VS Code + GitHub Copilot? 1.2 技術棧總覽 1.3 學習路徑建議 安裝與環境設定 2.1 安裝 Java JDK 2.2 安裝 VS Code 2.3 安裝必要擴充套件 2.4 啟用 GitHub Copilot 2.5 VS Code 設定(settings.json) 專案建立與初始化 3.1 使用 Spring Initializr 建立專案 3.2 VS Code 開啟與結構說明 GitHub Copilot 核心功能使用 4.1 程式碼自動補全(Inline Suggestions) 4.2 Next Edit Suggestions(NES) 4.3 Copilot Chat 對話式開發 4.4 Agent Mode(代理模式) 4.5 使用 Inline Chat 4.6 自訂指令與 Prompt 檔案 4.7 MCP 伺服器整合 Java Web 開發實戰 5.1 建立 REST API Controller 5.2 Service 層與 Repository 層 5.3 連接資料庫(JPA + MySQL) 5.4 安全性設定(Spring Security) 除錯與測試 6.1 VS Code 除錯設定 6.2 單元測試與 Copilot 輔助 6.3 整合測試 系統維護與升級 7.1 相依套件版本管理 7.2 VS Code 與擴充套件升級 7.3 Java 版本升級指引 最佳實踐與團隊建議 8.1 Copilot 使用原則 8.2 程式碼品質規範 8.3 團隊協作建議 8.4 安全與信任控制 常見問題 FAQ 附錄:Prompt 參考範本 10.1 生成程式碼類 10.2 除錯與分析類 10.3 測試類 10.4 架構與設計類 1. 前言與環境概述 1.1 為什麼選擇 VS Code + GitHub Copilot? Visual Studio Code 已發展為功能完備的開發平台,最新版本(1.126,2026 年 6 月發布)內建 AI Agent 功能,可直接在編輯器中以自然語言驅動開發流程。VS Code 搭配 GitHub Copilot 的 Agent Mode,開發者僅需描述任務意圖,Agent 便能自動規劃步驟、跨檔案編輯程式碼、執行終端命令並自我修正,直到任務完成。 ...

June 30, 2026 · 16 min · 3325 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