Workspace Review 是一个基于 OpenClaw 规范的工作区自审计工具，旨在帮助开发者定期检查工作区文件的结构完整性与内容规范性。该工具适用于周期性维护、项目重构后的结构验证，或在收到“审查工作区”等指令时自动触发检查流程。通过系统化地核查关键文件的存佚、内容边界与组织逻辑，Workspace Review 能有效识别偏离标准模式的问题，确保工作区始终保持清晰、安全且高效的状态。 该审计过程覆盖多个维度：首先验证核心文件如 AGENTS.md、SOUL.md、USER.md、IDENTITY.md 和 TOOLS.md 是否存在于正确位置；其次审查每份文件是否严格遵循单一职责原则，防止功能交叉或信息错位；同时关注记忆管理实践，包括每日日志命名规范、参考文档命名方式以及敏感数据隔离情况。此外，工具还会检查工作区的 Git 状态，确认无未跟踪的机密文件、无长期滞留的未提交变更，并排除冗余或用途不明的“ rogue files”。 整个流程设计为自动化与人工审查相结合——系统可自动执行结构扫描与大小检测，而用户则需对内容质量进行判断。最终输出一份结构化报告，明确标注合规项、警告项与待修复问题，并提供具体改进建议，从而将抽象的规范要求转化为可操作的维护任务。
核心功能特点
- 验证工作区核心文件（AGENTS.md、SOUL.md 等）是否存在且位于正确路径
- 审计各文件内容是否符合其预设职责，避免功能重叠或信息错放
- 检查每日日志与参考文档的命名规范及向量索引配置
- 评估 Git 仓库状态，防范敏感信息泄露与未追踪文件风险
- 识别不符合标准布局的冗余文件或异常目录结构
- 监控关键文件大小，防止因过大影响会话加载性能
适用场景
Workspace Review 最适合在需要保证工作区长期稳定性的场景中使用，例如每周例行维护、重大代码库重组后快速回归正轨，或者在团队协作中被分配了‘审计’、‘检查结构’等任务时。它尤其适合那些依赖标准化文件体系来维持上下文一致性的开发环境，比如使用 OpenClaw 框架构建的智能体项目。 另一个典型应用场景是在启动阶段或心跳周期（heartbeat maintenance cycles）中运行，以确保每次重启网关后工作区仍处于健康状态。此时，BOOT.md 和 BOOTSTRAP.md 文件的行为差异尤为重要：前者是持久化的启动脚本，后者是一次性初始化指南，审计能准确区分二者用途，避免误删或重复执行。 对于那些频繁进行知识积累与沉淀的项目而言，Workspace Review 还能辅助优化记忆管理机制。例如，当系统自动触发会话压缩（session compaction）前，代理会收到提示将重要上下文写入 memory/YYYY-MM-DD.md，而审计则确保这些文件命名规范、内容精炼，且不会与 MEMORY.md 中的长期记忆产生重复。这不仅提升了向量检索效率，也保障了系统不会因信息冗余而陷入混乱。