Humanlayer Skills 教學手冊

humanlayer/skills 教學手冊 humanlayer/skills —— HumanLayer 開源之 Claude Code Skills 企業導入完整指南 適用對象:資深 Software Architect、SA、Tech Lead、PM、SD/PG、DevOps、AI Engineer、Legacy Modernization Architect 文件性質:企業內部「humanlayer/skills」導入、開發與治理培訓教材,偏重實戰與維運 版本基準:humanlayer/skills(GitHub 官方 Repository,main 分支)+ docs.humanlayer.com 官方文件 查證日期:2026-08-24 技術堆疊:Claude Code、Node.js/npx(安裝工具鏈)、Git/GitHub、GitHub Actions(由 Skill 產生的下游範本) ⚠️ 重要聲明(請務必先讀) 本手冊是彙整、重組、補充企業導入實務,而不是官方文件的翻譯。 本書不逐字翻譯官方 README,而是依官方 Repository(README.md、.claude-plugin/marketplace.json、 plugins/*/skills/*/SKILL.md)與 docs.humanlayer.com 官方文件重新查證後,以繁體 中文重新組織、延伸為企業教材,並大量補充 Scenario、AI Prompt 範例、比較表、 Checklist 與企業導入建議。 humanlayer/skills 是一個以 GitHub Repository 形式散布的 Claude Code Skills 集合, 官方定位語句為「Claude Code skills from HumanLayer.」。 本手冊會不斷強調一個 核心觀念:Skill 不只是一段 Prompt,而是一個可被 AI Coding Agent 執行的工作能力與 工程流程封裝——包含觸發條件、指令腳本、參考範本、輸出格式與(部分 Skill)會 進一步產生 GitHub Actions workflow,讓 Agent 的執行流程可被重複觸發、可被治理、 可被審計。 ...

August 24, 2026 · 85 min · 17967 words · Eric Cheng

QM教學手冊

QM 教學手冊 QM —— Y Combinator Software 開源之 Multiplayer Agent Harness for Work 企業導入完整指南 適用對象:資深 Software Architect、SA、Backend/Frontend Engineer、DevOps/SRE、Cloud Architect、Cybersecurity Architect、AI Agent 平台團隊、Tech Lead、企業導入負責人 文件性質:企業內部「QM」導入、開發與維運培訓教材,偏重實戰與維運 版本基準:yc-software/qm(MIT License),研究基準為官方 GitHub main 分支,查證時(2026-08-21)約 14,000+ ★ / 1,600+ forks(會隨時間持續變動,數字僅供查證當下參考) 查證日期:2026-08-21 技術堆疊:Node.js(>=24.15.0)、TypeScript(type: module)、Fastify、PostgreSQL、Slack(Bolt)、Vite/Lit(Web UI)、MIT License ⚠️ 重要聲明(請務必先讀) QM 是一個 2026-07-29 才建立、目前仍高速迭代中的年輕開源專案。 查證時(2026-08-21)repository 尚有 101 則 open Issues、195 個 open PR,涵蓋 turn 結果記錄語意、cron 重試/退避、provider failover、admin 稽核日誌等尚在修正中的行為。任何 CLI 指令、環境變數、目錄結構、Security 行為,在正式導入前,務必以你實際安裝版本的官方 README.md/SECURITY.md/cli/README.md/docs/ 為準。 本手冊是彙整、重組、補充企業導入實務,而不是官方文件的翻譯。 本書不逐字翻譯官方 README,而是依官方 Repository(README、SECURITY.md、AGENTS.md、CLI 文件、部署文件、.env.example、package.json、原始碼目錄結構)與官方網站 qm.ycombinator.com 重新查證後,以繁體中文重新組織、延伸為企業教材,並大量補充 Scenario、AI Prompt 範例、比較表、Checklist 與企業導入建議。 ...

August 21, 2026 · 71 min · 15049 words · Eric Cheng

Everything Claude Code 教學手冊

Everything Claude Code (ECC) 教學手冊 企業標準技術白皮書 | 文件版本 v4.0(2026-11-02,全面重組改版)| 前一版 v3.1(2026-08-31) 文件資訊 項目 內容 對應 ECC 版本 v2.2.3(npm ecc-universal@2.2.3,Git tag v2.2.3,發行 2026-10-01);另以 main@b38be6a(2026-10-30)說明尚未發行的 [Unreleased] 變更 對應 Claude Code 版本 2.1.316(本手冊所有原生功能皆以此版官方文件 code.claude.com/docs 查證) AgentShield 版本 ecc-agentshield@1.6.0(npm latest) 查證日期 2026-11-02 適用對象 軟體工程師(初階~資深)、系統架構師、DevOps/SRE、AI 平台工程師、資安人員、技術主管(導入決策) 授權 ECC 為 MIT License;ECC Tools Pro/Enterprise 為選配的商業託管 GitHub App(見 24.6) 官方來源 GitHub https://github.com/affaan-m/ECC ∣ 網站 https://ecc.tools ∣ npm ecc-universal、ecc-agentshield ∣ Plugin 識別碼 ecc@ecc ∣ 繁體中文 README 社群快照(GitHub REST API,2026-11-02) 295,141 Stars ∣ 43,688 Forks ∣ open_issues_count 201(Issue 與 PR 合計) ∣ 最後推送 2026-11-02 ⚠️ 官方來源警示:ECC README 明確警告「只從官方管道安裝」——GitHub affaan-m/ECC、npm ecc-universal/ecc-agentshield、GitHub App ecc-tools、Plugin ecc@ecc、網站 ecc.tools。第三方轉傳與鏡像不受專案維護,可能含惡意程式(見 17.3 供應鏈風險)。 ...

August 21, 2026 · 104 min · 22083 words · Eric Cheng

Prime Agent教學手冊

Prime Agent 教學手冊(企業導入與實戰完整版) 版本:v0.7.4(2026 年 8 月 19 日發布;本手冊查證日期 2026 年 8 月 20 日) 適用對象:初學者、一般開發者、資深工程師、架構師、DevSecOps 工程師、PM/SA、AI Agent 導入負責人 技術棧示範:Java 25 / Spring Boot 4.x / Spring Framework 7.x / Maven 4.x / Vue 3 / TypeScript / Tailwind CSS / PrimeVue / Pinia / PostgreSQL / Oracle / DB2 / SQL Server / Redis / Kafka / MQ 授權:MIT License 開發/維護:Prime Intellect 專案性質:earendil-works/pi 的 Hard Fork(詳見第 1 章),npm 套件內部仍沿用 @earendil-works/pi-coding-agent 官方倉庫:github.com/PrimeIntellect-ai/prime-agent 文件用途:企業 AI Software Development/Agent Engineering 導入教材 文件作者:AI Software Architecture Team ...

August 20, 2026 · 65 min · 13767 words · Eric Cheng

Semantica 教學手冊

Semantica 教學手冊 Semantica —— AI Agent 的 Context Graph、Knowledge Graph 與 Decision Intelligence 基礎設施層完整導入指南 適用對象:資深 Software Architect、SA、Backend/Frontend Engineer、AI Agent 平台團隊、DevSecOps、Tech Lead、企業導入負責人 文件性質:企業內部「AI Agent Context / Knowledge Graph / Decision Intelligence / Provenance」基礎設施導入、開發與維運培訓教材 版本基準:semantica-agi/semantica(MIT License),研究基準為官方 GitHub main 分支與 docs.getsemantica.ai 最新穩定版 v0.6.5(2026-08-11),研究/查證日期:2026-08-20 技術堆疊:Python ≥3.8、pip、可選 Neo4j/FalkorDB/Apache AGE/AWS Neptune(LPG)、內嵌 Oxigraph/Blazegraph/Jena/RDF4J/Anzo(RDF)、FAISS/Qdrant/Weaviate/Milvus/Pinecone/PgVector(Vector)、MIT License ⚠️ 重要聲明(請務必先讀) Semantica 是一個真實存在、仍在快速迭代中的開源專案。 本手冊撰寫時已透過官方 GitHub Repository(github.com/semantica-agi/semantica)、官方文件站(docs.getsemantica.ai)與 PyPI(pypi.org/project/semantica)逐項查證,並非虛構專案。但 Semantica 平均每 3-6 週釋出一次 minor 版本(v0.4.0 → v0.6.5 僅約 4 個月),CLI 指令、Python API 簽章、設定鍵、目錄結構都可能隨版本演進調整。任何指令、程式碼、路徑在正式導入前,務必以官方最新 README.md、docs.getsemantica.ai、CHANGELOG/Release Notes 與你實際安裝的版本為準(例如執行 semantica --help、python -c "import semantica; print(semantica.__version__)" 逐一核對)。 ...

August 20, 2026 · 59 min · 12402 words · Eric Cheng

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

RAGFlow教學手冊

RAGFlow 教學手冊 RAGFlow —— 企業級 AI Agent Context / Knowledge / RAG 基礎平台完整導入指南 適用對象:資深 Software Architect、SA、Backend/Frontend Engineer、AI Agent 平台團隊、DevSecOps、Tech Lead、PM/PG/QA、企業導入負責人 文件性質:企業內部「RAGFlow」導入、開發與維運培訓教材,重點放在 RAGFlow 作為 AI Agent Context Infrastructure,協助 AI Agent 進行 Web Application 開發、既有系統逆向工程、Software Framework 升級 版本基準:infiniflow/ragflow(Apache-2.0 License),最新穩定 Release v0.26.4(2026-07-07,commit cb93883f);另存在 nightly 預發布頻道(查證當下對應 commit 9c81d9b,2026-08-17) 架構總覽(第3章)之目錄結構、Docker Compose 服務清單,查證基準為 main 分支 HEAD(查證當下最後 push 時間 2026-08-18T06:26:42Z);指令、設定鍵等逐字內容之查證基準以 v0.26.4 tag 為主,兩者若有落差會於文中另行標註 查證日期:2026-08-18 技術堆疊:Python(核心 RAG/DeepDoc/Task Executor 邏輯)+ Go(admin/cmd/internal 等新增之管理與閘道服務層)+ TypeScript(web 前端),可插拔文件檢索引擎(Elasticsearch/Infinity/OpenSearch/OceanBase/SereneDB/SeekDB)與可插拔關聯式資料庫(MySQL/PostgreSQL/GaussDB/OceanBase) ⚠️ 重要聲明(請務必先讀) RAGFlow 是一個仍在高速迭代的開源專案,發版節奏非常快。 光是查證當下往前推兩個月,官方就發布了 v0.26.1(2026-06-17)、v0.26.2(2026-06-29)、v0.26.3(2026-07-02)、v0.26.4(2026-07-07)四個版本,平均每 1-2 週就有一次含功能異動的正式 Release(官方已實作,GitHub Releases)。這代表本手冊記錄的 CLI 指令、Docker Compose 服務、設定鍵、API 端點、Agent 功能,都只是查證當下(2026-08-18)的快照。任何指令、設定、路徑在正式導入前,務必以官方最新 README.md/docs//docker/docker-compose*.yml/docker/.env/Release Notes 與你實際安裝的版本為準。 ...

August 18, 2026 · 80 min · 16834 words · Eric Cheng

DeepSeek Harness 教學手冊

DeepSeek Harness 教學手冊 DeepSeek Harness —— 企業級「一切皆插件」AI Agent Harness 完整導入指南 適用對象:資深 Software Architect、SA、Backend/Frontend Engineer、AI Agent 平台團隊、DevSecOps、Tech Lead、PM/PG/QA、企業導入負責人 文件性質:企業內部「DeepSeek Harness(dsh)+ Cordis Plugin Architecture」導入、開發與維運培訓教材 版本基準:deepseek-ai/deepseek-harness(MIT License),最新 Release dsh-v0.1.0-rc.7(2026-08-17,Developer Preview,GitHub 標示為 Pre-release;本次補強研究已再次確認查證當下無更新 Release) 官方文件基準:README.md/README.zh.md/AGENTS.md/CLAUDE.md/docs/architecture.md/docs/development.md/docs/cordis-primer.md/docs/cordis-tutorial/*/docs/config-catalog.md/docs/glossary.md/docs/agent-lifecycle.md/docs/capability-seams.md/packages/*/README.md(含 mcp/、acp/ 等互通性家族)/apps/cli/README.md 查證日期:2026-08-18(初版查證);同日以 4 個並行研究單位完成補強研究,深化查證官方核心文件、新增子系統(mcp/acp/runtime-diagnostics 等)、Cordis/Cordis Paper 理論基礎、第三方市場評測與命名衝突現況,詳見 Appendix F 技術堆疊:Node.js(22.19+ 或 24+)+ TypeScript Monorepo(pnpm workspaces)、Cordis Plugin Runtime(原始碼 vendor、釘住特定 commit)、YAML 設定檔(cordis.yml)、選用 Python SDK ⚠️ 重要聲明(請務必先讀) DeepSeek Harness 仍處於「開發者預覽(Developer Preview)」階段,且是極年輕的專案。 官方 Repository 於 2026-08-13 建立,本手冊查證當下(2026-08-18)距今僅 5 天,最新版本為 dsh-v0.1.0-rc.7(2026-08-17 發布,GitHub 標示 pre-release)。官方 README 原文明確聲明:「DeepSeek Harness is currently in developer preview and is iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES.」(官方已實作)。這代表本手冊記錄的 CLI 指令、Package 清單、設定鍵、Plugin API,都只是查證當下的快照,實際導入前務必以當時的 github.com/deepseek-ai/deepseek-harness 原始碼與 Release Notes 為準。 ...

August 18, 2026 · 69 min · 14611 words · Eric Cheng

程式規格書(Program Specification)範本

程式規格書(Program Specification Document)範本 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 3.4 節 參照標準:IEEE 1016-2009、ISO/IEC/IEEE 12207:2026、ISO/IEC 8631:1989 適用對象:系統分析師(SA)、開發工程師、委外/外包開發廠商 文件性質:單一程式/批次工作之詳細規格文件,作為程式撰寫與驗收的直接藍圖 📑 章節目錄 文件資訊 程式基本資訊 功能說明 輸入規格 輸出規格 處理邏輯 畫面/報表版面配置 資料庫/檔案存取設計 錯誤處理與訊息代碼 效能與作業排程考量 測試要點 附錄 審查與驗證 範例:客戶月結對帳批次程式(BATCH-CUST-RECON-001) 📋 使用說明 程式規格書是以「單一程式或批次工作」為撰寫單位的實作藍圖,將 TSD(技術規格文件)的模組/服務層級設計,進一步展開為可直接編碼的輸入輸出欄位、處理邏輯、畫面或報表版面與錯誤代碼。相較於 TSD 偏重物件導向的類別/方法設計,程式規格書更貼近傳統主機、批次、報表與轉檔程式的撰寫方式。 何時使用本範本 批次程式(Batch Job):日結、月結、對帳、資料清算等排程程式 報表程式:產出固定版面報表、對外申報檔案 介面轉檔程式:與外部系統的檔案交換、資料匯入匯出 委外/外包開發:需要逐支程式驗收,規格必須避免「口頭補充」 任何需要精確定義輸入輸出欄位與處理邏輯、無法僅以 TSD 類別設計涵蓋的程式 與其他文件的關係 SDD(如何設計整體架構) → TSD(模組/服務層級技術規格) → 程式規格書(單一程式的實作藍圖) → Source Code ↑ ↑ ↑ ↑ 架構師 開發工程師 SA / 開發工程師 開發工程師 TSD 定義模組內的類別、方法、演算法與資料結構,適合物件導向、微服務式的系統設計 程式規格書 則是「向下再展開一層」:把 TSD 的設計具體落實到單一程式的輸入來源、輸出目的、逐步處理邏輯與例外情境,讓程式撰寫者(含委外廠商)不需回頭詢問即可完成編碼 兩者可搭配使用:物件導向服務層級用 TSD;批次/報表/轉檔類程式或委外驗收則另補程式規格書 填寫原則 輸入輸出明確:每個欄位都需標註型別、長度、必要性與驗證規則,不可只用文字概略描述 處理邏輯可執行:流程敘述與虛擬碼需精確到可直接轉換為程式碼,邏輯表示法建議依循 ISO/IEC 8631 的慣例(結構化流程圖/虛擬碼),避免撰寫者各自發明符號 正常與異常並重:正常流程之外,需完整列出所有已知的例外情境與對應處理、錯誤代碼 可獨立驗收:規格本身應足以作為驗收依據,尤其用於委外開發時 📄 範本正文 [程式代號/程式名稱] 程式規格書 1. 文件資訊 項目 內容 文件編號 PSD-[專案代碼]-[程式代碼]-[序號] 版本 v0.1 建立日期 YYYY-MM-DD 最後更新 YYYY-MM-DD 撰寫者 [SA / 開發工程師姓名] 審核者 [技術主管 / 架構師] 狀態 草稿 / 審查中 / 已核准 版本歷程 版本 日期 修改人 修改內容摘要 v0.1 YYYY-MM-DD [姓名] 初版建立 關聯文件 文件名稱 文件編號 版本 關聯性 技術規格文件(TSD) TSD-XXX-001 v1.0 所屬模組技術設計 系統設計文件(SDD) SDD-XXX-001 v1.0 系統架構來源 2. 程式基本資訊 項目 內容 程式代號 [如 BATCH-CUST-RECON-001] 程式名稱 [程式中文名稱] 程式類型 Online(線上)/ Batch(批次)/ Report(報表)/ Interface(介面轉檔) 所屬系統/模組 [系統名稱] 觸發方式 排程(Cron)/ 人工執行 / 事件觸發 / API 呼叫 執行排程 [如:每月最後一個工作日 02:00] 前置程式 [執行前必須先完成的程式代號,無則填「無」] 後續程式 [本程式完成後接續執行的程式代號,無則填「無」] 預估工時 [人天] 3. 功能說明 3.1 程式目的 一句話說明本程式解決什麼問題、為何需要。 ...

August 17, 2026 · 3 min · 596 words · Eric Cheng

Pdf Inspector教學手冊

pdf-inspector 教學手冊 pdf-inspector —— Firecrawl 開源 PDF 分類與擷取引擎:企業 AI Agent 文件理解基礎架構完整實戰指南 適用對象:資深 Software Architect、SA、Backend/Frontend Engineer、AI Agent 平台團隊、DevSecOps、Tech Lead、QA、企業導入負責人 文件性質:企業內部「PDF 前處理 + AI Agent 開發 / Legacy Reverse Engineering / Framework Upgrade / RAG」導入與維運培訓教材 版本基準:firecrawl/pdf-inspector(MIT License),研究基準為官方 GitHub main 分支與 Cargo.toml,目前版本 v1.14.2(PyPI 最後發布 2026-08-13) 查證日期:2026-08-16 技術堆疊:Rust(核心,edition 2021)、Python >=3.8(PyPI pdf-inspector)、Node.js/Bun(npm @firecrawl/pdf-inspector)、Browser WebAssembly(npm @firecrawl/pdf-inspector-wasm)、CLI(pdf2md / detect-pdf)、MIT License ⚠️ 重要聲明(請務必先讀) pdf-inspector 是一個版本快速迭代的年輕開源專案。 本手冊查證當下版本為 1.14.2,但官方 docs/benchmarking.md 中引用的最近一次公開 Benchmark(2026-07-31)測試的是 pdf-inspector 0.2.6——這代表短短兩週內版本號已從 0.2.x 跳到 1.14.x,變動速度非常快。任何指令、函式簽名、Benchmark 數字、目錄結構,在正式導入前務必以你實際安裝版本的官方 README.md、各語言 binding 文件與 Release/Changelog 為準,不要假設本手冊記載的數字在你閱讀時仍然成立。 版本跳躍原因(Source-confirmed,2026-08-16 補充查證 GitHub Releases 頁面):這不是「兩週內發布了上千次迭代」,而是版本號機制本身發生了變更。查證到的 packages-2026-08-10 彙總發布中,四種 binding 當時仍各自使用獨立版本號:Rust crate 0.1.8、Python 0.2.7、Node.js 1.13.0、WASM 0.1.4——彼此不同步。到了 v1.14.2(2026-08-13),所有 binding 已統一為同一個版本號。這與姊妹專案 anydoc 官方 Changelog 中「Bump pdf-inspector from 0.1.8 to 1.14.2」的記載互相印證(見〔anydoc 教學手冊〕第 35.3 節)。推測(Hypothesis):官方很可能是把既有版本號最高的 Node binding(1.13.x)訂為統一基準,讓四個 binding 從此以同一版本號同步發布(見第 38.1 節「單一版本號同步」發布機制);但官方一手資料並未發布逐字說明此次版本號統一的決策公告,此為合理推論而非官方逐字確認,仍建議正式導入前自行查核。 ...

August 16, 2026 · 60 min · 12737 words · Eric Cheng