# AI Agent 專業任務擴展與 Telegram Runtime Bridge 工作報告

> 日期：2026-06-18（台北時間）
> 狀態：P2-405F 已完成 Telegram Canary Owner Review Gate、9 個 owner 必填欄位、9 個 acceptance check、8 個 rejection reason、6 個 reviewer action、8 個 receipt readback check、API guard、測試、治理頁可視化與 redaction / i18n 正式驗證；Telegram 實發仍未啟用。
> 事實來源：`ai_agent_professional_task_expansion_v1`

## 1. 結論

本輪把「AI Agent 還能處理哪些專業工作」正式產品化成 24 類專業任務，並把 Telegram 群組 / TG Bot 整合拆成 5 段啟動前閘門。P2-405D 已把第一次 Canary delivery 前必須由統帥確認的交付欄位、preflight、hold reason、rollback / mute 與 readback plan 顯示到治理頁；P2-405E 進一步把第一個 `daily_agent_workload_digest` dry-run delivery rehearsal 固定成可重放證據；P2-405F 再把這份演練轉成 owner review gate，要求 owner 回覆、Hermes receipt readback、OpenClaw / Security / QA 驗收與拒收條件全部清楚可見。

這不是直接讓 AI Agent 發 Telegram 或改 production；目前只允許 no-send preview、queue preview readback、owner review、canary approval package、canary send approval packet、canary delivery gate 與 dry-run delivery rehearsal。真正送到 **AwoooI SRE 戰情室** 必須先通過 owner-approved P2-405F live canary approval、dedup、receipt、redaction、OpenClaw 仲裁、Security gate 與 QA verifier。

## 2. 完成度

| 範圍 | 完成度 | 狀態 |
|---|---:|---|
| 專業任務擴展契約 | 100% | 24 類任務已定義 owner、風險、MCP、RAG、Telegram policy 與 blocked actions |
| Telegram Runtime Bridge 契約 | 100% | no-send preview、queue preview、approved canary、日週月報、action-required digest 已分段 |
| Telegram no-send 訊息預覽 | 100% | 6 種訊息預覽、6 個 dedup key、6 組 receipt expectation、1 份 canary approval package 已固定 |
| Canary 發送批准包 | 100% | 1 份 canary send approval packet、7 個批准欄位、6 個停止條件、5 步 mute / rollback、6 個 receipt readback check 已固定 |
| Canary Delivery Gate | 100% | 1 份 delivery gate、8 個交付必填欄位、8 個 preflight、7 個 hold reason、7 個 readback check、5 個 rollback / mute 控制已固定 |
| Canary Dry-run Delivery Rehearsal | 100% | 1 份 dry-run rehearsal、6 個 step、8 個 readback check、7 個 stop condition、5 個 rollback / mute 控制已固定 |
| Canary Owner Review Gate | 100% | 1 份 owner review gate、9 個 owner 欄位、9 個 acceptance check、8 個 rejection reason、6 個 reviewer action、8 個 receipt check 已固定 |
| API / loader | 100% | `GET /api/v1/agents/agent-professional-task-expansion` 只讀輸出 |
| 治理頁可視化 | 100% | `/zh-TW/governance?tab=automation-inventory` 顯示任務、風險、TG bridge、preview、dedup、receipt、canary、delivery gate、rehearsal、owner review gate 與 live/send/write=0 |
| Telegram 實發 | 0% | `telegram_send_count=0`、`bot_api_call_count=0`、`gateway_queue_write_count=0` |
| Runtime 自動優化 | 0% | production write、host write、kubectl、paid API、secret read 全部維持 0 |

## 3. Telegram Bridge

| 階段 | 狀態 | 可做 | 不可做 |
|---|---|---|---|
| no-send preview | ready for owner review | 產生脫敏 TG 訊息預覽、dedup key、風險層級 | 不送 Telegram、不寫 queue |
| queue preview readback | ready for owner review | 讀回 queue envelope hash、receipt expectation | 不寫 production queue |
| approved canary | blocked until approval | 單一 canary 訊息與 receipt 驗證 | 未批准不得 Bot API send |
| 日週月報 digest | blocked until canary receipt | Agent 工作量、完成度、阻擋項、圖表摘要 | 不洗版、不發成功噪音 |
| action-required digest | blocked until dual gate | 高風險審核卡、failure-only escalation | 不取代 runtime authorization |

## 4. P2-405B no-send 預覽

| 訊息類型 | 風險 | 主責 | dedup key | 發送狀態 |
|---|---|---|---|---|
| 日報 | low | Hermes | `awoooi:agent-report:daily:{yyyy-mm-dd}:v1` | no-send |
| 週報 | medium | Hermes | `awoooi:agent-report:weekly:{iso-week}:v1` | no-send |
| 月報 | medium | Hermes | `awoooi:agent-report:monthly:{yyyy-mm}:v1` | no-send |
| 高風險審核卡 | high | OpenClaw | `awoooi:agent-approval:{risk}:{work-item-id}:v1` | no-send |
| failure-only escalation | critical | SRE Sentinel | `awoooi:agent-failure:{alertname}:{target}:{window}:v1` | no-send |
| report receipt gap alert | medium | Telegram Ops | `awoooi:agent-receipt-gap:{message-type}:{window}:v1` | no-send |

每一種 preview 都包含脫敏 body lines、receipt expectation id、target room env ref、risk tier、approval gate 與 send / queue / bot / receipt write false flags。治理頁只顯示 env ref 與脫敏內容，不顯示 chat id value、Bot token、工作視窗對話、未遮罩 runtime payload 或可執行修復指令。

## 5. Canary Approval Package

目前 canary package 狀態為 `blocked_until_explicit_approval`，package ready 但尚未批准。啟用前必須取得：

| 必填批准輸入 | 目的 |
|---|---|
| 統帥批准 canary 時間窗 | 避免非預期發送 |
| 單一訊息類型 | 限縮第一次實發範圍 |
| mute / rollback plan | 發生錯誤時可停止 |
| receipt readback owner | 明確誰驗證收到 |
| 失敗時停止條件 | 避免重試洗版 |

## 6. P2-405C Canary 發送批准包

目前 canary send approval packet 狀態為 `waiting_explicit_commander_approval`，`packet_ready=true`，但 `approval_granted=false`、`selected_message_type=not_selected`、`proposed_time_window=waiting_commander_input`。

| 必填項目 | 目前狀態 | 邊界 |
|---|---|---|
| 統帥批准 | waiting input | 未批准不得實發 |
| 單一訊息類型 | waiting input | 不允許一次開多種訊息 |
| 發送時間窗 | waiting input | 不允許無時間窗發送 |
| 目標 env ref | waiting input | 只顯示 env ref，不顯示 room value |
| mute / rollback plan | waiting input | 錯誤時可立即停止 |
| receipt readback owner | waiting input | 必須有人讀回驗證 |
| failure stop condition | waiting input | 任一失敗停止，不重試洗版 |

Canary 發送批准包固定 6 個停止條件、5 步 mute / rollback plan、6 個 receipt readback check；`canary_send_execution_enabled`、`gateway_queue_write_enabled`、`bot_api_call_enabled`、`delivery_receipt_write_enabled`、`production_write_enabled`、`secret_read_enabled`、`paid_api_enabled` 全部仍為 `false`。

## 7. P2-405D Canary Delivery Gate

目前 canary delivery gate 狀態為 `blocked_waiting_commander_delivery_fields`，`gate_ready=true`，但 `delivery_approved=false`、`delivery_attempt_allowed=false`、`selected_message_type=not_selected`、`approved_time_window=not_approved`、`target_room_verified=false`。

| 必填交付欄位 | 目前狀態 | 邊界 |
|---|---|---|
| 統帥批准本次 delivery | waiting input | 未批准不得交付 |
| 單一訊息類型 | waiting input | 不允許多訊息型別同時交付 |
| 交付時間窗 | waiting input | 無時間窗即 hold |
| 目標 env ref | waiting input | 只顯示 env ref，不顯示 room value |
| receipt readback owner | waiting input | 未指定 owner 即 hold |
| mute / rollback plan | waiting input | 錯誤時必須可停用 |
| failure stop condition | waiting input | 任一失敗停止，不重試洗版 |
| dry-run readback evidence ref | waiting input | 必須先有只讀證據 |

Canary delivery gate 固定 8 個 preflight check、7 個 hold reason、7 個 readback check 與 5 個 rollback / mute control；`live_delivery_enabled`、`gateway_queue_write_enabled`、`bot_api_call_enabled`、`delivery_receipt_write_enabled`、`production_write_enabled`、`secret_read_enabled`、`paid_api_enabled` 全部仍為 `false`。

## 8. P2-405E Canary Dry-run Delivery Rehearsal

目前 canary delivery rehearsal 狀態為 `ready_no_send_rehearsal`，`rehearsal_ready=true`，選定 `daily_agent_workload_digest` 作為第一個 dry-run 訊息。此 rehearsal 只產生 preview hash、dedup key 與 Gateway envelope preview，不寫 Gateway queue、不送 Telegram、不呼叫 Bot API、不寫 production receipt。

正式證據：feature commit `2500496f`，平行合併部署 commit `1b9d44cf`，deploy marker `f5be4cb8 chore(cd): deploy 1b9d44c [skip ci]`，Gitea code-review `3084` / CD `3083` success。Production API 回 current `P2-405E`、next `P2-405F`、overall `98%`，Hermes readback check `8 / 8`、failed check `0`；治理頁 desktop `1440x1000` 與 mobile `390x844` smoke 均確認 P2-405E、SRE_GROUP_CHAT_ID、AwoooI SRE 戰情室、preview hash、失敗檢查與不可誤讀文案可見，console error `0`、水平溢位 `0`、危險操作入口 `0`。

| 項目 | 值 | 邊界 |
|---|---|---|
| selected message | `daily_agent_workload_digest` | 只允許單一訊息型別 |
| selected preview | `p2_405b_preview_daily_agent_workload_digest_v1` | 必須對應 no-send preview |
| target room | `SRE_GROUP_CHAT_ID` | 只顯示 env ref，不顯示 chat id value |
| dedup key | `awoooi:agent-report:daily:2026-06-18:v1` | 單一 rehearsal window 使用 |
| readback owner | Hermes | 只做 dry-run readback drill |
| completed / failed checks | `8 / 0` | 失敗即回到 no-send preview |

Rehearsal 固定 6 個 dry-run step、8 個 readback check、7 個 stop condition 與 5 個 rollback / mute control；`live_delivery_enabled`、`gateway_queue_write_enabled`、`bot_api_call_enabled`、`telegram_send_enabled`、`delivery_receipt_write_enabled`、`production_write_enabled`、`secret_read_enabled`、`paid_api_enabled` 全部仍為 `false`。

## 9. P2-405F Canary Owner Review Gate

目前 canary live delivery owner review gate 狀態為 `ready_for_owner_review_no_send`，`gate_ready=true`，但 `owner_review_received=false`、`owner_review_accepted=false`、`live_canary_delivery_approved=false`、`delivery_attempt_allowed=false`。它承接 P2-405E rehearsal `8 / 8` readback 與 failed `0`，但只把證據推進到 owner review，不做任何實發。

| 項目 | 值 | 邊界 |
|---|---|---|
| selected message | `daily_agent_workload_digest` | 只允許單一訊息型別 |
| target room | `SRE_GROUP_CHAT_ID` | 只顯示 env ref，不顯示 chat id value |
| owner agent | `telegram_ops_liaison` | 只做 owner review gate |
| receipt owner | `hermes` | 只做 receipt readback plan |
| arbiter | `openclaw` | 仲裁是否可進下一關 |
| owner fields | `9` | 全部等待 owner response |
| acceptance checks | `9` | 未通過不得進 live canary |
| rejection reasons | `8` | 任一命中即退回 no-send |
| reviewer actions | `6` | 只能 approve next gate / request fix / reject / mute / manual review / hold |
| receipt checks | `8` | completed `0`、failed `0`，尚未讀正式 receipt |

Owner review gate 固定 `live_delivery_enabled`、`gateway_queue_write_enabled`、`bot_api_call_enabled`、`telegram_send_enabled`、`delivery_receipt_write_enabled`、`production_write_enabled`、`secret_read_enabled`、`paid_api_enabled` 全部為 `false`。P2-406B 才能進入 receipt readback owner review 正式驗證，仍不得直接實發。

正式驗證：redaction / i18n fix commit `795ed91f` 已推上 `gitea/main`，Gitea code-review run `3098` success；原 CD run `3097` 因平行 session 後續推送取消，最終以 deploy marker `e9cf0c35 chore(cd): deploy f6338b7 [skip ci]` 與 CD run `3103` success 收斂。Production API 回 current `P2-405F`、next `P2-406B`、overall `99%`；治理頁 desktop `1440x1100` 與 mobile `390x844` smoke 均確認 P2-405F owner review gate、`daily_agent_workload_digest`、`SRE_GROUP_CHAT_ID`、`receipt owner=hermes`、`Gateway 寫入=0`、`queue 寫入=false`、`Bot API=false`、`Telegram send=false`、`正式寫入=0` 可見，console error `0`、`MISSING_MESSAGE=0`、HTTP 4xx/5xx `0`、水平溢位 `0`、危險操作入口 `0`。

## 10. 專業任務總覽

| 領域 | 任務數 | 代表任務 | 主責 |
|---|---:|---|---|
| SRE / Observability | 4 | incident correlation、告警降噪、synthetic check、DB slow query triage | SRE Sentinel / QA |
| Security / IwoooS | 3 | public bundle redaction、secret metadata parity、owner response completeness | Security Sentinel |
| DevOps / Release | 4 | image digest pin、GitOps diff、gateway route impact、candidate PR draft | DevOps Commander |
| Data / Backup / DR | 3 | backup readiness、escrow evidence、data freshness | Data DR / Hermes |
| Supply Chain | 2 | CVE triage、SBOM/license drift | Supply Chain Scout |
| Product / UI / QA | 1 | mobile overflow、console、a11y regression | Product UI / QA |
| AI Governance / Replay / Market | 4 | market watch、NemoTron replay、cost forecast、runbook/postmortem | OpenClaw / NemoTron / Hermes |
| Telegram / Reports / Receipts | 3 | digest preview、report truth gate、post-action verifier | Telegram Ops / Hermes / OpenClaw |

## 11. 專業能力層級

| 層級 | AI Agent 可自動做 | Gate |
|---|---|---|
| 低風險 | 文件、報表、UI smoke、只讀摘要、truth gate | guard 後自動摘要 |
| 中風險 | proposal、no-write dry-run、PR 草案、Telegram preview | QA + OpenClaw 或 owner review |
| 高風險 | 只產批准包、rollback plan、failure-only digest 草案 | 統帥批准 |
| Critical | production write、kubectl、ArgoCD sync、Telegram 實發、secret、restore、host write | 預設 blocked |

## 12. MCP / RAG

首批 MCP：Gitea、Browser、Observability、Telegram Gateway、Package Registry、Database Readonly、Backup Status、ArgoCD Readonly、HTTP Probe、Fixture Store。

首批 RAG：LOGBOOK chunks、HARD_RULES / ADR chunks、Runbook chunks、Incident / alert traces、Agent market evidence、Owner response templates。

成長指標：KM entries、PlayBook updates、recommendations、replay score delta、blocked action prevented count、receipt missing count。

## 13. 邊界

- 不直接發 Telegram。
- 不寫 Telegram Gateway queue。
- 不呼叫 Bot API。
- 不讀 `TELEGRAM_BOT_TOKEN` 或任何機密明文。
- 不把工作視窗對話、未遮罩提示、私人推理或未遮罩 runtime payload 放進前端或 Telegram。
- 不做 production write、host write、kubectl、ArgoCD sync、restore、rollback、paid API、SDK install。

## 14. 下一步

1. P2-406B：以 P2-405F owner review gate 為基線，做 receipt readback owner review production verification。
2. P2-405G：canary 通過後才開日報 / 週報 / 月報 digest delivery。
3. P2-405H：Action-required digest 只對 failure / high-risk / approval-required 事件開啟。
4. P2-405H：把 receipt readback 與 report status board 串起來，但仍需 canary gate 後才能寫正式 receipt。
