# AI Agent Gitea PR 草案 Lane 工作報告

> 日期：2026-06-11（台北時間）
> 狀態：P2-402E 已完成；P2-402F / P2-402G 已接續完成；整體 AI Agent 主動營運與版本生命週期完成度 100%。
> 邊界：本文件與對應 API 只提供 Gitea PR 草案 lane，不 push branch、不建立或更新 Gitea PR、不留言、不 auto merge、不觸發 workflow、不改 CI、不寫 lockfile、不升級套件、不 build / pull image、不發 Telegram、不顯示工作視窗對話內容。

## 1. 本波完成項目

| 項目 | 狀態 | 產出 |
|---|---|---|
| Gitea PR 草案 lane schema | 完成 | `docs/schemas/ai_agent_gitea_pr_draft_lane_v1.schema.json` |
| Gitea PR 草案 lane snapshot | 完成 | `docs/evaluations/ai_agent_gitea_pr_draft_lane_2026-06-11.json` |
| API loader | 完成 | `apps/api/src/services/ai_agent_gitea_pr_draft_lane.py` |
| 只讀 API | 完成 | `GET /api/v1/agents/agent-gitea-pr-draft-lane` |
| 測試 | 完成 | loader / API / PR creation boundary / automerge boundary / blocking checks / owner response / transcript redaction |
| 主契約同步 | 完成 | `ai_agent_proactive_operations_contract_v1` 已由 P2-402G 推進到完成度 100%，current `P2-402G`，next `P2-403A` |

## 2. Grouping 規則摘要

| Group | 主責 Agent | 風險 | Max batch | 邊界 |
|---|---|---:|---:|---|
| 低風險依賴 patch 草案 | Hermes | medium | 5 | draft-only、automerge=false、需 OpenClaw review |
| CVE / OSV 修補草案 | OpenClaw | high | 2 | 不查外部 DB、不升級套件、不 hot patch |
| Container image digest / base image 草案 | Hermes | high | 2 | 不 build、不 pull、不改 kustomization image tag |
| AI Agent / model / tool contract 草案 | NemoTron + OpenClaw | critical | 1 | 需 sanitized replay gate，不開 shadow / canary |
| Host / K3s / stateful maintenance 草案 | OpenClaw | critical | 1 | 不 host upgrade、不 reboot、不 restart stateful service |
| 文件 / runbook / KM 草案 | Hermes | low | 8 | 不發布 canonical KM、不放 secret 或工作視窗內容 |

## 3. PR 前必備證據

| 類別 | 必備內容 |
|---|---|
| 測試 | schema / JSON、targeted tests、secret 與 transcript redaction |
| 風險 | blast radius、OpenClaw review、是否拆分 PR |
| Rollback | git revert、config recovery、runtime disable switch、smoke 失敗回退 |
| Owner response | owner、decision、business impact、risk acceptance、rollback acceptance、maintenance window、evidence ref |
| AI / model | sanitized replay gate、hidden-label grading、不得自行批准上線 |

## 4. Agent 分工

| Agent | 本波可做 | 本波不可做 |
|---|---|---|
| Hermes | 彙整 committed evidence、分組、release note、test plan、draft PR packet | push branch、建立 PR、觸發 workflow、寫 lockfile |
| OpenClaw | 仲裁風險、rollback、owner response、HITL、是否拆 PR | 自行批准、merge PR、runtime execution、production route change |
| NemoTron | 對 AI Agent / model / prompt / tool contract 變更提出 sanitized replay gate | 呼叫付費 API、外部 replay、shadow / canary、生產路由 |

## 5. 仍維持 false 的邊界

- `gitea_branch_push_allowed=false`
- `gitea_pr_creation_allowed=false`
- `gitea_pr_update_allowed=false`
- `gitea_pr_comment_allowed=false`
- `auto_merge_allowed=false`
- `workflow_trigger_allowed=false`
- `ci_workflow_change_allowed=false`
- `lockfile_write_allowed=false`
- `package_upgrade_allowed=false`
- `docker_build_allowed=false`
- `image_pull_allowed=false`
- `telegram_direct_send_allowed=false`
- `telegram_gateway_queue_write_allowed=false`
- `secret_plaintext_allowed=false`
- `conversation_transcript_allowed=false`

## 6. 下一步代辦

| 優先 | ID | 工作 | 完成標準 |
|---:|---|---|---|
| 1 | P2-402F | host OS / K3s / stateful services 版本只讀盤點 | 已完成；只讀 schema / snapshot / API / 測試，SSH / kubectl / upgrade / reboot 未啟用 |
| 2 | P2-402G | Governance UI 顯示可委派能力 | 已完成；前端顯示 autonomy level、gate、owner、Telegram policy，無執行按鈕 |
| 3 | P2-403A | Runtime gate planning | 排程、PR 草案、host probe 與 Telegram queue write 的逐項批准包 |
| 4 | 候選池 | Gitea bot / branch policy approval package | bot account、branch naming、PR permission、rollback、audit trail |
| 5 | 候選池 | Draft PR packet renderer | 把 grouping / test / rollback / owner response 轉為可審核 PR 草案，不呼叫 Gitea API |
