来源： 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号的详细总结！