什么是Workspace Hygiene Publish
Workspace Hygiene 是一个专为智能体工作区设计的自动化维护工具，旨在确保所有代理（agent）的工作环境始终保持整洁、结构化且符合检索增强生成（RAG）的最佳实践。它通过定期或按需运行，对工作区中的文件布局、记忆质量和项目文档进行全面审计，帮助团队维持高效、可追踪的开发流程。该工具特别适用于多智能体协作系统，其中每个代理都有独立的工作空间，需要统一的标准和规范。
核心功能包括结构审计、记忆健康检查、项目 README 审核以及记忆格式验证。它会扫描工作区根目录下的 `STRUCTURE.md` 文件，识别出不符合规范的文件位置和文件夹结构；同时检查 `memory/` 目录中是否存在使用错误时间戳命名的记忆文件、超过30天未提炼的日志，以及日常记录中的日期空缺等问题。此外，工具还会验证最近七天的记忆条目是否遵循标准化的标签格式，如 [DECISION]、[FACT] 等，以确保信息可被正确索引和利用。
最终，Workspace Hygiene 会生成一份详细的健康报告，列出所有发现的问题及其严重程度，并提供具体的修复建议。对于某些可自动处理的问题（如将时间戳格式的记忆文件合并到对应日期文件中），工具会执行自动修复；而对于需要人工判断的情况（如缺失的项目 README 文件或未标记的记忆条目），则会明确标注并推荐下一步操作。这份报告保存在 `projects/system/hygiene-YYYY-MM-DD.md` 中，便于后续审查和跟进。
核心功能特点
- 结构审计：检查工作区是否符合 `STRUCTURE.md` 定义的规范，识别错位文件或违规文件夹
- 记忆健康监控：分析 `memory/` 目录中的日志完整性、时效性和格式一致性
- 项目 README 审核：确保每个项目文件夹都包含 `README.md` 以提升 RAG 检索效果
- 记忆格式校验：验证近期记忆条目是否使用标准标签（如 [DECISION]、[FACT]）进行标记
- 自动生成健康报告：汇总问题并提供优先级排序的修复建议，支持自动修复与人工干预结合
适用场景
Workspace Hygiene 最适用于需要长期维护多个智能体工作区的复杂 AI 系统开发场景。例如，在一个由多个专用代理（如 Claire、Maggie 等）协同工作的开放智能体框架中，每个代理都可能积累大量临时文件、分散的记忆片段或不完整的项目文档。随着时间推移，这些“技术债务”会显著降低系统的可维护性和上下文检索效率。此时，定期运行 Workspace Hygiene 可以自动清理冗余内容、统一命名规则，并强制补充关键文档，从而保持整个生态的健康状态。
另一个典型应用场景是团队协作开发中的知识沉淀过程。当多个开发者或智能体共同推进一个大型项目时，缺乏统一的文档标准和记忆管理会导致信息孤岛和重复劳动。通过集成 Workspace Hygiene，团队可以在每次迭代后快速审查工作区状态，确保所有决策、事实和项目进展都被妥善记录并打上标签。这不仅有助于新成员快速上手，也极大提升了跨代理的知识传递效率和系统整体的透明度。
此外，该工具特别适合那些依赖 RAG 技术进行上下文感知的智能体架构。由于 RAG 性能高度依赖于输入文档的结构化和语义清晰度，任何缺失的 README 文件或格式混乱的记忆条目都会削弱检索准确性。Workspace Hygiene 主动识别这些问题，并通过标准化流程加以纠正，从而直接提升智能体在对话、推理和任务执行中的表现。无论是日常运维还是项目收尾阶段，它都能作为一项轻量级但高效的“数字管家”，保障工作区的持续整洁与生产力。