Knowledge Work Plugins 教學手冊

knowledge-work-plugins 企業級教學手冊(實戰與維運) 一句話定位:anthropics/knowledge-work-plugins 是 Anthropic 開源的職能型 Plugin 集合與 Marketplace。每個 Plugin 用 Markdown(Skills)與 JSON(MCP 連線設定)把「某個職能怎麼做事、要連哪些工具」打包起來,讓 Claude Cowork 與 Claude Code 能用一致的方式完成業務、財務、法務、資料分析、工程等工作。它是很好的起點範本,但不是可以直接上線的企業系統:它不懂你的公司 SOP、不連你的內部系統、也不會自動符合金融業的權限與稽核要求——這些都要企業自己補上,本手冊就是教你怎麼補。 適用對象:資深工程師、AI 平台工程師、架構師、資安與治理人員、維運人員;各部門 AI 推動負責人與 PM 可依「閱讀路徑」選讀。內容偏實戰與維運,假設讀者熟悉 Git、JSON、Markdown 與命令列。 版本基準: 項目 內容 研究對象 GitHub anthropics/knowledge-work-plugins,main 分支 commit d900840(2026-11-04 02:50 UTC),Apache-2.0 授權 Release 沒有 GitHub Release 與 tag;版本只能看各 Plugin plugin.json 的 version 與 commit(見 13.2) 實際內容 Marketplace 共 123 個 Plugin:17 個 Anthropic 第一方(repo 內目錄)+ 5 個合作夥伴內嵌於 partner-built/ + 101 個外部來源(以 url 或 git-subdir 指向第三方 repo,並固定 commit sha)(見 4.1) 與 README 的落差 官方 README 仍寫「open-sourcing 11 plugins」,並示範 /finance:reconciliation 等指令;實際已有 17 個第一方 Plugin,且多數 commands/ 已改為 skills/(見 3.1、4.1) Claude Code 撰寫環境 v2.1.318;本手冊引用的功能都註明最低版本需求(例如 claude plugin validate 的 MCP 檢查需 v2.1.281+) MCP 規格 最新穩定版 2026-07-28(前一版 2025-11-25);範例 MCP Server 使用 npm @modelcontextprotocol/sdk 1.32.2 研究基準日期 2026-11-04(所有「查證日期」未另註明者,皆為此日) 實測狀態 見下方「圖示說明」。手冊內附的企業 Marketplace、company-software-engineering Plugin、corp-change-sop Plugin 已以 claude plugin validate --strict 驗證通過;PreToolUse 守門 Hook 20 個案例、MCP Server smoke test 11 項、plugin-preflight.py 三組資料皆已實測 ✅。Claude Cowork 端操作、組織管理後台、MCP tunnels、Compliance API、實際連線第三方 SaaS Connector 未實測(需要 Team/Enterprise 組織與各 SaaS 帳號),依 claude.com/support.claude.com/platform.claude.com 官方文件整理,標 📖 撰寫環境 Windows 11 Pro 10.0.26300、Node.js 24.16.0、Python 3.12、Git for Windows 手冊版本 1.1(2026-11-04;1.0 初版同日發布,1.1 補 Cowork/claude.ai 管理控制、MCP tunnels 與各章範例,版本紀錄見附錄 D) 文件性質:企業內部教育訓練與開發規範。內容為重新整理、分析與教學化撰寫,不是官方文件翻譯。範例中的主機名稱、帳號、Token、系統與資料全部虛構(使用 corp.example、example.com 等保留網域)。 ...

November 4, 2026 · 146 min · 31088 words · Eric Cheng

PentAGI 教學手冊

PentAGI 企業級教學手冊(實戰與維運) 一句話定位:PentAGI 是一套自我託管(self-hosted)的多 Agent AI 滲透測試平台。它用 LLM 規劃測試步驟,在 Docker 容器裡呼叫 nmap、sqlmap 等安全工具執行,並把過程、結果與記憶存進 PostgreSQL/pgvector。它能加速授權範圍內的安全驗證,但不會自動讓你的系統安全,也不能取代資安人員、SAST/DAST/SCA 與正式安全驗收。 適用對象:資深工程師、架構師、DevSecOps、資安測試人員、平台維運人員。SA、PM 可依「閱讀路徑」選讀。內容偏實戰與維運,假設讀者熟悉 Linux、Docker、Git 與至少一種 AI Coding 工具(Claude Code、GitHub Copilot、Codex 等)。 版本基準: 項目 內容 PentAGI 版本 v2.2.0(GitHub Release,2026-10-05 發布);本手冊所有原始碼與設定核對都以 tag v2.2.0 為準 main 追蹤 研究日 main 為 cffed94(2026-10-22),領先 v2.2.0 共 3 個 commit,全部是 README 文件修改,沒有程式或設定變更;另有多個尚未合併的安全與穩定性 PR 需追蹤(見 16.2、16.2.1) 前一版 v2.1.0(2026-05-29)、v2.0.0(2026-04-11);v2.1.0 以前受 CVE-2026-14784 影響(見 6.4) 授權 原始碼 MIT;另有 EULA(僅限合法滲透測試用途、可撤銷)與 NOTICE(VXControl Cloud SDK 授權說明);官方另販售 Enterprise Edition 授權。不能只看 GitHub 的 MIT 標籤(見 20.8) 原始碼核對範圍 README.md、.env.example、docker-compose*.yml、EULA.md、NOTICE、backend/docs/{docker,config,database}.md、examples/guides/{worker_node,installation_configuration}.md、examples/prompts/*、backend/pkg/config/config.go、backend/pkg/docker/{client,sandbox}.go、Release notes v2.0.0~v2.2.0 研究基準日期 2026-10-29(1.1 版於同日重新查核上游 Release、main、Docker Hub digest、NVD 與 open issue/PR) 實測狀態 未在實機安裝 PentAGI(需要真實 LLM API Key、Docker 主機,且平台本身會主動發起攻擊行為)。所有 PentAGI 指令都對照 v2.2.0 官方文件與原始碼,標 📖;需要實際環境才能確認的內容標 🧪 並附驗證步驟。手冊內附的 3 支企業自訂審查工具(.env 安全檢查、任務範圍檢查、弱點報告檢查)與第 18 章的稽核 SQL 已在撰寫環境以合成資料實測,標 ✅ 撰寫環境 Windows 11 Pro 10.0.26300、Python 3.12.8(僅用於撰寫與驗證審查工具,只用標準函式庫);PostgreSQL 16(Podman 暫時容器,只用於驗證第 18 章 SQL) 手冊版本 1.1(2026-10-29;補齊第 18 章、加入上游已知問題與待合併修補;版本紀錄見 21.12) 文件性質:企業內部教育訓練與開發規範。內容為重新整理、分析與教學化撰寫,不是官方文件翻譯。範例中的主機名稱、帳號、Token、IP、系統與資料全部虛構(使用 example.com、corp.example、10.x、192.0.2.x 等保留或私有範圍)。 ...

October 29, 2026 · 114 min · 24088 words · Eric Cheng

NemoClaw 教學手冊

NemoClaw 企業級 AI Agent 沙盒參考堆疊教學手冊(實戰與維運) 一句話定位:NVIDIA NemoClaw 是一套「把受支援的 AI Agent 裝進 NVIDIA OpenShell 沙盒」的開源參考技術堆疊。它提供引導式安裝(onboarding)、版本化 Blueprint、託管推理路由、網路政策 preset、狀態保存與生命週期指令;真正執行隔離、攔截網路、保管憑證的是底下的 OpenShell。NemoClaw 讓你「少做整合工作」,不會讓 Agent「自動變安全」。 適用對象:資深工程師、架構師、DevOps/DevSecOps、資安與維運人員、AI 平台管理者。PM、SA、SD 可依「閱讀路徑」選讀。內容偏實戰與維運,假設讀者熟悉 Linux、Docker、Git,以及至少一種 AI Coding 工具。 版本基準: 項目 內容 NemoClaw 版本 v0.0.139(tag commit a08ae7a,2026-10-26);官方文件站 latest 已對應此版 安裝程式預設版本 官方安裝程式預設追蹤 lkg(last known good)標籤,研究當日指向 v0.0.137(f00fb1d,2026-10-21);要用 v0.0.139 必須明確指定 NEMOCLAW_INSTALL_TAG=v0.0.139(第 4 章) 搭配的 OpenShell 0.0.116(Blueprint 的 min_openshell_version 與 max_openshell_version 都是 0.0.116;@nvidia/openshell-sdk 也釘 0.0.116) 支援的 Agent OpenClaw(預設)、Hermes、LangChain Deep Agents Code(dcode 0.1.71);三者在官方平台矩陣皆為 Tested,但 Hermes 官方註明「尚未宣稱與 OpenClaw 的正式環境同等」 專案階段 alpha/Early preview(官方平台矩陣:自 2026-03-16 起),維護者以 best effort 回應、無 SLA 原始碼核對 NVIDIA/NemoClaw tag v0.0.139:docs/(官方文件原始檔)、install.sh、scripts/install-openshell.sh、nemoclaw-blueprint/(Blueprint 與政策)、agents/*/(各 Agent 的 manifest 與政策)、src/lib/(CLI 實作) 研究基準日期 2026-10-27;main 追蹤至 bafe6cc(2026-10-26,領先 v0.0.139 共 18 個 commit);另有 Rust 重寫的 v1 分支(見 1.7)。1.1 版於同日再核對:沒有新 tag,lkg 仍指向 v0.0.137,main 仍為 bafe6cc(18.11) 實測狀態 未在實機安裝 NemoClaw 或 OpenShell。所有 NemoClaw/OpenShell 指令都對照 v0.0.139 官方文件與原始碼,標 📖;需要實際環境才能確認的內容標 🧪 並附驗證步驟。手冊內附的 5 支企業自訂審查工具(政策 lint、交付報告比對、架構依賴檢查、逆向工程引用檢查、測試弱化檢查)、安全公告版本下限腳本與 ArchUnit 範例,已在撰寫環境以合成資料實測,標 ✅ 撰寫環境 Windows 11 Pro 10.0.26300、Python 3.12.8、PyYAML 6.0.3、OpenJDK 21.0.4、Maven 3.9.9、Node.js 24.16.0(僅用於撰寫與驗證審查工具) 手冊版本 1.1(2026-10-27;1.0 於同日初版;版本紀錄見 18.13) 文件性質:企業內部教育訓練與開發規範。內容為重新整理、分析與教學化撰寫,不是官方文件翻譯。範例中的主機名稱、帳號、Token、IP、專案與客戶資料均為虛構(使用 example.com、corp.example、10.x 等保留或私有範圍)。 ...

October 27, 2026 · 117 min · 24890 words · Eric Cheng

專案裁剪紀錄範本(Tailoring Record Template)

專案裁剪紀錄範本(Tailoring Record) 參照標準:ISO/IEC/IEEE 12207:2026(流程裁剪)/ CMMI V3.0(組織標準流程裁剪) 文件用途:依專案的規模與風險,記錄哪些標準活動與文件被簡化、理由與核准者 適用階段:專案啟動時(G1 之前);專案範圍或風險變更時更新 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 2.5 節 📋 章節目錄 專案基本資訊 風險分級判定 裁剪項目 核准與複核 審查與驗證 1. 專案基本資訊 📝 範本 項目 內容 專案名稱/代號 {名稱}({代號}) 系統說明 {一句話描述} 使用者範圍 {內部/外部;人數} 處理的資料 {是否含個資、金流、機密} 預估規模 {人月、期程} 📖 使用說明 這些資訊是判定風險等級的依據,必須據實填寫 「處理的資料」需參照《資料分級對照表範本》 💡 範例 項目 內容 專案名稱/代號 會議室預約系統(ROOM-2026) 系統說明 員工預約會議室並同步 Outlook 行事曆 使用者範圍 內部員工約 180 人 處理的資料 員工姓名、Email(機密);無金流 預估規模 3 人月、8 週 2. 風險分級判定 📝 範本 判斷條件 是否符合 說明 處理金流、極機密個資或機密資料 {是/否} 對外公開服務 {是/否} 受法規要求(資通安全管理法、金融監理等) {是/否} 停機造成重大營運損失 {是/否} 與 L1 系統介接或影響多部門 {是/否} 判定等級 {L1 高/L2 中/L3 低} {符合任一 L1 條件即為 L1} 📖 使用說明 符合任一 L1 條件即為 L1;無 L1 條件但符合 L2 條件為 L2;其餘為 L3 等級判定必須寫出理由,不得為了減少文件而刻意降級 💡 範例 判斷條件 是否符合 說明 處理金流、極機密個資或機密資料 否 僅姓名與 Email,屬機密但無極機密 對外公開服務 否 僅內網 受法規要求 否 停機造成重大營運損失 否 可改用紙本登記 與 L1 系統介接或影響多部門 否 僅讀取 AD 判定等級 L3 低 無 L1/L2 條件 3. 裁剪項目 📝 範本 活動/文件 標準要求(依等級) 本專案作法 理由 補償措施 {活動} {必須/應/得} {作法} {理由} {如有} 📖 使用說明 只列與標準不同的項目;標準要求「必須」的項目不得裁剪,除非經架構審查委員會核准並寫明補償措施 安全掃描(SAST/SCA/Secrets)在所有等級都是「必須」,不得裁剪 💡 範例 活動/文件 標準要求(L3) 本專案作法 理由 補償措施 SAD/SDD 得以 README + ADR 代替 README + 3 份 ADR 單體應用,架構單純 — 威脅模型 應(檢核表即可) 使用安全檢核表 內網、資料敏感度低 — 效能測試 得 不執行 使用者 < 200 人,尖峰 < 5 TPS 上線後監控 p95 UAT 應 PO 驗收 + Demo 錄影 使用者為內部同仁 — 4. 核准與複核 📝 範本 角色 姓名 日期 意見 專案經理 {姓名} {日期} 架構審查委員會 {姓名} {日期} 資安代表(L1/L2 必填) {姓名} {日期} 複核時機 是否需要重新判定 新增對外服務、金流或極機密資料 必須 使用者規模成長 10 倍以上 應 📖 使用說明 核准者必須有權限(例如架構審查委員會成員),PM 不得自行核准 範圍變更時重新判定,並保留歷次版本 💡 範例 角色 姓名 日期 意見 專案經理 陳大文 2026-09-28 架構審查委員會 王大明 2026-10-01 同意,上線後若開放外部訪客預約需重新判定 5. 審查與驗證 本節供審查者使用,也用來檢查 AI 依本範本產出的裁剪紀錄是否正確。 ...

October 6, 2026 · 2 min · 270 words · Eric Cheng

架構決策紀錄範本(ADR, Architecture Decision Record Template)

架構決策紀錄範本(Architecture Decision Record, ADR) 參照標準:MADR 4.0.0(Markdown Architectural Decision Records)/ ISO/IEC/IEEE 42010:2022 文件用途:記錄一個重要技術決策的背景、考慮過的選項、取捨與後果 適用階段:系統設計階段(Design Phase)起,貫穿整個生命週期 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 4.6 節 📋 章節目錄 何時必須寫 ADR 檔案命名與存放 ADR 主體(MADR 格式) 狀態與生命週期 審查與驗證 1. 何時必須寫 ADR 📝 範本 情境 是否必須寫 ADR 本案判定 選用或更換框架、資料庫、訊息系統 必須 {是/否} 改變系統間的整合方式(同步改非同步、新增閘道) 必須 {是/否} 偏離公司標準或《軟體開發標準程序教學手冊》 必須 {是/否} 難以反悔(回頭成本高)的決策 必須 {是/否} 只影響單一類別的實作細節 不需要 {是/否} 📖 使用說明 ADR 是「決策的快照」,回答半年後有人問「為什麼當初這樣做?」 判斷原則:如果這個決策錯了,修正成本是否超過一個 Sprint?是 → 寫 ADR ADR 要短(一到兩頁),長篇設計放在 SDD,ADR 只記錄決策本身 💡 範例 情境 是否必須寫 ADR 本案判定 請假事件通知由同步 REST 改為 Kafka 事件 必須 是 → ADR-0007 請假服務的 DTO 改用 Java record 不需要 否(屬《程式寫作指引》範圍) 2. 檔案命名與存放 📝 範本 docs/decisions/ ├── 0001-{決策標題-kebab-case}.md ├── 0002-{決策標題}.md └── README.md # ADR 索引:編號、標題、狀態、日期 📖 使用說明 ADR 與程式碼放在同一個 Repository,走同一個 PR 審查流程(Docs-as-Code) 編號遞增、不重用;標題用動詞開頭描述決策(例:「採用 Kafka 作為訂單事件骨幹」) 索引檔讓新人快速找到所有決策 💡 範例 docs/decisions/ ├── 0001-use-postgresql-as-primary-database.md ├── 0006-adopt-rfc9457-problem-details.md ├── 0007-use-kafka-for-leave-events.md └── README.md 3. ADR 主體(MADR 格式) 📝 範本 --- status: {proposed | accepted | rejected | deprecated | superseded by NNNN} date: {YYYY-MM-DD} decision-makers: {決策者姓名與角色} consulted: {諮詢對象} informed: {知會對象} --- # {NNNN} {決策標題} ## Context and Problem Statement {兩到三句描述背景與要解決的問題;可附事件編號、數據} ## Decision Drivers * {驅動因素 1,例:下游故障不得影響主流程} * {驅動因素 2,例:尖峰 N 筆/秒} ## Considered Options * {選項 1} * {選項 2} * {選項 3(含「維持現狀」)} ## Decision Outcome 選擇「{選項}」,因為 {對照 Decision Drivers 說明理由}。 ### Consequences * Good:{正面影響} * Bad:{負面影響與需要處理的新問題} ### Confirmation {如何確認決策被正確實作,例:整合測試、ArchUnit 規則、上線後監控指標} ## Pros and Cons of the Options ### {選項 2} * Good:{優點} * Bad:{缺點} 📖 使用說明 必填段落:Context、Considered Options(至少兩個,含「維持現狀」)、Decision Outcome、Consequences Bad 後果必須寫:沒有缺點的決策通常代表分析不完整 Confirmation 段落讓決策可驗證,例如用 ArchUnit 測試確保「訂單服務不得直接呼叫點數服務」 引用的效能數據、事件編號需可查證 💡 範例 --- status: accepted date: 2026-09-20 decision-makers: 架構師 林志明、Tech Lead 陳大文 consulted: DBA 王小美、資安 李小華 informed: HRMS 開發團隊 --- # 0007 請假事件改用 Kafka 通知下游 ## Context and Problem Statement 請假核准後需通知薪資、出勤、Email 三個服務。目前以同步 REST 呼叫, 2026 Q3 薪資服務維護期間造成請假核准失敗 3 次(INC-20260712-002)。 ## Decision Drivers * 下游服務故障不得影響請假核准 * 事件需可重播 7 天,以便薪資重算 * 維運團隊已有 Kafka 叢集與維運經驗 ## Considered Options * Apache Kafka * RabbitMQ * 維持同步 REST + 重試 ## Decision Outcome 選擇 Apache Kafka,因為它是唯一同時滿足「下游故障不影響核准」與「事件可重播 7 天」的選項,且不需新增維運技能。 ### Consequences * Good:下游故障不再影響核准;新服務可自行訂閱事件 * Bad:事件可能重複投遞,消費端必須冪等;需監控 consumer lag ### Confirmation 整合測試驗證「薪資服務停止時仍可核准請假」;上線後監控 consumer lag < 1,000。 ## Pros and Cons of the Options ### RabbitMQ * Good:團隊熟悉 AMQP 路由 * Bad:訊息消費後即刪除,不支援 7 天重播 ### 維持同步 REST + 重試 * Good:不需新元件 * Bad:重試會延長核准回應時間,且下游長時間故障時仍會失敗 4. 狀態與生命週期 📝 範本 stateDiagram-v2 [*] --> proposed: 提出 proposed --> accepted: 審查通過 proposed --> rejected: 審查否決 accepted --> deprecated: 不再適用 accepted --> superseded: 被新 ADR 取代 rejected --> [*] deprecated --> [*] superseded --> [*] 📖 使用說明 ADR 一經 accepted 就不修改內容(錯字除外);決策改變時新增一份 ADR,舊 ADR 的 status 改為 superseded by NNNN rejected 的 ADR 也要保留,避免同樣的提案反覆討論 💡 範例 編號 標題 狀態 日期 0003 請假通知使用同步 REST superseded by 0007 2025-11-02 0007 請假事件改用 Kafka 通知下游 accepted 2026-09-20 5. 審查與驗證 本節供審查者使用,也用來檢查 AI 依本範本產出的 ADR 是否正確。 ...

October 6, 2026 · 3 min · 492 words · Eric Cheng

資料分級對照表範本(Data Classification Template)

資料分級對照表範本(Data Classification) 參照標準:OWASP ASVS 5.0.0 V14(Data Protection)/ ISO/IEC 27001:2022 A.5.12(資訊分類)/ 個人資料保護法 文件用途:為每個資料欄位標註分級,作為加密、遮罩、日誌、測試資料與保存期限的唯一依據 適用階段:系統設計階段(Design Phase);Schema 變更時同步更新 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 4.4、6.3、9.3 節 📋 章節目錄 分級定義 各級保護要求 欄位分級對照表 保存與銷毀 審查與驗證 1. 分級定義 📝 範本 等級 定義 外洩影響 典型資料 公開 {可對外公開} {無} {產品型錄} 內部 {限公司內部} {輕微} {組織架構} 機密 {限特定角色} {重大:個資、營業秘密} {姓名、Email、薪資} 極機密 {限極少數人,需加密} {嚴重:可直接造成詐騙或法律責任} {身分證字號、銀行帳號、密碼雜湊} 📖 使用說明 分級由資料擁有者(業務單位)核定,IT 負責實作保護 同時屬於多種類別時取最高等級 對應 ASVS 5.0 14.1.1(敏感資料識別與分級) 💡 範例 等級 定義 外洩影響 典型資料 公開 可公開於官網 無 公司地址、職缺 內部 全體員工可見 輕微 部門名稱、分機 機密 限本人、主管與 HR 重大(個資) 姓名、Email、手機、請假紀錄、薪資 極機密 限 HR 薪資組,需加密 嚴重 身分證字號、銀行帳號 2. 各級保護要求 📝 範本 要求 公開 內部 機密 極機密 儲存加密 {} {} {} {} 傳輸加密 {} {} {} {} 畫面顯示 {} {} {} {} 日誌 {} {} {} {} 測試環境 {} {} {} {} 存取紀錄 {} {} {} {} 📖 使用說明 對應 ASVS 5.0 14.1.2:每個等級都要有一組文件化的保護要求 這張表是開發、測試、維運共同的規格:AI 或開發者產生程式時,可直接依此判斷要不要遮罩、能不能寫日誌 💡 範例 要求 公開 內部 機密 極機密 儲存加密 不需 不需 資料庫 TDE TDE + 欄位加密(AES-256-GCM,金鑰存 KMS) 傳輸加密 TLS 1.2+ TLS 1.2+ TLS 1.2+ TLS 1.2+,內部服務間 mTLS 畫面顯示 完整 完整 依權限完整或遮罩 預設遮罩,需「顯示」權限並留紀錄 日誌 可記錄 可記錄 遮罩後記錄 禁止記錄 測試環境 可沿用 可沿用 以假資料替換 以假資料替換 存取紀錄 不需 不需 匯出時記錄 每次讀取都記錄 3. 欄位分級對照表 📝 範本 資料表.欄位 分級 個資類別 儲存 畫面顯示 日誌 測試環境 保存期限 {TABLE.COLUMN} {等級} {是/否:類別} {明文/加密} {遮罩規則} {禁止/遮罩/可} {替換/沿用} {期限與法源} 📖 使用說明 每個欄位都要列,包含「看起來不敏感」的欄位(例如備註欄常被填入個資) 遮罩規則寫成具體格式(例:A12****789),方便直接轉成測試案例 Schema 新增欄位時,PR 必須同時更新本表(Reviewer 檢查) 💡 範例 資料表.欄位 分級 個資類別 儲存 畫面顯示 日誌 測試環境 保存期限 EMPLOYEE.NAME 機密 是:識別類 明文 王○明 禁止 替換 離職後 5 年 EMPLOYEE.ID_NO 極機密 是:識別類 欄位加密 A12****789 禁止 替換 離職後 5 年 EMPLOYEE.BANK_ACCOUNT 極機密 是:財務類 欄位加密 ****-****-1234 禁止 替換 離職後 5 年 EMPLOYEE.EMAIL 機密 是:聯絡類 明文 a***@company.com 遮罩 替換 離職後 2 年 LEAVE_REQUEST.REASON 機密 可能(病假事由) 明文 本人與主管可見 禁止 替換 依勞動法規 DEPARTMENT.NAME 內部 否 明文 完整 可 沿用 永久 4. 保存與銷毀 📝 範本 資料類別 保存期限 法源/依據 到期處理方式 執行方式 {類別} {期限} {法規條號/合約} {刪除/去識別化/封存} {批次程式/人工} 📖 使用說明 保存期限必須寫出法源,並由法遵單位確認 到期處理應自動化並留紀錄(ASVS 5.0 14.2.7) 💡 範例 資料類別 保存期限 法源/依據 到期處理方式 執行方式 員工個資 離職後 5 年 公司人事規章(法遵確認 2026-09) 去識別化 每月批次 BATCH-HR-PURGE-001 稽核日誌 365 天 公司資安政策 v4.0 刪除 日誌平台 ILM 政策 5. 審查與驗證 本節供審查者使用,也用來檢查 AI 依本範本產出的分級表是否正確。 ...

October 6, 2026 · 2 min · 358 words · Eric Cheng

階段閘門審查紀錄範本(Stage Gate Review Template)

階段閘門審查紀錄範本(Stage Gate Review) 參照標準:ISO/IEC/IEEE 12207:2026 / ISO/IEC/IEEE 15288:2023(決策管理流程) 文件用途:記錄每道閘門(G1 需求核准、G2 設計核准、G3 上線核准、G4 結案)的檢查結果、證據與決策 適用階段:每個階段結束時 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 2.4 節 📋 章節目錄 審查基本資訊 進入條件檢查 決策 審查與驗證 1. 審查基本資訊 📝 範本 項目 內容 專案 {名稱/代號}(風險等級:{L1/L2/L3},裁剪紀錄:{編號}) 閘門 {G1 需求核准/G2 設計核准/G3 上線核准/G4 結案} 審查日期 {YYYY-MM-DD} 核准者 {依閘門:產品負責人/架構師+資安/CAB/PM+維運主管} 出席者 {姓名與角色} 📖 使用說明 核准者依閘門而定(手冊 2.4 表格);風險 L3 專案依裁剪紀錄可合併閘門 審查前 2 個工作日將證據連結提供給核准者 💡 範例 項目 內容 專案 HRMS 請假模組 v2(風險等級:L1,裁剪紀錄:TR-HRMS-2026-02) 閘門 G3 上線核准 審查日期 2026-10-03 核准者 CAB 主席 林志明、產品負責人 王 HR 主管 出席者 PM 陳大文、QA Lead 黃小玲、DevOps 林、資安 李小華 2. 進入條件檢查 📝 範本 # 進入條件 結果 證據(連結) 1 {條件} {✅/❌/N/A(依裁剪紀錄)} {CI 紀錄、報告、簽核單} 各閘門標準條件(依手冊 2.4,可依裁剪紀錄調整): ...

October 6, 2026 · 2 min · 239 words · Eric Cheng

需求追溯矩陣範本(RTM, Requirements Traceability Matrix Template)

需求追溯矩陣範本(Requirements Traceability Matrix, RTM) 參照標準:ISO/IEC/IEEE 29148:2018(需求追溯)/ ISO/IEC/IEEE 29119-3:2021 文件用途:串起「需求 → 設計 → 實作 → 測試」,確認每條需求都被實作與驗證,且每段程式都有需求依據 適用階段:需求核准(G1)起持續維護,於設計核准(G2)與上線核准(G3)時檢查 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 3.7、2.4 節 📋 章節目錄 文件資訊 追溯矩陣 自動追溯設定 缺口與處理 審查與驗證 1. 文件資訊 📝 範本 項目 內容 文件編號 RTM-{專案代碼}-{序號} 對應需求文件 {PRD/FRD/SRD 文件編號與版本} 最後更新 {YYYY-MM-DD}(由 CI 自動產生時填寫建置編號) 負責人 {BA/QA Lead} 📖 使用說明 前向追溯:每條需求都有設計、實作、測試 → 防止遺漏 反向追溯:每段程式與測試都對應到需求 → 防止鍍金與範圍蔓延 建議以「測試程式碼中的需求編號標註」自動產生,人工維護的 Excel 很快就會過時 💡 範例 項目 內容 文件編號 RTM-HRMS-001 對應需求文件 FRD-HRMS-001 v1.3、SRD-HRMS-001 v1.1 最後更新 2026-10-05(CI build #482) 負責人 QA Lead 黃小玲 2. 追溯矩陣 📝 範本 需求編號 需求摘要 來源 優先序 設計(SDD 章節/API) 實作(模組/類別) 測試案例 測試結果 狀態 {FR-xxx} {摘要} {BRD/CR 編號} {Must/Should/Could} {SDD x.y/METHOD /path} {模組/類別} {TC-xxx} {Pass/Fail/未執行} {✅/⏳/❌} 📖 使用說明 非功能需求(NFR)通常由效能或安全測試驗證,「測試案例」欄填寫測試報告編號 需求異動(CR)時,同步更新受影響的列並記錄 CR 編號 狀態判定:設計、實作、測試三欄都有值且測試 Pass 才是 ✅ 💡 範例 需求編號 需求摘要 來源 優先序 設計 實作 測試案例 測試結果 狀態 FR-LV-001 員工提交請假申請 BRD 3.1 Must SDD 5.2/POST /api/v1/leaves leave-service/LeaveService TC-LV-001-01~04 Pass ✅ FR-LV-002 特休額度不足時拒絕申請 BRD 3.1 Must SDD 5.2/422 Problem Details LeaveQuotaPolicy TC-LV-002-01~02 Pass ✅ FR-LV-005 主管代理人設定 CR-2026-011 Should SDD 5.4 DelegateService TC-LV-005-01 未執行 ⏳ NFR-PERF-001 請假查詢 p95 < 500 ms(200 TPS) SRD 4.1 Must SDD 8.1 快取 LeaveQueryService PT-RPT-2026-03(k6) Fail(620 ms) ❌ 3. 自動追溯設定 📝 範本 // 在自動化測試上標註需求編號(JUnit 5 以上) @Tag("{需求編號}") @DisplayName("{測試案例編號} {情境描述}") @Test void {測試方法名稱}() { /* ... */ } # 前向追溯缺口:需求清單中有、但測試程式碼中找不到的需求編號 grep -ohE "^\| (FR|NFR)-[A-Z]+-[0-9]{3}" docs/requirements/rtm.md | tr -d '| ' | sort -u > req.txt grep -rohE "@Tag\(\"(FR|NFR)-[A-Z]+-[0-9]{3}\"\)" src/test | grep -oE "(FR|NFR)-[A-Z]+-[0-9]{3}" | sort -u > tested.txt comm -23 req.txt tested.txt # 有輸出 → 有需求沒有自動化測試 comm -13 req.txt tested.txt # 有輸出 → 有測試沒有對應需求(反向追溯缺口) 📖 使用說明 正規表示式需配合專案的需求編號格式調整 由效能或安全測試驗證的 NFR 不會有 @Tag,應在比對前從 req.txt 排除,或改以測試報告編號人工確認 建議在 CI 中執行,前向缺口數量做為 G2/G3 閘門的檢查項目 💡 範例 @Tag("FR-LV-002") @DisplayName("TC-LV-002-01 特休剩餘 2 天時申請 3 天,回傳 422") @Test void shouldRejectWhenAnnualLeaveQuotaInsufficient() { /* ... */ } 4. 缺口與處理 📝 範本 缺口類型 需求/測試編號 原因 處理方式 負責人 期限 {前向/反向} {編號} {原因} {補測試/補需求/刪除程式} {姓名} {日期} 📖 使用說明 反向缺口(有程式沒需求)可能是鍍金,也可能是需求文件漏寫,需由 PO 判斷 缺口未處理完畢不得通過 G3 上線閘門(風險 L1 專案) 💡 範例 缺口類型 需求/測試編號 原因 處理方式 負責人 期限 前向 FR-LV-005 測試環境尚未建立代理人資料 補測試資料後執行 TC-LV-005-01 QA 陳 2026-10-08 反向 @Tag("FR-LV-099") 開發自行新增「批次匯出」功能,無需求 PO 決定移除功能 Tech Lead 王 2026-10-09 5. 審查與驗證 本節供審查者使用,也用來檢查 AI 依本範本產出的 RTM 是否正確。 ...

October 6, 2026 · 2 min · 385 words · Eric Cheng

風險接受單範本(Risk Acceptance Template)

風險接受單範本(Risk Acceptance) 參照標準:ISO/IEC 27005:2022(風險處理)/ ISO/IEC 27001:2022 6.1.3 / CVSS v4.0、EPSS、CISA KEV 文件用途:記錄無法在修補時限內處理的弱點或安全例外:為什麼接受、用什麼補償控制、誰核准、何時重新評估 適用階段:測試驗證、上線核准(G3)、維運階段 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 9.2 節 📋 章節目錄 風險描述 評估與補償控制 核准與期限 審查與驗證 1. 風險描述 📝 範本 欄位 內容 單號 RA-{YYYY}-{序號} 弱點/例外 {CVE 編號或弱點描述}(CVSS {版本}:{分數};EPSS {值}(查詢日);KEV:{是/否}) 影響系統/版本 {系統與版本} 無法如期處理的原因 {上游無修補版本/需大幅改版/業務限制} 📖 使用說明 列於 CISA KEV 的弱點原則上不得接受風險,必須在 24 小時內緩解 原因必須具體,「時間不夠」不是可接受的原因 💡 範例 欄位 內容 單號 RA-2026-07 弱點/例外 CVE-2026-12345(commons-foo 2.3.1;CVSS v4.0:7.5 High;EPSS 0.004(2026-10-01);KEV:否) 影響系統/版本 HRMS customer-service v2.4.0 無法如期處理的原因 上游尚未發布修補版本 2. 評估與補償控制 📝 範本 欄位 內容 可達性分析 {有弱點的函式是否被呼叫;分析方法與依據} 殘餘風險 {採取補償控制後的風險描述與等級} 補償控制 {WAF 規則、關閉功能(Feature Flag)、網路隔離、監控告警} 補償控制驗證 {如何確認補償控制有效} 📖 使用說明 補償控制要能驗證:例如以攻擊樣本測試 WAF 規則確實攔截 可達性分析需附依據(程式碼搜尋結果、呼叫圖),供複核 💡 範例 欄位 內容 可達性分析 Foo#parseXml 僅於管理後台匯入功能使用(grep -rn "parseXml" src/ 共 1 處) 殘餘風險 低:功能已關閉且限內網 ADMIN 權限 補償控制 1. 匯入功能以 Feature Flag admin-xml-import 關閉;2. WAF 加入 XXE 特徵規則 補償控制驗證 以 XXE 測試樣本呼叫匯入 API → WAF 回 403;Flag 狀態於 Flag 平台確認為 off 3. 核准與期限 📝 範本 欄位 內容 接受期限 {YYYY-MM-DD}(最長 {N} 個月) 到期處理 {重新評估/修補/延長需重新核准} 核准者 {資安主管、系統擁有者},{日期} 📖 使用說明 風險接受必須有期限;到期未處理視同違規 核准者至少包含資安主管與系統擁有者,PM 或開發者不得自行核准 💡 範例 欄位 內容 接受期限 2026-11-30 到期處理 上游若已發布修補版本則升級;否則重新評估並重新核准 核准者 資安主管 李小華、系統擁有者 陳大文,2026-10-02 4. 審查與驗證 本節供審查者使用,也用來檢查 AI 依本範本產出的風險接受單是否正確。 ...

October 6, 2026 · 1 min · 211 words · Eric Cheng

security-audit-skill 企業級軟體開發與 AI Agent 安全稽核教學手冊

版本:v1.1(2026-09-29;v1.0 → v1.1 變更見附錄 C) 文件性質:企業技術白皮書/內部教育訓練教材 適用對象:PM、SA、軟體架構師、前後端工程師、QA、Application Security Engineer、DevSecOps Engineer、AI Agent 架構師、Legacy Modernization/Framework Upgrade 團隊 內容定位:本手冊以 Cloudflare 開源專案 security-audit-skill(github.com/cloudflare/security-audit-skill)為核心,說明它的設計理念、六階段稽核流程、Coverage Ledger、候選漏洞驗證、結構化 Findings 與獨立複核機制,並延伸到企業 AI-assisted SDLC/SSDLC、CI/CD、Legacy 逆向工程、Framework Upgrade 與金融業導入實務。 查證基準:官方內容以 2026-09-29 查閱的 main 分支為準(最新 commit:c1c8a8c,2026-09-14「Clarify guidance and full audit modes」;main 共 14 個 commit,約 22.8k stars)。查閱當下官方沒有發布 Release/Tag,因此本手冊無法引用「版本號」,只能引用 commit。Repository 更新頻繁(2026-09-10 曾「Rework the audit workflow, findings contract, and validators end to end」),實際導入前請務必重新比對官方最新內容。 重要聲明:本手冊不是官方文件的逐字翻譯,而是理解後重新組織的教學內容。凡標記 [Official] 者,已逐項對照官方 README.md、SKILL.md、RECONNAISSANCE.md、HUNTING.md、ATTACK-CLASSES.md、VALIDATION-AND-REPORTING.md、10 個 Companion 檔、report-schema.json 與兩支 validator 原始碼;標記 [Official — Cloudflare Blog] 者引用自 Cloudflare 官方部落格,描述的是 Cloudflare 內部系統或商業服務,不是 skill 本身的功能;標記 [Industry Practice] 者為一般資安/軟體工程最佳實務;標記 [Enterprise Recommendation] 者為本手冊針對企業情境提出的建議,不代表 Cloudflare 官方功能。 安全範圍:本手冊只用於「經授權」的軟體開發、Code Review、Security Audit 與安全改善。範例皆為虛構,不提供任何可直接攻擊真實系統的 payload 或操作步驟。 授權:內部教育訓練使用 ...

September 29, 2026 · 86 min · 18151 words · Eric Cheng