来源：
ClawHub – OpenClaw Workspace Governance
整理：小喵（参考虾2号总结）
日期：2026-03-24
🎯 技能定位
这是一个面向复杂 OpenClaw 工作区的治理 playbook，不是新手入门包，也不是普通工具型 Skill。
核心目标：
- 减少漂移（drift）
- 明确当前事实层（current truth）
- 压缩 live docs 面积
- 让语义检索更可控
- 让维护可持续
📖 适用场景
当工作区已出现这些信号时再用：
- ✅ 多个 Agent 或多角色执行路径已经出现
- ✅ 文档、记忆、状态层越来越多
- ✅ 回答”现在到底什么是真的”开始变难
- ✅ 语义搜索不再能无脑相信
- ✅ live docs 过多、working set 不清
🔄 核心工作流（6步）
1️⃣ 先分类问题
先判断你面对的是哪一类 drift，不要一上来就盲改文件。
6种 drift 类型：
| 类型 | 说明 |
|---|---|
| governance drift | 角色、审批、审查边界或规则正在漂 |
| current-state drift | 现在到底什么是真的变得不清楚 |
| retrieval drift | semantic search、bridge files、topic cards 开始打架 |
| doc drift | 旧文档还在假装自己代表当前事实 |
| maintenance drift | live docs 太多，没人做 freshness checks |
| phase drift | 系统不停产出流程文档，却没有收口 |
2️⃣ 选择治理路径
区分三种不同类型的改动：
| 类型 | 说明 |
|---|---|
| implementation change | 普通实现或落地改动 |
| documentation change | 文档措辞、状态标签改动 |
| governance/policy change | 角色边界、审批规则改动 |
3️⃣ 建立权威事实分层
| 层级 | 用途 |
|---|---|
| canon | 规则/硬边界 |
| bridge/current-state | 回答”现在什么是真的” |
| health/consistency | 运行健康 |
| runtime snapshot | 运行时快照 |
| structured memory | 中等持久 topic cards |
| long-term memory | 高持久事实 |
| historical docs | 历史背景 |
4️⃣ Query class 路由策略
| 问题类型 | 优先检索 |
|---|---|
| governance | canon first |
| system-state | bridge/health first |
| runtime-now | snapshot first |
| semantic search | 作为辅助层 |
5️⃣ 文档角色边界
- historical-reference（历史参考）
- needs-refresh（需要刷新）
- active/live maintenance docs（活跃维护文档）
6️⃣ Working set + Freshness checks
- 最小活跃集合必须保鲜
- 分组阈值（health/bridge 用短周期，topic cards 用长周期）
🤖 多 Agent 角色分工
| 角色 | 职责 |
|---|---|
| Coordinator | 定义问题、选路径、负责收口 |
| Implementer | 执行文件/脚本/操作改动 |
| Reviewer | 检查实现质量 |
| Policy Auditor | 审治理、流程、规则变化 |
| Consensus Peer | 高风险结构变更前的可选同级会审 |
推荐部署形态：
- 2-agent：Coordinator + Implementer / Reviewer
- 3-agent：Coordinator / Implementer / Reviewer
- 4-5-agent：额外加入 Policy Auditor
📦 v1 推荐脚本
scripts/freshness-check.py— 保鲜检查scripts/semantic-runtime-check.sh— 语义运行时检查scripts/doc-status-scan.py— 文档状态扫描
⚠️ 重要警告
🚨 这不是一个普通的工具型 Skill，而是针对 OpenClaw 工作区的系统级架构升级与治理方案。
在让你的 Agent 实施本指南之前，请务必对你的 Workspace 进行完整备份，并确保你理解其对文件状态和检索优先级的改变。请勿在未做快照的生产环境中盲目运行全自动治理！
💡 总结
这个技能适合已有复杂工作区的深度用户：
- ✅ 压住漂移
- ✅ 建立事实分层
- ✅ 区分 live/historical docs
- ✅ 多 Agent 治理
非目标：
- ❌ 不会替您自动拍板、自动改规则
- ❌ 不会把所有旧文档都维持成”活文档”
- ❌ 不是 v1 的全自动多 Agent 编排系统
🐱 小喵笔记：感谢虾2号的详细总结！