personal-ai-operations-review · git:20260828.cf6f6b0 · 2026-08-28 · sha256 3e87e8159e45d676

personal-ai-operations-review git:20260828.cf6f6b0A

Immutable. This exact content is served forever at /api/v1/blob/3e87e8159e45d676.

---
name: personal-ai-operations-review
description: 对已进入 OPERATIONS MODE 的 Personal AI / DSH 基础设施做只读运维复查:聚合 governance、durability、aic drift、proposal、memory/model/routing 状态,区分 NO ACTION、REVIEW、ACTION REQUIRED 与 EXTERNAL BLOCKER;用于日常健康检查、异常复盘、升级前检查或用户询问“系统现在健康吗/需要管什么”时。默认不修改 canonical,不为变绿而静默修复。
---

# Personal AI 运维复查

## 适用范围

用于已经完成建设、进入 `OPERATIONS MODE` 的 Personal AI Infrastructure。目标是回答“系统现在是否正常、哪些问题需要人处理、哪些只是已知外部阻塞”。

优先复用现有 Control Plane、Governance、Durability、Memory、Model/Trace 和 Harness Adapter 的真实输出;不要重新实现底层检查。

## 不适用

- 不用于设计新的 Architecture Phase、重构 Control Plane、替换 MemoryProvider 或新增基础设施。
- 不用于直接批准 model admission、修改 routing/default model、删除 provider/plugin/memory、清 Git 历史或处理其他 canonical mutation。
- 不把 `BLOCKED`/`DEGRADED` 自动视为系统失败;先判断它是否是治理系统正确暴露的真实约束。
- 用户明确要求实施某个 change 时,先转入既有 `Need → Impact → Proposal → Implementation → Verification → Regression` 流程,不在本 Skill 内静默执行。

## 工作流程

1. **定位真实入口**
   - 找到 `agent-tools` 仓库根目录和当前分支/commit。
   - 优先读取 `docs/personal-ai-operations.md`、当前 Architecture/operations handoff 与仓库已有脚本说明。
   - 命令或路径不存在时标 `UNKNOWN`,先搜索仓库实际入口;不要凭旧报告猜路径。

2. **读取 Human-facing status**
   - 优先运行现有简版入口,例如:

     ```text
     python scripts/governance/personal_status.py
     ```

   - 再运行详细 governance status,例如:

     ```text
     python scripts/governance/gov_status.py
     ```

   - 记录每个域的 `HEALTHY / DEGRADED / BLOCKED / UNKNOWN` 及原因,不只记录总状态。

3. **验证 Control Plane 与 Harness drift**
   - 运行已有 `aic validate`。
   - 对当前已登记 Harness 逐个执行 `aic diff <target>`;至少覆盖 dsh/codex/claude/gemini/switchboard(若 registry 现状不同,以实际登记为准)。
   - 正常目标应为 `VALID / NO DRIFT`。发现 drift 时只报告 expected/actual/owner,不自动 apply。

4. **检查 Durability**
   - 读取现有 durability run ledger、RPO checker、计划任务最近状态与 latest verified backup。
   - 区分“计划任务成功”与“最近一次已验证备份仍在 RPO 内”;以后者为准。
   - 检查 repo durability 风险:unpushed commit、remote 不可达、privacy blocker。
   - `BACKUP_KEY_CUSTODY` 等已知外部条件必须保持原状态,不能为了总览变绿而改写。

5. **检查 Governance / Proposals**
   - 读取 outstanding proposals 与高严重度 findings。
   - 对 model admission、dead config、memory review、duplicate rule 等 proposal 判断是否已有足够新证据值得人工裁决。
   - `open proposal` 本身不等于故障;只有需要用户决策或风险升级时标 `REVIEW`/`ACTION REQUIRED`。

6. **检查 Memory / Model / Routing 信号**
   - Memory:scope pollution、schema/provenance、stale/review candidate、conflict/supersede 异常。
   - Model:provider reachability、request success、fallback 增多、identity `suspicious`、ADMISSION_GAP 新证据。
   - Routing:非法引用、fallback chain 异常、overlay 绕过治理。
   - 只引用现有治理证据;没有证据时写 `UNKNOWN`。

7. **分类行动**
   - `NO ACTION`:系统正常,或仅存在已知且无需当前处理的 blocker/proposal。
   - `REVIEW`:需要人工看证据并作裁决,但没有即时运行风险。
   - `ACTION REQUIRED`:出现新的真实故障、RPO breach、drift、secret/privacy 风险、scope pollution 等,应建立 Change Proposal。
   - `EXTERNAL BLOCKER`:需要当前系统外的条件(如 custody root、硬件、外部授权)才能关闭。

8. **需要修改时只产 Change Proposal**
   - 使用:`Need → Impact → Proposal → Implementation → Verification → Regression`。
   - 明确 affected SSOT、风险、验收、回滚与是否阻塞日常使用。
   - 除非用户在当前任务中明确要求实施,否则停止在 Proposal。

## 事实纪律

- 区分 `FACT / INFERENCE / USER-PROVIDED / UNKNOWN`。
- 以本次运行的命令、ledger、registry、trace、git 状态为事实;旧报告只作线索。
- `NO DRIFT` 只证明 canonical 与 live 一致,不证明 live runtime 一定有效;存在运行时健康信号时应交叉验证。
- 不为追求 `HEALTHY` 总状态隐藏 `BLOCKED_PRIVACY`、`WAITING_FOR_CUSTODY_ROOT`、`ADMISSION_GAP` 等真实状态。

## 输出契约

输出一个紧凑的 `PERSONAL_AI_OPERATIONS_REVIEW`:

```text
Overall: HEALTHY | DEGRADED | BLOCKED | UNKNOWN
Action: NO ACTION | REVIEW | ACTION REQUIRED | EXTERNAL BLOCKER

Infrastructure: <status + reason>
Control Plane: <status + reason>
Harnesses: <status + drift summary>
Models/Routing: <status + reason>
Memory/Projects: <status + reason>
Durability: <status + RPO/restore reason>
Governance: <status + proposal summary>
External Blockers: <list or none>

New findings:
- ...

Recommended next action:
- ...
```

如果 `Action = NO ACTION`,明确写“无需修改,继续正常使用”,然后停止,不主动提出新的架构优化。

如果 `Action = ACTION REQUIRED`,附一个最小 Change Proposal,但不要自行实施。

## 安全边界

- 默认只读;不调用 `aic apply`、不写 canonical、不 push、不 admit model、不删除 memory/config。
- 不输出 secret、token、decrypt key 或完整凭据。
- 不通过自动修复把真实异常变成绿色。
- 不新增 daemon、数据库、Harness 或外部通知服务。

## 验证

Skill 包自身按仓库契约验证:

```text
python scripts/validate_repo.py --strict
python skills/skill-quality-gate/scripts/quality_report.py --root . --strict
python -m unittest discover -s tests -v
```

实际运维复查至少要有:`personal_status/gov_status` 证据、`aic validate`、已登记 Harness 的 diff 状态、durability/RPO 证据、outstanding proposal 摘要和 `git status`。