agent-governance

为 OpenClaw agent workspace 建立标准化的治理文件体系。

使用场景

1. 新建 agent workspace — 运行 agent-governance apply <workspace-path> 建立全套文件
2. 审计现有 agent — 运行 agent-governance audit <workspace-path> 检查缺失和违规
3. 用户要求设置/审计 — 执行上述流程

标准文件体系

MEMORY.md 标准结构

## Who / Identity (stable)
- Name / Role / Timezone / Vibe / Emoji / Purpose

## Memory Index
- projects: memory/projects.md — 每个项目按 Projects.md 模板记录
- lessons: memory/lessons.md
- daily logs: memory/YYYY-MM-DD.md

## Notes
- 🚫 禁止执行 `gateway stop` 命令
- ⚠️ 执行 `gateway restart` 前必须征得用户同意

AGENTS.md 标准章节

必须包含：

1. Every Session（启动顺序）
2. Responsiveness & Delegation Policy（>120秒 spawn sub-agent）
3. Red Lines（含 gateway stop/restart 两条禁止规则）
4. 4-Layer Memory System（标注按 Projects.md 模板记录）
5. Group Chats

apply 命令（创建/更新）

对指定 workspace 执行以下操作：

1. 检查目录结构

WS="$1"
mkdir -p "$WS/memory"

2. 从模板生成/更新文件

• MEMORY.md：用 references/MEMORY.md.template 生成，替换 [...] 占位符
• memory/projects.md：不存在则从 references/projects.md.template 创建
• memory/lessons.md：不存在则从 references/lessons.md.template 创建
• memory/YYYY-MM-DD.md：不存在则从 references/daily-log.md.template 创建，日期为当天
• AGENTS.md：不存在则从 references/AGENTS.md.template 创建；已存在则追加标准章节（不覆盖 agent 专属内容）

3. 追加而非覆盖原则

• 如果 AGENTS.md 已存在且有 agent 专属内容（Mission Control API / 任务流程等），不要覆盖
• 只需确保包含标准章节（Responsiveness / Red Lines / 4-Layer Memory）
• 如果缺少标准章节，插入到 "## Group Chats" 之前

audit 命令（检查合规）

对指定 workspace 执行：

1. 检查 MEMORY.md 是否存在且包含 Who/Identity + Memory Index + Notes（含 gateway 规则）
2. 检查 AGENTS.md 是否包含 Responsiveness + Red Lines（含 gateway 规则）+ 4-Layer Memory
3. 检查 memory/projects.md 是否存在
4. 检查 memory/lessons.md 是否存在
5. 检查 memory/ 目录是否有当日 YYYY-MM-DD.md

输出格式：

=== Audit: <workspace> ===
✅ MEMORY.md
❌ AGENTS.md — 缺少 Red Lines
✅ memory/projects.md
✅ memory/lessons.md
✅ memory/2026-03-26.md

新建 agent 完整流程

# 1. 创建 workspace 目录
mkdir -p ~/.openclaw/workspace-<agent-name>

# 2. 应用治理文件
agent-governance apply ~/.openclaw/workspace-<agent-name>

# 3. 填充 agent 专属内容（手动或通过对话）
# - 编辑 MEMORY.md：填入 Who / Identity
# - 编辑 AGENTS.md：在 "## [Agent 专属职责]" 下添加专属内容

模板文件

所有模板位于 references/ 目录：

• references/MEMORY.md.template
• references/AGENTS.md.template
• references/projects.md.template
• references/lessons.md.template
• references/daily-log.md.template

如需修改标准模板，编辑对应文件后重新 apply 即可。