Agentic Research
Agent 學習地圖 · 站點 A3

把 CLI Agent 接進安全的團隊流程

「怎麼安全連接外部工具、CI 與團隊流程?」

完成後你能:用最小權限、人工檢查與紀錄完成整合。

5–8 小時6 堂對應課程官方完整版

📌 學習目標

  • 只把一個安全範圍交給 MCP server。
  • 讓 CI 在 PR 自動產生一份可檢查的建議。
  • 用 Observability 看懂一次執行留下的 usage、時間與結果。
  • 把 A2 的 Skill 交給隊友,並讓對方安全地重跑。

進入條件

完成 A2 的規則卡與 review Skill,並讀完 Stage 5 的 Track A 核心 5.1–5.4。這一站只做一件事:讓 CLI agent 在測試用 PR 做一個只讀檢查 — 它可以提出意見,但不能自己合併、部署或取得多餘權限。

🧭 本站課程

按建議順序讀;勾選結果與 /learn 課程頁共用同一份瀏覽器進度。
本站進度
0/6
進度只存在你的瀏覽器
  1. 01
    我的資料安全嗎:用 AI 的時候,到底有什麼離開了你的電腦

    「安全嗎」這個問題問得太粗,所以永遠得不到有用的答案。這篇把它拆開:用雲端工具時實際離開你機器的四類東西、本地工具為什麼不一樣、「我們不用你的資料訓練」這句話承諾了什麼與沒承諾什麼,以及三條你真的能執行的規則。不含法律意見。

    11 分鐘
  2. 02
    企業資料安全基本盤:哪些資料不能餵給 AI

    員工把客戶個資貼進免費 AI 工具,是企業最常見也最難防的資料外洩路徑。這篇給你一套四分法的資料分級標準、一份「絕對不能上傳」的紅線清單、企業版與消費版的條款差異對照,以及本地部署選項和該問 IT 與法務的問題清單。

    8 分鐘
  3. 03
    AI 合規與風險邊界:企業導入的法務檢查表

    AI 導入前的法務功課,不是「找一條法規來遵守」,而是把風險面向盤點清楚、問對問題、要對文件。這篇給你五個風險面向的盤點框架、一份可以直接帶進法務會議的問題清單、供應商文件索要對照表,以及內部制度要補的項目與分場景管理方法。

    18 分鐘
  4. 04
    API 文檔同步更新系統:從人工維護到代碼驅動的文檔自動化

    API 改了但文檔沒跟,前端同事靠猜參數、測試環境反覆試錯。這篇用 Apidog、Fern、Mintlify 與 LLM 節點串出一條文檔同步流水線:從程式碼提取介面定義、自動生成示例、檢測不一致並告警,讓文檔永遠與實作保持一致。

    17 分鐘
  5. 05
    自動化代碼審查助手:從人工逐行檢查到 AI 輔助的品質守門員

    代碼審查耗時、容易漏掉邊界情況、新人難以掌握團隊規範。這篇用 GitHub Copilot、CodeRabbit、SonarQube 與 LLM 節點串出一條自動化審查流水線:靜態分析、安全掃描、風格檢查、語義理解與風險分級,讓資深工程師只處理高風險變更,把重複性工作交給機器。

    17 分鐘
  6. 06
    組織 AI 能力建設:從個人英雄到可複製流程

    公司裡有幾個人很會用 AI,不等於組織有 AI 能力。這篇講怎麼把個人經驗變成組織資產:能力盤點、種子用戶與三階段推廣路徑、把個人提示詞沉澱成技能庫與模板庫、分層訓練與文件化,以及衡量是否真正落地的構面與常見失敗模式。

    20 分鐘

⚠️ 寫第一個 Agent 前的五條底線

  1. 1.MCP 只拿到 demo 資料夾或最小 read-only toolset。
  2. 2.PR workflow 只提出意見:沒有 auto-merge、push 或 deploy。
  3. 3.secrets 不放在 repo、prompt 或 log;workflow 使用最小權限。
  4. 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. 練習 1:接一個 MCP server — 只交給它 demo 資料夾或唯讀工具;官方沒有需要的 server 時才考慮自寫。
  2. 練習 2:CI 只讀 review — 在測試用 PR 上讓 GitHub Action 跑一次只讀檢查並留言建議。
  3. 練習 3:Observability 紀錄 — 記下 provider、model、usage、時間與結果;拿不到的資料不亂猜。
  4. 練習 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。內容持續補齊中,標記「撰寫中」的課程尚未上線。