Agent 工作流程細節 v1.0 2026-05-25
建立 Agent 的流程
0
🏷️
基本資訊
›
1
📥
來源設計
›
2
📤
回報設計
›
3
🚧
邊界設定
›
4
🔎
審查設計
›
5
⚙️
Runtime
›
6
⌨️
Commands
›
7
📌
CLAUDE.md
0基本資訊
定義 Agent 的身份：叫什麼、做什麼、屬於哪個域、用什麼 Runtime、目前狀態
🎯
核心問題
一句話說明這個 Agent 的職責？屬於哪個工作域（SRE / Manager / 專案）？
🏷️
狀態分級
設計中 → 實作中 → 運行中。狀態決定你對 Agent 的信任程度與使用方式。
名稱：SRE 執行 Agent 域：SRE　　Runtime：Claude Code CLI　　狀態：設計中 說明：Task list → 逐步執行 → 每個 helm 指令你確認
1來源（觸發來源）
工作從哪裡進來？什麼情況下觸發？Agent 需要什麼格式才能開始執行？
📥
觸發管道
手動 Terminal / Jira MCP / Slack MCP / GitHub Issue / Routine 排程 / 討論後觸發。每個 Agent 通常同時有多個觸發來源。
📋
輸入格式規範
Agent 需要什麼才能開始？例如：Jira 卡需要哪些欄位、手動觸發需要什麼 prompt 格式、xlsx 放哪個路徑。
來源 管道 觸發方式 備註 手動 Terminal /deploy 主動觸發 Jira 卡 Jira MCP 被指派卡片 自動偵測 排程 Routine 每週一 週快照用
2回報
每個 Action 完成（或失敗）後，回報什麼、回報到哪裡、用什麼格式
✅
成功回報
告訴誰？Terminal / Slack #agent-notify / Slack #agent-approve？每個 Action 分別定義。
❌
失敗回報
說明失敗原因 + 診斷建議 + 不自行 retry。讓你決定下一步。
📝
回報格式範本
標準格式：執行時間、狀態（✅/❌/⚠️）、執行內容列表、結果、下一步建議。
成功 → Terminal 列出執行結果 + Slack #agent-notify 通知 失敗 → Terminal 說明原因 + 診斷建議（不自行 retry） 影響 prod 的操作 → Slack #agent-approve 等你按按鈕
3無法處理（邊界）
明確告訴 Agent 什麼不能做、什麼情況要停下來問你、遇到模糊情境怎麼辦
🚫
明確禁止的操作
CLAUDE.md 直接禁止的事，Agent 遇到時必須立即停下並說明原因。例如：直接修改 prod DB、刪除資源。
❓
缺少資訊時
缺少必要輸入（機密值、xlsx 未下載）→ 停下來列出缺少的項目，等你補充。不猜測、不假設。
🤔
不確定時
影響範圍不確定 / 多種做法 → 列出選項和各自影響，請你決定。絕不自行選擇。
禁止：直接改 prod DB / 刪除資源 / 跳過 approve 缺少：機密 Env 值 → 停下來問你 不確定：列出 A / B / C 選項 + 影響，等你選
4人類審查 / Approve Gate
定義每個 Action 在哪個時間點需要你介入，以及介入的方式（輸入 yes / 詳細 review / 自動）
✔️
輸入 yes（快速確認）
操作可逆、影響小、你信任 Agent 判斷 → Agent 列出要做的事，你輸入 yes 繼續。
🔬
詳細 review
操作不可逆、影響 prod、涉及機敏 → Agent 列出完整 diff / 計劃 → 你逐項確認 → 輸入 confirm。
🤖
自動執行
純讀取操作 / 已充分信任的重複任務 → Agent 直接執行，完成後回報結果。
讀取 Notion / git log → 自動 更新 values.yaml → 執行前你確認 (yes) helm upgrade (prod) → 詳細 review + confirm 覆蓋已存在快照 → 執行前 yes/no
5由誰來服務（Runtime）
選擇最適合這個 Agent 的執行環境，Runtime 決定 Agent 能做什麼、不能做什麼
💻
Claude Code CLI
需要執行 bash 指令、讀寫檔案、操作 repo、需要 MCP 工具串接。是最強大的 Runtime，但需要你開啟 terminal。
⏰
Routine
定時執行、polling 類任務。你不需要在場。不適合需要 approve 的操作（你可能不在）。
📱
Cowork / Claude App
不需要 terminal 的任務、對話式互動（報告生成、會議記錄）。
建議模式：Routine 負責偵測和通知 Claude Code CLI 負責執行 Routine 偵測 Jira 新卡 → Slack 通知 → 你決定 → 手動觸發 CLI
6Commands 清單
這個 Agent 提供哪些指令？每個指令做什麼、怎麼觸發、需不需要 approve
⌨️
每個 Command 的標準欄位
指令名稱、觸發方式（手動 / 自動）、說明、是否需要 approve、前提條件（如需要先準備什麼）。
Command 觸發 需要 Approve /deploy 手動 是（每個 helm 指令前） /update-env 手動 是（變更清單確認後） /snapshot 手動/自動 覆蓋時需要 yes /snapshot --monthly 手動 成本確認後才標記最終版
7CLAUDE.md 關鍵規則
從以上設計提煉出可直接貼進 CLAUDE.md 的規則。這是 Agent 每次啟動時讀取的行為準則。
📌
CLAUDE.md 必備區塊
我的職責 / 我的邊界（絕對不做的事）/ 觸發來源 / Approve Gate 規則 / 回報規則 / 資料讀寫路徑。
⚡
寫作原則
規則要明確、可操作、有具體的觸發條件和對應行為。避免模糊描述（「盡量確認」→ 改成「每個 helm 指令執行前必須列出指令等你確認」）。
## 我的邊界（絕對不做的事） - Routine 模式下不覆蓋已存在的快照 - 不在沒有 bills xlsx 的情況下產出成本分析 - 不修改其他 Agent 的目錄 ## Approve Gate 規則 - 讀取 Notion / git → 自動執行 - 覆蓋已存在的快照 → 需要 yes
💻
SRE 執行 Agent
Task list → 逐步執行 → 每個 helm 指令你確認
SRE 域 設計中 Claude Code CLI k8s / helm / kubectl
觸發來源
手動
你提供 Task list
討論OKR後整理
不需開Jira卡
手動
上版 prompt
版本號 +
Deployment Info
Jira MCP
ops-task 指派
PM/CS 開卡
兩三個月一次
手動
環境變數更新
說明要改哪個
key + namespace
手動
新增服務
說明服務規格
有/無現成chart
執行流程
Agent 自動
你介入
檢核層
Agent 自動執行
  • 讀取 k8s values.yaml / helm 設定
  • 版本比對（線上 vs local）
  • 執行 helm upgrade / install
  • Pod 健康確認（status / error rate）
  • 建立 preview-{branch} namespace
  • 讀取 optimization-backlog.md
你必須介入
  • 每個 helm 指令執行前確認
  • prod 操作額外確認一次
  • 機密 Env 值（絕不存在設定檔）
  • Task list 提供（討論後整理）
  • 直接改 DB → 你手動執行
  • Agent 工具無法存取的資源
邊界（絕對不做）
  • 直接修改 prod DB
  • 你不在時執行 prod 操作
  • 自行判斷刪除任何資源
  • 跳過 approve 直接部署
  • 有任何不確定仍假設繼續
回報 / 輸出
  • Terminal 逐步回報執行結果
  • Slack #agent-notify 完成通知
  • k8s-values repo 變更記錄（git）
  • Preview URL 回傳到 Terminal
  • ops-task 結果寫回 Jira comment
🚨
Alert 處理 Agent
Alert → 查原因 → 匹配 Runbook → RCA 草稿
SRE 域 設計中 Claude Code CLI + Slack
觸發來源
自動
Prometheus Alert
告警規則觸發
→ 推 Slack
自動
CloudWatch Alert
AWS 指標異常
→ 推 Slack
手動
你指定調查
懷疑有問題
手動觸發調查
執行流程
Agent 自動
你介入
檢核層
Agent 自動執行
  • 讀取 Slack alert 內容與 metadata
  • 查詢 Prometheus / Loki 日誌
  • 比對 Runbook 資料庫匹配
  • 生成 RCA 草稿文件
  • 記錄處理過程到 runbooks/
你必須介入
  • 判斷是否為誤報
  • 確認 Root Cause 判斷正確性
  • 批准 Runbook 執行
  • prod 變更（需 approve）
邊界（絕對不做）
  • 自行執行 Runbook（需你確認）
  • 自行判斷 prod 環境變更
  • 在 Runbook 未完善時猜測修復
回報 / 輸出
  • Terminal 回報 RCA 草稿路徑
  • Slack 回覆 alert thread（誤報通知）
  • runbooks/ 目錄更新處理記錄
⚡
週期快照 Agent
每週自動聚合 snapshot.md，作為所有報告共用原料
Manager 域 設計中 Routine + Claude Code CLI Notion MCP / git log
觸發來源
Routine 自動
每週一早上
週快照
你不需要在場
手動
/snapshot
臨時補跑
Terminal 觸發
手動（月初）
/snapshot --monthly
先下載 bills xlsx
再執行
執行流程
Agent 自動
你介入
檢核層
Agent 自動執行
  • 拉取 Notion Daily Pages（本週）
  • 查詢 Prometheus / Infra 指標
  • 讀取 optimization-backlog.md
  • 彙整三個 repo 的 git log 摘要
  • 輸出 YYYYMMDD-snapshot.md
  • Slack #agent-notify 完成通知
你必須介入
  • 月初手動下載 bills/bill_YYYYMM.xlsx
  • 月度快照成本異常確認
  • 初次 Notion API token 設定
  • 覆蓋已存在快照需要 yes
邊界（絕對不做）
  • Routine 模式下覆蓋已存在快照
  • 無 bills xlsx 時產出成本分析
  • 修改其他 Agent 的目錄
  • 建立 _shared/ 非規範路徑
回報 / 輸出
  • _shared/weekly-snapshot/YYYYMMDD-snapshot.md
  • _shared/weekly-snapshot/YYYYMMDD-monthly.md
  • Slack #agent-notify 快照路徑 + 完整性
  • Terminal 月度成本摘要（等你確認）
📂
報告生成 Agent
讀快照 → 問你關鍵問題 → Monthly / Manager / 2x2
Manager 域 設計中 Claude App Projects
觸發來源
手動（月底）
月報製作
月度快照已產出
才能執行
手動（雙週）
Manager Group Report
讀快照補
你的判斷
手動（月底）
2x2 個人回報
月度快照 +
你的反思
執行流程
Agent 自動
你介入
檢核層
Agent 自動執行
  • 讀取 _shared/weekly-snapshot/
  • 生成報告骨架與問題清單
  • 根據你的回答填充內容
  • 生成最終三份 .md 文件
  • 品質 QA（格式、表達建議）
你必須介入
  • OKR 主觀判斷與策略方向
  • 會議決議與行動項目
  • 跨部門資訊（Agent 無法取得）
  • 2x2 個人感悟與覆盤
  • 確認最終 .md → 丟 Gemini 產簡報
邊界（絕對不做）
  • 無快照時自行生成報告
  • 自行填寫你的主觀判斷
  • Claude → Gemini 斷點（目前手動）
回報 / 輸出
  • 01-OKR進度討論.md
  • 02-營運指標分析.md
  • 04-資訊安全分享.md
  • 2x2Report-YYYYMM.md
📋
會議記錄 Agent
生成會議框架 → 追蹤行動項目 → 整理決議
Manager 域 設計中 Claude App Projects
觸發來源
手動（開會前）
Dev Group 週會
每週觸發
生成 Agenda
手動
臨時會議
任何需要
記錄的會議
執行流程
Agent 自動
你介入
檢核層
Agent 自動執行
  • 生成 Dev Group 會議框架
  • 列出上次未解決行動項目
  • 整理你貼入的討論內容
  • 輸出結構化會議記錄 .md
你必須介入
  • 填入會議中的討論內容
  • 決議與行動項目
  • 誰負責什麼事
邊界（絕對不做）
  • 自行補充未知的會議決議
  • 替你指派行動項目給他人
回報 / 輸出
  • 會議記錄 .md（存 docs/）
  • 未完成行動項目追蹤清單
🔔
提醒 Agent
多時間點排程 → 問你今天做了什麼 → 回填 Notion
Manager 域 待建立 Routine Notion MCP
觸發來源
Routine 排程
早上 10:00 前
確認今日預計
是否已填
Routine 排程
下班前 18:00
問今天做了什麼
→ 回填 Notion
Routine 排程
週一早上
本週計劃
是否整理
Routine 排程
月底
提醒準備
月報原料
執行流程
Agent 自動
你介入
檢核層
Agent 自動執行
  • 讀取今天 Notion Daily Page
  • 在指定時間發送提醒
  • 整理你的回答並結構化
  • 寫回 Notion Page 下半部
你必須介入
  • 回答今天實際做了什麼
  • 今日回顧與改善反思
  • 任何 Agent 無法知道的資訊
邊界（絕對不做）
  • 你不在場時自行填寫實際記錄
  • 修改你已填寫的計劃內容
回報 / 輸出
  • Notion Daily Page 實際工作記錄
  • Notion Daily Page 今日回顧
  • （月底）提醒準備 bills + Notion 匯出
💰
Cost 分析 Agent
Gmail 月初費用信 → 解析 xlsx → 四分層計算 → 月報原料
SRE 域 待建立 Claude Code CLI Gmail / xlsx
觸發來源
自動（月初）
Gmail 費用信件
AWS 經銷商
轉寄帳單
手動
指定月份重跑
bills/ 路徑
已有 xlsx
執行流程
Agent 自動
你介入
檢核層
Agent 自動執行
  • 讀取 bills/bill_YYYYMM.xlsx
  • 計算 AI / Dev / CQI / Prod 四分層
  • 與上個月比較差異
  • 識別異常費用項目
  • 產出 cost-YYYYMM.md
你必須介入
  • 確認異常費用的原因判斷
  • 補充使用模式變化的背景
  • 確認匯率（或提供公開 API）
  • xlsx 格式異動時確認欄位差異
邊界（絕對不做）
  • 無 xlsx 時自行猜測費用
  • 自行猜測異常原因（需你確認）
  • 寫入非規範的 _shared/ 路徑
回報 / 輸出
  • _shared/reports/cost-YYYYMM.md
  • Terminal 顯示費用摘要（等確認）
  • 異常費用清單供你判斷
🛒
Sales Agent
Sales 在 Slack 說需求 → 建立電商品項 → 回傳下單連結
專案域 運行中 Slack + Claude API
觸發來源
Slack 訊息
Sales 員工
外勤時傳達
建立商品需求
Slack 訊息
客製商品需求
特殊規格
偶發需確認
執行流程
Agent 自動
Sales 介入
檢核層
Agent 自動執行
  • 接收並解析 Slack 訊息
  • 解析商品規格 / 定價 / 客戶資訊
  • 呼叫電商 API 建立品項
  • 回傳下單連結到 Slack
Sales 必須提供
  • 商品需求描述（Slack 訊息）
  • 特殊規格確認（偶發）
  • 客戶資訊（如需要）
邊界（絕對不做）
  • 超出電商業務範圍的操作
  • 修改已建立的訂單
回報 / 輸出
  • Slack 回覆下單連結
  • Sales 直接轉給客戶使用
📌
任務管理 Agent
雜訊輸入（Line / Slack / 口頭）→ 結構化 → Notion / GCal / Jira
Manager 域 待建立 Claude App / Claude Code
觸發來源
你貼入
Line / Slack 訊息
任何格式
不需整理
你描述
口頭交辦紀錄
用文字描述
口頭收到的事
你貼入
討論結果
會議後討論
決定的事項
你輸入
突然想到的事
任何想法
快速捕捉
執行流程
Agent 自動
你介入
檢核層
Agent 自動執行
  • 解析雜訊文字，拆解工作項目
  • 判斷類型：行程 / 任務 / 追蹤
  • 推斷期限與優先度
  • 建立 Notion Task / GCal / Jira
  • 回報建立結果 + 連結
你必須介入
  • 確認解析結果是否正確
  • 補充模糊的期限或優先度
  • 選擇目標工具（Notion / GCal / Jira）
邊界（絕對不做）
  • 不確認直接建立任務
  • 自行決定任務優先度（需你確認）
  • 代你指派任務給他人
回報 / 輸出
  • Notion Task（排程 / 待辦類）
  • Google Calendar 行程（時間類）
  • Jira 卡（追蹤 / 需要 ticket 類）
  • Terminal 回報所有建立項目 + 連結