什么是Workspace Hygiene Publish
Workspace Hygiene 是一个专为智能体工作区设计的自动化维护工具，旨在确保每个代理（agent）的工作环境始终保持整洁、结构化且符合检索增强生成（RAG）的最佳实践。该工具通过系统性的审计流程，对工作区中的文件布局、记忆质量和项目文档进行全面检查，帮助开发者或团队维持高标准的知识管理效率。无论是个人开发还是多智能体协作场景，Workspace Hygiene 都能显著减少因混乱的文件组织导致的上下文丢失或信息检索失败问题。 该工具支持按需运行或配置为每周自动执行，灵活性极高。它首先读取工作区根目录下的 `STRUCTURE.md` 文件作为结构基准，随后逐项扫描是否存在违规情况，例如非标准配置文件散落于根目录、文件夹层级不符合规范、或文件被错误地放置在他人工作区内。同时，工具还会深入 `memory/` 目录，评估记忆文件的命名格式、日志连续性以及内容质量，防止过时或未整理的信息堆积成“数字垃圾”。此外，针对 `projects/` 下的每个子项目，Workspace Hygiene 会强制验证是否包含 `README.md` 文件——这是 RAG 系统能够有效索引项目上下文的关键前提。 最终，工具生成一份详尽的健康报告，汇总所有发现的问题，并按优先级提供修复建议。部分问题如时间戳命名的记忆文件可被自动合并优化，而其他如缺失的 README 或误放的文件则会被标记以待人工干预。这种“自动修复+人工审核”混合模式，既提升了效率，又保留了人类对语义内容的判断权。
核心功能特点
- 结构合规性审计：依据 `STRUCTURE.md` 检查文件位置与目录结构是否符合规范
- 记忆健康度评估：识别过期日志、日期断层及 MEMORY.md 超量问题
- 项目 README 完整性验证：确保每个项目均有可读性强的 README.md 供 RAG 检索
- 记忆条目格式校验：强制最近7天记忆使用标准化标签（[DECISION]/[FACT]等）
- 智能报告生成：输出带修复建议的结构化健康报告至 projects/system/ 下
- 混合处理策略：对可自动化问题直接修复，复杂问题仅标记待人工处理
适用场景
Workspace Hygiene 特别适合需要长期维护多个智能体协同工作的开发环境，尤其是在采用 RAG 架构的项目中。当多个代理各自负责不同模块时，若缺乏统一的文件管理规范，极易出现脚本错放、记忆混杂、项目文档缺失等问题，严重影响后续的知识回溯与上下文理解。此时，定期运行 Workspace Hygiene 可快速定位并纠正这些隐患，保障系统整体的知识一致性。 另一个典型应用场景是个人开发者频繁切换任务或进行实验性编码时。由于临时文件、测试代码和笔记容易堆积在根目录下，导致工作区迅速变得杂乱无章。借助该工具的结构审计功能，用户可以轻松发现并清理冗余文件，同时确保每日记忆记录按日期归档而非使用易混淆的时间戳格式。这不仅提升了本地开发体验，也为未来的知识复用打下坚实基础。 对于企业级 AI 系统开发团队而言，将 Workspace Hygiene 集成到 CI/CD 流程或智能体心跳机制中尤为实用。通过在 HEARTBEAT.md 中设置每周一自动执行，并结合 Steve（或其他负责人）定期审查 hygiene 报告，可实现被动式运维向主动式质量控制的转变。这种做法尤其适用于需要持续迭代模型能力、依赖高质量训练数据与记忆反馈闭环的场景。