同步四 Agent AI 自動化治理紀錄

docs/guides/ai_automation_session_sop.md

@@ -0,0 +1,41 @@
+# AI 自動化 Session SOP
+
+> 本文件是「可重複流程 guide」，用來取代本地 Skills / 私有 agent 腳本作為正式規範來源。若使用者要求更新 Skills，優先更新本 guide、相關 ADR、memory 與測試。
+
+## 入口讀取
+
+1. 讀 `AGENTS.md`。
+2. 讀 `CONSTITUTION.md` 第十三章與第十四章。
+3. 讀 `docs/adr/README.md`，命中後只開必要 ADR。
+4. AI 自動化任務預設命中：ADR-012、ADR-013、ADR-018。
+5. 讀 `docs/memory/README.md`，命中後讀 `ai_automation_closure_20260429.md`。
+6. 需要當前架構事實時讀 `docs/AI_INTELLIGENCE_MODULE_SOT.md`。
+
+## 四 Agent 分工
+
+| Agent | 任務 | 安全邊界 |
+|---|---|---|
+| Hermes | L1 摘要、規則降級、embedding、品質分數 | 不做外部副作用 |
+| NemoTron | L2 tool calling、低風險 action、DB/KM 派發 | 不動 prod 容器、不做不可逆操作 |
+| OpenClaw | L3 策略、報告、長期洞察、HITL 後建議 | 無人工核准不執行高風險動作 |
+| ElephantAlpha | Orchestration、HITL、AutoHeal bridge、受控 log scan | 不繞過 EventRouter / AutoHeal / ADR-011 |
+
+## 實作檢查
+
+- EventRouter 失敗時必須降級到 Hermes rule / L0 template，不可中斷通知。
+- Telegram 失敗必須可暫存與 replay。
+- L2 action 必須在 `SAFE_ACTIONS` 且可審計、可回放、低副作用。
+- AutoHeal 不得 restart / stop / recreate `momo-db` 或 `momo-postgres`。
+- raw `ai_insights` 寫入後必須 enqueue embedding；若 enqueue 失敗，必須可 backfill。
+- ElephantAlpha 的 code/resource action 必須橋接 AutoHeal，不直接執行危險副作用。
+- Code review auto-fix 預設關閉；critical/high 走 HITL。
+
+## 收尾 checklist
+
+- 相關測試至少覆蓋 EventRouter、AutoHeal、NemoTron fallback、OpenClaw embedding bridge、ElephantAlpha engine、agent_actions。
+- 若有架構決策，新增 ADR 並更新 `docs/adr/README.md`。
+- 若有長期實況，更新 `docs/memory/*.md` 與 `docs/memory/README.md`。
+- 若 AI 架構事實改變，更新 `docs/AI_INTELLIGENCE_MODULE_SOT.md`。
+- 若 Codex 工作規則改變，更新 `AGENTS.md`；若紅線改變，更新 `CONSTITUTION.md`。
+- 提交前跑 `git diff --check` 與相關 pytest。
+- 使用者要求推版時，commit 後 push 到遠端。

docs/guides/codex_agent_roles.md

@@ -9,6 +9,7 @@
 - 只有在任務明確分流、風險高、或需要獨立驗證時，才套用角色分工思維。
 - 角色說明用於規劃與 reviewer 心智模型，不代表一定要建立 12 個常駐子代理。
 - 若任務可以由一位 Codex 在單一上下文完成，優先不要切分。
+- AI 自動化任務若使用 12 角色思維，收尾必須至少經過 `critic`，並更新 ADR / memory / SOT / guide 的必要索引。
 
 ## 12 角色矩陣
 
@@ -92,6 +93,7 @@
 - 上線前一定要有 `critic`
 - 涉及安全加 `vuln-verifier`
 - 需要最新外部事實才叫 `web-researcher`
+- AI 自動化閉環任務收尾讀 `docs/guides/ai_automation_session_sop.md`
 
 ## 來源註記