用途
本技能用于审计和优化 OpenClaw 工作区文档，重点查找冗余、合规问题、文件间冲突以及 token 使用效率低下的情况，并给出针对性修复建议，同时尽量不丢失原意、不破坏 agent 行为。
审计范围
可审计文件（均相对于工作区）：
- AGENTS.md：操作指令，每会话加载（系统提示），token 影响高，始终注入。
- SOUL.md：人格/语气，每会话加载（系统提示），token 影响高，始终注入。
- USER.md：用户档案，每会话加载（系统提示），token 影响高，始终注入。
- TOOLS.md：本地工具笔记，每会话加载（系统提示），token 影响高，始终注入。
- IDENTITY.md：agent 身份，每会话加载（系统提示），token 影响中等，文件较小。
- HEARTBEAT.md：心跳任务，每次心跳轮询加载，token 影响低，仅心跳时加载。
- BOOT.md：启动检查清单，网关重启（hooks）时加载，token 影响低，仅启动时加载。
- MEMORY.md：长期记忆，仅主会话加载，token 影响高。
- memory/*.md：每日日志，通过记忆工具按需加载，token 影响低，不会自动注入。
不在范围内：~/.openclaw/openclaw.json、~/.openclaw/skills/、会话记录、操作系统/主机安全（这些使用 healthcheck 技能）。
核心规则
- 默认只读。未经明确批准，永不修改文件。
- 只提议，不执行。展示确切的 diff/改写内容，等待用户同意。
- 保留语义。每次删除都必须证明含义被保留，或内容确实已无用。
- 每个决策点提供编号选项，用户可回复数字。
- 不自动排期。仅在审计完成后才提供 cron 排期。
工作流程
阶段 0：预检
确认工作区路径（默认：运行时元数据中的仓库根目录）。读取每个文件并记录：存在/缺失/行数/预估字符数。展示文件大小与 token 估算汇总表（约 4 字符/token）。询问要运行的审计范围（编号选项）：完整审计、token 瘦身、记忆清理、合规检查、单文件审计。
阶段 1：格式合规
将每个文件与官方模板 /opt/homebrew/lib/node_modules/openclaw/docs/reference/templates/<FILE>.md 对比。检查项包括：AGENTS.md 是否包含必需章节、记忆文件路径是否正确、引用是否正确；SOUL.md 是否定义人格边界、是否避免重复 AGENTS.md 的操作指令；USER.md 是否含 Name/Timezone/Notes、是否嵌入密钥；TOOLS.md 是否仅含环境特定笔记、是否重复 skill 内容；IDENTITY.md 字段与头像路径；HEARTBEAT.md 是否过长且任务可执行；BOOT.md 是否简短明确；MEMORY.md 是否仅主会话加载、是否含整理后的长期信息；memory/*.md 命名是否为 YYYY-MM-DD.md、是否有过期文件。每项发现以 ✅ 通过 / ⚠️ 警告 / ❌ 失败 加一行说明报告。
阶段 2：冗余与失效内容
扫描跨文件重复、文件内重复、失效引用、过时规则、陈旧的记忆条目。每项发现需报告：内容引用、位置（文件+行范围）、可移除原因、移除风险。
阶段 3：Token 效率
计算并报告：始终注入文件的每文件字符/token 估算；工作区文件带来的系统提示总开销；按 token 节省排序的缩减机会（压缩冗长说明、将示例/模板移到参考文件、移除无指令价值的注释、精简 markdown 格式开销）。给出变更前/后对比。
阶段 4：跨文件冲突检测
检查矛盾指令、角色越界（操作指令出现在 SOUL.md、人格规则出现在 AGENTS.md、工具笔记出现在 AGENTS.md）、记忆策略冲突、群聊规则冲突。
阶段 5：报告与整改
生成结构化报告，包含摘要、必须修复项、应修复项、优化机会表（变更/文件/token 节省/风险）、编号的推荐操作。报告后提供编号选项：应用全部安全变更、仅应用关键修复、导出计划、仅报告不操作。
阶段 6：执行（如获批准）
每项已批准变更先展示精确编辑（旧→新），通过 edit 工具做外科手术式修改而非整体重写；全部完成后重新计算 token 数并展示差值。
阶段 7：记忆清理（如范围包含记忆）
对 memory/ 目录列出所有文件及日期、大小；识别超过 30 天未提炼进 MEMORY.md 的文件；识别命名违规文件；提议归档或删除（永不自动删除，始终先询问）。对 MEMORY.md 检查被更新事实取代的条目、纯叙述性条目，提议精简。
需要标记的反模式
AGENTS.md 超过 300 行；SOUL.md 含操作指令；TOOLS.md 含通用技能文档；MEMORY.md 含原始每日日志；HEARTBEAT.md 超过 30 行；任意工作区文件含密钥/API key；memory/ 文件使用非日期文件名；AGENTS.md 与 SOUL.md 存在重复安全规则。
Token 预算参考
来自官方文档（bootstrapMaxChars 默认每文件 20,000；bootstrapTotalMaxChars 默认总计 150,000）：AGENTS.md 建议约 4,000 字符（约 1K token），SOUL.md 约 2,000 字符，USER.md 约 1,500 字符，TOOLS.md 约 3,000 字符，IDENTITY.md 约 500 字符，HEARTBEAT.md 约 500 字符，MEMORY.md 约 8,000 字符。这些是软目标而非硬限制，目的是保持意识而非强制执行。
记忆写入
审计完成后，若用户选择加入，将带日期的摘要追加到 memory/YYYY-MM-DD.md：审计的文件及大小、关键发现（问题数与节省 token 数）、已执行的操作、任何延期事项。仅追加，永不覆盖现有条目，敏感细节需脱敏。
排期
审计完成后，提供通过 cron 定期复审的选项（编号）：月度审计提醒（推荐）、每周审计提醒、不排期。使用固定 cron 名称 workspace-audit:periodic，创建前检查是否已有任务。