● 現況（生成 2026-07-04，源頭
_shared/definitions/*.json + 各 agent CLAUDE.md）·
文件入口 ·
全貌總覽 ·
流程地圖逐 Agent 工作流程細節
現況，2026-07-04 從源頭生成（層級/職責/harness/trigger 取自 agents.json；四面向抽自各 *-agent/CLAUDE.md）；衝突以 JSON + 實測為準。
18 個 agent，依 6 治理區塊分組。每張卡四面向：觸發 / Agent 自動執行 · 你必須介入（Approve Gate） · 邊界（絕對不做） · 回報 / 輸出。
18agent
6治理區塊 A~F
13maturity 完整
4部分（3 dev 補齊中）
1scaffold（task-management）
maturity：完整 harness 齊全 部分 補齊中 / scaffold 殘缺 待補
· 四面向色帶：綠＝觸發 / 黃＝你介入 / 紅＝邊界 / 藍＝回報
跳到區塊：
A 入口/編排 ·
B 資料管線 ·
D 維運 ·
E 開發 ·
F 個人/業務
A · 入口 / 編排層
多渠道輸入 → filter → MessageQueue → agent 消費（定案模式，consumer 未啟動）
task-management-agent scaffold
多渠道輸入 → 派工（編排層 queue consumer；broker 上 Railway 前未 live）
reads: broker queue（AgentEvent）· agents.json ｜ writes: Notion Task / Calendar / Jira 卡 / 轉派
▸ 觸發 / Agent 自動執行
- event · broker queue 的 task-intake 事件（Line/Slack/Jira/口頭，經 broker normalize）
- 定位＝consumer，不自己接 webhook；broker 上 Railway 前僅能手動測
/parse-intake
- /parse-intake：解析交辦 → 分類意圖 → 抽欄位 → 產結構化草案等 approve
▸ 你必須介入（Approve Gate）
- 風險分級：低風險+可逆（建 Notion Task / Calendar）可自動、事後回報
- 高風險 / 不可逆 / 跨 agent 派工 → 列出計劃等 approve
- 解析不確定（意圖模糊）→ 回問來源，不硬猜
- broker 未上線前一律手動 approve，不自動對外寫入
▸ 邊界（絕對不做）
- 不自己接 webhook / 不輪詢外部平台 — 事件一律經 broker 進 queue
- 不無聲執行高風險動作（對外寫入依風險分級）
- 不在本檔或回報中宣稱尚未接通的自動能力
- 不存取其他 Agent 的目錄
▸ 回報 / 輸出
- consumer 經
ctx.reply() + ctx.done() 回覆來源平台
- 回覆防迴圈：依平台約定加前綴（參考 b2b-crm「AI回覆：」慣例）
- adapter（consumer 進程）未建，待 broker 上 Railway 後建
adapter/
另有兩個編排層基建：agent-manager（平台，Broker→Router→Queue→Agent + 管理 UI）與 agent-broker（consumer SDK），由 personal-developer-agent 開發（見 E 層）。現況：Redis up、consumer 未啟動、平台未上 production。
B · 資料管線層
raw 蒐集 → 知識合成 → 報告（唯一有真排程的層）
collector-agent 完整
原始資料蒐集 — 搬資料不解讀
reads: daily-reports · Notion Daily · Working-zone · team git log · Books ｜ writes: _raws/**
▸ 觸發 / Agent 自動執行
- scheduled · collector-daily 每天 21:00（daily-reports + Notion daily + working-zone）
- scheduled · collector-gitlog 每週一 08:00（團隊 git log）
- 手動
/collect（今天全來源）/ --date（補跑）/ --gitlog
- 純搬資料全自動：已存在則跳過、失敗不中斷、記 manifest
▸ 你必須介入（Approve Gate）
依設計無 approve gate — pipeline 型純自動搬運，不對外寫入。
▸ 邊界（絕對不做）
- 不摘要、不分類、不分析任何內容
- 不修改 _raws/ 已存在檔案（append-only）
- 不直接寫 _knowledgebase/（那是 processor 領域）
- 不觸碰 _shared/ 的報告產出目錄；不存取其他 Agent 的目錄
▸ 回報 / 輸出
- 寫入
_raws/{work-logs,journals,working-zone,git-logs,books}/
- append
_raws/_manifest.md（每次記新增/跳過/失敗清單）
- 對帳由 collector-verify（21:30，BI 分離）產出，異常寫 pa outbox
processor-agent 完整
知識合成 — ingest raw → 合成 wiki
reads: _raws/ · _shared/meetings/ ｜ writes: _knowledgebase/**
▸ 觸發 / Agent 自動執行
- manual ·
/ingest --auto（批次所有新 daily-reports，直接寫）
/ingest [路徑]（單一互動）/ --since / /ingest-books- watermark 機制（grep log.md 判斷是否已處理）；刻意未排程
▸ 你必須介入（Approve Gate）
- daily-reports auto ingest → 直接執行，完成顯示摘要
- meetings / articles → 列關鍵洞察，你確認後才寫入 wiki
- 新建 wiki 頁 → 直接建立；更新已存在頁 → 直接更新後顯示 diff
▸ 邊界（絕對不做）
- 不修改 _raws/ 任何檔案（raw immutable）
- 不產報告 / 快照 / 給人看的文件
- 不讀 daily-reports 直接處理（要先經 collector）
- 不憑空更新 wiki、不刪 wiki 頁；不存取其他 Agent 的目錄
▸ 回報 / 輸出
- 寫入
_knowledgebase/**（新建或更新 wiki 頁）
- 更新
_knowledgebase/log.md（watermark 記每筆 ingest）
- Terminal 顯示摘要：新建 N 頁 / 更新 N 頁 / 跳過 N 個
C · 知識層＝_knowledgebase karpathy wiki，是資料儲存不是 agent：processor 寫入、personal-assistant（報告產線）讀取。｜ manager-agent 的報告職能已於 2026-07-03 併入 personal-assistant（見 F 層）。
D · 維運層（SRE Team 起點）
告警接收 → 診斷止血 → 產 incident/task → 維運執行與 RCA
alert-agent 完整
告警首線止血 — triage + Tier 0 白名單止血 + 建卡 + 升級
reads: K8s · Loki · Prometheus · git deploy history ｜ writes: _shared/incidents/ · _shared/tasks/
▸ 觸發 / Agent 自動執行
- event · Slack alertmanager @mention（app_mention）
- /alert-triage → /diagnose-{info,warning,critical}（讀 k8s+logs+metrics+deploy）
- /auto-mitigate：Tier 0 白名單 + 高信心自動止血；guard-alert 護欄
- 止血後等 5 分鐘未 resolve 則升級、不重試；同動作最多 1 次
▸ 你必須介入（Approve Gate）
- 診斷（read-only）→ 自動
- Tier 0 止血（白名單+高信心）→ 自動，完成推 #agent-notify
- Tier 1（中信心）→ 推 #agent-approve：一鍵執行 / 升級 SRE
- Tier 2 / 止血失敗 → 升級 sre-agent（帶交接文件路徑）
▸ 邊界（絕對不做）
- 白名單外的 K8s/Helm 操作（env 修改、helm upgrade、刪 namespace）
- 直接修改 DB 資料；自動關閉 / 靜音 alert
- 止血 5 分鐘未 resolve 不重試、同動作不重複
- 不存取其他 Agent 的目錄
▸ 回報 / 輸出
- 寫
_shared/incidents/YYYYMMDD-HHmm-{alert}-{svc}.md（診斷+證據+止血+狀態）
- 寫
_shared/tasks/…-task.md（僅需根因修復時）
- Slack thread 診斷摘要 + #agent-notify（Tier0）+ #agent-approve（Tier1）
sre-agent 完整
維運執行 + RCA — helm/kubectl 執行、env、診斷、回寫 task
reads: _shared/incidents/ · tasks/ ｜ writes: _shared/tasks/(狀態) · ./docs/rca/ · ./docs/runbooks/
▸ 觸發 / Agent 自動執行
- event_or_manual · alert 升級接手，或手動
- /service-analyze · ai analyze/rca（read-only 診斷）
- /helm-deploy · /k8s-version-update · /update-env · /new-service · /preview
- guard-ops 護欄 + log-ops-pre/post（redact 遮罩）；技能內部：計劃→approve→執行→驗證
▸ 你必須介入（Approve Gate）
- 診斷（read-only）→ 自動
- 維運操作 → 先顯示完整計劃（指令+影響 namespace/service），等 yes
- prod namespace → 雙重確認（yes → 再 confirm 是 prod）
- Incident 接手 → 獨立驗證後先報告確認，再進維運流程
▸ 邊界（絕對不做）
- 直接修改 prod DB（psql/mysql/mongo 直連）
- 刪 prod namespace 或 release（kubectl delete ns / helm uninstall）
- Env 實際值不顯示、不寫 log 或文件
- 不存取其他 Agent 的目錄
▸ 回報 / 輸出
- 寫
./docs/rca/（RCA 報告）· ./docs/runbooks/
- 更新
_shared/tasks/{task} 狀態為「已完成」+ 時間 + 結果摘要
- Terminal 回覆診斷結論 / 維運執行結果
BI 缺口（兩者共通）：執行/部署後用 metrics 獨立驗證是否真的恢復，尚未建（harness-standard 標未建）。
E · 開發層
各 repo 全端開發（11 個 dev agent）。共通 harness：guard-dev（PreToolUse Bash）+ commit 後 agent 型 code-review hook + log-commit-to-report（10 個標準 dev 全有）。共通邊界：不 push main/master、未確認不部署 prod、不碰其他 agent 目錄、secret 走 .env。以下只列各 agent 的差異點。
共用開發流程（WF3）與共通 Approve / 邊界 / 回報
| 面向 | 共通內容（除非卡片另註） |
|---|
| 觸發 / 自動 | manual · CLI 交辦 / Jira / GitHub issue → /implement-task（pull dev/uat → worktree → 實作 → 測試 → Final Code Review subagent → push + MR/PR URL）；guard-dev 擋 bare force-push / 主分支刪除；commit 後 agent 型 code-review hook 自動跑；log-commit-to-report 寫當日 daily-report |
| 邊界（絕對不做） | 不直接 push main/master（一律 feature branch + PR）· 未經確認不部署 prod · 不硬編碼 secret（走 .env）· 不存取其他 Agent 的目錄 |
| 回報 / 輸出 | 寫 _shared/daily-reports/{slug}-developer/{slug}-developer-YYYYMMDD.md；PostToolUse hook 自動 append commit；Terminal 實作摘要 + PR/MR URL |
clinicity-developer-agent 完整
Clinicity 平台（Node+Drizzle+PG / Vue 3）· 23 skill
▸ 觸發 / 自動（差異）
- skills：/plan /frontend-dev /backend-dev /write-tests /code-review /deploy /ui-review
▸ Approve Gate（差異）
- 雙重確認（confirm）：deploy prod · DB migration · 刪資料 · merge PR 到 main
- 快速確認（yes）：deploy staging · 開 PR · 改現有程式碼
▸ 邊界（差異）
- 不刪 production 資料庫；不手寫 migration SQL（用 Drizzle 產生）
genetic-testing-developer-agent 完整
新光×嘉和基因檢測（Express+Drizzle+PG / Vue 3；Railway+CF Pages）· 20 skill
▸ 觸發 / 自動（差異）
- PR base 一律為
dev；/plan /frontend-dev /backend-dev /ui-review /write-tests /deploy /code-review
▸ Approve Gate（差異）
- DB migration → 先列變更等確認；deploy staging → 顯示計劃確認
- deploy prod → 明確授權，推 #agent-approve
▸ 邊界（差異）
- 不 push main/master/uat；不直連 prod DB；不手建 .sql（用 db:generate）
- git fetch 失敗不得跳過（先修 SSH/remote）
personal-developer-agent 完整
個人專案 + 編排層基建（exchange/wallet/agent-manager/agent-broker/finlab…）· 9 skill
▸ 觸發 / 自動（差異）
- /implement-task 全自動（worktree→實作→commit→push feature branch）
- 正在開發 agent-manager / agent-broker＝A 編排層基礎設施
▸ Approve Gate（差異）
全自動執行 — 不需等待 approve（輕量版）。
▸ 邊界（差異）
- 不刪遠端 branch（除非明確指定）；不改 .env / secrets 檔
e2e-testing-developer-agent 完整
BOB 自動化測試（Playwright/Cypress/pytest/BDD）· 7 skill · 另持 SQS broker/channel（WF5）
▸ 觸發 / 自動（差異）
- /test-plan /write-e2e /write-api-tests /write-unit-tests /write-bdd /ci-setup /regression-check
▸ Approve Gate（差異）
- 修改 CI/CD 設定 → 列變更後確認
- 禁止自動：部署任何服務、push main/master
▸ 邊界（差異）
- 不執行部署（交各 developer agent）；不改 reference/ 被測系統原始碼
- 不直接操作 production DB / 環境
b2b-crm-developer-agent 完整
B2B CRM（Express+Drizzle+PG / Vue 3+NativUI；Railway）· 8 skill · 另持 BullMQ+Jira webhook（WF4）
▸ 觸發 / 自動（差異）
- Jira webhook（BullMQ channel）或 /implement-task；Railway 事件（crash/oom）→ 診斷→回覆
- /frontend-dev /backend-dev /design-review /code-review /deploy-docs
▸ Approve Gate（差異）
- 任務開始前必先 /implement-task（git sync + worktree）
- DB migration 前列變更等確認；部署決策（rollback/擴充/重啟）人工確認
▸ 邊界（差異）
- 不直連 prod DB；嚴禁在主 worktree 直接改（一律 /implement-task）
- Jira 回覆需以「AI回覆：」開頭防迴圈
codays-developer-agent 完整
Coday 4 repo（NestJS+TypeORM / Nuxt+Vue SSR / Vue+Pinia / Prisma+Sequelize；GitLab flightgo/coday）· 2 skill
▸ 觸發 / 自動（差異）
- /implement-task（含 Final Code Review subagent → MR）；/security-audit
- 2026-07-03 已從 mijily 殘影重寫為真實 coday
▸ Approve Gate（差異）
- DB migration（TypeORM/Prisma/Sequelize）前列變更等確認
▸ 邊界（差異）
- 不 push main/master/dev；不直連 prod DB
- microhbot-bob-coday 不混用 Prisma/Sequelize（先確認模組）
web-scraper-developer-agent 完整
KA 名單爬蟲（Python/Scrapy/Playwright）· 3 skill
▸ 觸發 / 自動（差異）
- /web-scraper-developer skill；遵守 robots.txt、設 request delay
- 部署前
alembic upgrade head 確保 schema 同步
▸ Approve Gate（差異）
⚠ CLAUDE.md 無明確 approve gate 段（待補：人工審核關卡）。
▸ 邊界（差異）
- 程式碼一律寫入
repos/<project>/；規格以 docs/ 為準，衝突先問
- 每個 spider 必須遵守 robots.txt + request delay
mijily-bottle-developer-agent 完整
mijily-bottle-cap · 1 skill（最精簡）
▸ 觸發 / 自動（差異）
- /implement-task（worktree→實作→commit→push feature branch）
▸ Approve Gate（差異）
全自動執行 — 不需 approve（輕量版；06-16 稽核標記無測試 gate，待重驗）。
▸ 邊界（差異）
- 不刪遠端 branch（除非明確指定）；不改 .env / secrets 檔
bob-developer-agent 部分
BOB Platform（Backend/Client/Dashboard/OAuth）· 1 skill · 07-03 補齊 settings
▸ 觸發 / 自動（差異）
- /implement-task（pull dev → worktree → 測試 100% → Final Code Review → MR）
- /plan /frontend-dev /backend-dev /write-tests /code-review /deploy
▸ Approve Gate（差異）
- 雙重確認（confirm）：deploy prod · DB migration · 刪資料 · merge 到 main
- 快速確認（yes）：deploy staging · 開 PR · 改現有程式碼
▸ 邊界（差異）
- 不刪 production DB；不手寫 migration SQL（用 ORM tool 保 _journal.json）
- 缺口：guard-dev 未擋 --force to main（沿用標準 dev 缺口）
general-developer-agent 部分
BOB/Serverless 以外的所有專案（含 AI 服務）· 1 skill · 07-03 補齊
▸ 觸發 / 自動（差異）
- /implement-task（pull base dev 優先 → 測試 100% → Final Code Review → MR/PR）
- /ai-feature（prompt/LLM API）+ /plan /frontend-dev /backend-dev /write-tests /code-review /deploy
▸ Approve Gate（差異）
- 雙重確認（confirm）：deploy prod · 刪資料 · merge 到 main · 大量 AI API 呼叫（batch）
- 快速確認（yes）：deploy staging · 開 PR · 改現有程式碼
▸ 邊界（差異）
- 不接 BOB / Serverless 任務（導向專屬 agent）；不刪 production 資料
- 缺口：guard-dev 未擋 --force to main（沿用標準 dev 缺口）
serverless-developer-agent 部分
Cloudflare Workers / AWS Lambda / GCP Functions · 1 skill · 07-03 補齊
▸ 觸發 / 自動（差異）
- /implement-task（pull main → 測試 100% → Final Code Review → MR）
- /develop /plan /write-tests /code-review /deploy
▸ Approve Gate（差異）
- 雙重確認（confirm）：deploy prod · 改 IAM 角色/權限 · 刪 Function/Secret · 改 Trigger 設定
- 快速確認（yes）：deploy staging/dev · 開 PR · 改現有程式碼
▸ 邊界（差異）
- secret 走 Secret Manager；不刪 production Function 或 IAM 設定
- 缺口：guard-dev 未擋 --force to main（沿用標準 dev 缺口）
F · 個人 / 業務層
個人參謀與提醒 + 報告產線 / 業務商品建單與付款連結
personal-assitant-agent 完整
雙角色：個人參謀（規劃/提醒/職涯，向前）＋報告產線（原 manager，向後）· 21 skill
reads: Notion Daily · Obsidian · _knowledgebase/ · daily-reports · _manifest · routine-suggestions ｜ writes: Notion Daily log · _shared/{today-plan,suggestions-inbox,manager-report,monthly-report,2x2-reports,reports}/ · outbox/
▸ 觸發 / Agent 自動執行
- scheduled · pa-daily-log-create（平日 09:00 建 Notion Daily log）
- scheduled · pa-remind-daily-notion（23:00）/ pa-remind-weekly-snapshot（週一 09:00）/ pa-remind-monthly-report（28 號 09:00）/ pa-triage-morning（平日 08:45）
- 手動 /today-plan（WF10）· /triage-suggestions（WF11）· /remind · /notion-reader · 報告 skill
- guard-report-overwrite（PreToolUse Write，07-03 從 manager 併入）
▸ 你必須介入（Approve Gate）
- 提醒操作自動（只推 webhook 或寫 outbox）
- /today-plan → 產清單後 Terminal 顯示，等你確認/調整，不自動派工
- 個人助理任務（文件/簡報）→ 顯示結果等確認
- deploy-publish-page → 執行前列計劃等確認
▸ 邊界（絕對不做）
- Notion 寫入僅限 Daily database（其他 database/page 不寫）
- 報告產線不產「待辦」、參謀不產「對外報告結論」（雙角色分界鐵則）
- 不在場不自行填記錄、不改已填計劃、不代決策；不重複發相同提醒
- 報告來源只讀 _knowledgebase/（wiki 不足時停下提示，不硬產）；不存取其他 Agent 目錄
▸ 回報 / 輸出
- 提醒 → SLACK_WEBHOOK_URL 推 Slack（實測 200），否則 fallback
outbox/reminders.md
- /today-plan →
_shared/today-plan/YYYYMMDD-plan.md；/triage → _shared/suggestions-inbox/
- 報告 →
_shared/{manager-report,monthly-report,2x2-reports,reports}/
sales-agent 完整
業務建單 — Slack 收指令 → 判斷組織 → 解析欄位 → 建 SKU + 回付款連結
reads: 電商後台 API ｜ writes: Slack 回覆 · 電商 SKU
▸ 觸發 / Agent 自動執行
- event · Slack 業務訊息（同 thread 共享組織記憶）
- /org-select（威許/歐巴）→ /product-query → /product-intake → /product-match → /sku-create-flow
- 不在範圍的請求一律回「🚧 此功能正在開發中」
▸ 你必須介入（Approve Gate）
依設計無 approve gate — 業務自助工具；缺欄位追問、多候選請業務選，均自動流程。
▸ 邊界（絕對不做）
- 不改 SKU 以外欄位（名稱/說明/狀態）；不接刪除商品或批量操作
- 不在 Slack 顯示 API token / 內部 ID；每次只處理一個商品的 SKU
- 資訊模糊必先確認不自行補全；不存取其他 Agent 的目錄
▸ 回報 / 輸出
- Slack thread 回覆（僅收到
<channel source="slack"> 時才回）
- 成功必含付款頁 URL；缺欄位 ❓ / 多候選列清單 / 失敗 ❌（純文字）
缺欄位 / 待補清單
以下 agent 的 CLAUDE.md 在對應面向缺明確段落，卡片以「依設計無」或「⚠ 待補」標示，列此供後續補上。
| Agent | 面向 | 現況 |
|---|
| web-scraper-developer | Approve Gate | ⚠ 待補 — CLAUDE.md 無明確「你必須介入」關卡與人工確認流程 |
| collector-agent | Approve Gate | 依設計無（pipeline 型純自動搬運，不對外寫入）— 非缺陷 |
| sales-agent | Approve Gate | 依設計無（業務自助工具，缺欄位追問即人工節點）— 非缺陷 |
| personal-developer / mijily-bottle | Approve Gate | 依設計「全自動 push 不需 review」（輕量版）；06-16 稽核標記待重驗 |
| bob / general / serverless | harness maturity | 07-03 已補 settings + implement-task/code-review skill；仍缺 guard-dev 擋 --force to main（沿用標準 dev 缺口） |