把 CLI Agent 接進安全的團隊流程
「怎麼安全連接外部工具、CI 與團隊流程?」
完成後你能:用最小權限、人工檢查與紀錄完成整合。
📌 學習目標
- 只把一個安全範圍交給 MCP server。
- 讓 CI 在 PR 自動產生一份可檢查的建議。
- 用 Observability 看懂一次執行留下的 usage、時間與結果。
- 把 A2 的 Skill 交給隊友,並讓對方安全地重跑。
進入條件
完成 A2 的規則卡與 review Skill,並讀完 Stage 5 的 Track A 核心 5.1–5.4。這一站只做一件事:讓 CLI agent 在測試用 PR 做一個只讀檢查 — 它可以提出意見,但不能自己合併、部署或取得多餘權限。
🧭 本站課程
按建議順序讀;勾選結果與 /learn 課程頁共用同一份瀏覽器進度。- 01我的資料安全嗎:用 AI 的時候,到底有什麼離開了你的電腦
「安全嗎」這個問題問得太粗,所以永遠得不到有用的答案。這篇把它拆開:用雲端工具時實際離開你機器的四類東西、本地工具為什麼不一樣、「我們不用你的資料訓練」這句話承諾了什麼與沒承諾什麼,以及三條你真的能執行的規則。不含法律意見。
11 分鐘 - 02企業資料安全基本盤:哪些資料不能餵給 AI
員工把客戶個資貼進免費 AI 工具,是企業最常見也最難防的資料外洩路徑。這篇給你一套四分法的資料分級標準、一份「絕對不能上傳」的紅線清單、企業版與消費版的條款差異對照,以及本地部署選項和該問 IT 與法務的問題清單。
8 分鐘 - 03AI 合規與風險邊界:企業導入的法務檢查表
AI 導入前的法務功課,不是「找一條法規來遵守」,而是把風險面向盤點清楚、問對問題、要對文件。這篇給你五個風險面向的盤點框架、一份可以直接帶進法務會議的問題清單、供應商文件索要對照表,以及內部制度要補的項目與分場景管理方法。
18 分鐘 - 04API 文檔同步更新系統:從人工維護到代碼驅動的文檔自動化
API 改了但文檔沒跟,前端同事靠猜參數、測試環境反覆試錯。這篇用 Apidog、Fern、Mintlify 與 LLM 節點串出一條文檔同步流水線:從程式碼提取介面定義、自動生成示例、檢測不一致並告警,讓文檔永遠與實作保持一致。
17 分鐘 - 05自動化代碼審查助手:從人工逐行檢查到 AI 輔助的品質守門員
代碼審查耗時、容易漏掉邊界情況、新人難以掌握團隊規範。這篇用 GitHub Copilot、CodeRabbit、SonarQube 與 LLM 節點串出一條自動化審查流水線:靜態分析、安全掃描、風格檢查、語義理解與風險分級,讓資深工程師只處理高風險變更,把重複性工作交給機器。
17 分鐘 - 06組織 AI 能力建設:從個人英雄到可複製流程
公司裡有幾個人很會用 AI,不等於組織有 AI 能力。這篇講怎麼把個人經驗變成組織資產:能力盤點、種子用戶與三階段推廣路徑、把個人提示詞沉澱成技能庫與模板庫、分層訓練與文件化,以及衡量是否真正落地的構面與常見失敗模式。
20 分鐘
⚠️ 寫第一個 Agent 前的五條底線
- 1.MCP 只拿到 demo 資料夾或最小 read-only toolset。
- 2.PR workflow 只提出意見:沒有 auto-merge、push 或 deploy。
- 3.secrets 不放在 repo、prompt 或 log;workflow 使用最小權限。
- 4.目錄只幫你「找到候選項」,不替候選項保證安全 — 安裝任何 MCP、Action、Skill 或 plugin 前,都要再看 source、權限、最近維護狀態與移除方法。
🎯 精選資源
| 資源 | 適合誰 | 推薦度 | 為什麼推薦 |
|---|---|---|---|
CI 整合 anthropics/claude-code-action | 要 GitHub PR 自動 review | ⭐⭐⭐⭐⭐ | 官方 GitHub Action;先讀安全設定再開權限。 |
CI 整合 openai/codex-action | Codex 路線的 CI review | ⭐⭐⭐⭐ | 與 claude-code-action 同場比較,確認 approval 邊界。 |
CI 整合 GitHub Actions — Security hardening | 寫任何 workflow 之前 | ⭐⭐⭐⭐⭐ | 最小權限、secrets 與 unpinned input 的官方防護指南。 |
MCP modelcontextprotocol/servers | 挑第一個 MCP server | ⭐⭐⭐⭐⭐ | 官方參考 servers;接上前逐項審查權限。 |
MCP MCP — Security best practices | 要 expose 或接入 MCP | ⭐⭐⭐⭐⭐ | 協定層的安全建議與本地 server 連接方式。 |
MCP github/github-mcp-server | 要讓 agent 讀 GitHub | ⭐⭐⭐⭐ | GitHub 官方 MCP server;先開唯讀 toolset。 |
觀測 langfuse/langfuse | 要看 usage 與 trace | ⭐⭐⭐⭐ | 自架觀測平台;注意資料治理。 |
觀測 Helicone/helicone | 要輕量 usage 記錄 | ⭐⭐⭐⭐ | 代理層記錄 usage 與成本,幾行程式碼接入。 |
觀測 Arize-ai/phoenix | 要本機分析 trace | ⭐⭐⭐⭐ | OpenTelemetry 相容;先設計敏感資料遮罩。 |
分享 obra/superpowers-marketplace | 要把 Skill 分享給隊友 | ⭐⭐⭐⭐ | 學只負責策展、plugin 放外部 repo 的最小 marketplace。 |
🛠 動手練習(官方版)
完整練習與 starter code練習摘要取自上游教材;完整程式碼、成本與延遲估算見官方版。
- 練習 1:接一個 MCP server — 只交給它 demo 資料夾或唯讀工具;官方沒有需要的 server 時才考慮自寫。
- 練習 2:CI 只讀 review — 在測試用 PR 上讓 GitHub Action 跑一次只讀檢查並留言建議。
- 練習 3:Observability 紀錄 — 記下 provider、model、usage、時間與結果;拿不到的資料不亂猜。
- 練習 4:交接 Skill — 隊友在乾淨 demo repo 執行你的 Skill,之後 git status 沒有非預期修改。
✅ 自我檢查
- MCP 只拿到 demo 資料夾或最小 read-only toolset。
- PR workflow 只提出意見,沒有 auto-merge、push 或 deploy。
- secrets 不在 repo、prompt 或 log;workflow 使用最小權限。
- 我能指出一次執行的結果與 usage;拿不到的資料沒有亂猜。
- 隊友能在乾淨 demo repo 執行 Skill,之後 git status 沒有非預期修改。
本站點改編自 awesome-agentic-ai-zh(MIT 授權,作者 Wenyu Chiou)v2026.09.23,資源連結查核日 2026-08-27。星級為學習優先順序(⭐⭐⭐⭐⭐=不看會卡住),非人氣排名。 MIT License · 課程結構最後更新:2026-10-03。內容持續補齊中,標記「撰寫中」的課程尚未上線。