feat: refactor sgclaw around zeroclaw compat runtime

third_party/zeroclaw/docs/i18n/zh-CN/reference/sop/observability.zh-CN.md

@@ -0,0 +1,39 @@
+# SOP 可观测性与审计
+
+本页面介绍 SOP 执行证据的存储位置以及如何检查它。
+
+## 1. 审计持久化
+
+SOP 审计条目通过 `SopAuditLogger` 持久化到配置的内存后端的 `sop` 类别下。
+
+常见键模式：
+
+- `sop_run_{run_id}`：运行快照（启动 + 完成更新）
+- `sop_step_{run_id}_{step_number}`：单步结果
+- `sop_approval_{run_id}_{step_number}`：操作员审批记录
+- `sop_timeout_approve_{run_id}_{step_number}`：超时自动审批记录
+
+## 2. 检查路径
+
+### 2.1 定义级 CLI
+
+```bash
+zeroclaw sop list
+zeroclaw sop validate [name]
+zeroclaw sop show <name>
+```
+
+### 2.2 运行时运行状态工具
+
+SOP 运行状态通过代理内工具查询：
+
+- `sop_status` — 活动/已完成运行和可选指标
+- 带 `include_gate_status: true` 的 `sop_status` — 信任阶段和门评估器状态（如果可用）
+- `sop_approve` — 批准等待的运行步骤
+- `sop_advance` — 提交步骤结果并推进运行
+
+## 3. 指标
+
+- 当 `[observability] backend = \"prometheus\"` 时，`/metrics` 暴露观察者指标。
+- 当前导出的名称是 `zeroclaw_*` 系列（通用运行时指标）。
+- SOP 特定的聚合可通过带 `include_metrics: true` 的 `sop_status` 获取。