核心用法
workspace-standard 是一套面向 OpenClaw 代理的工作空间结构化规范，解决文件散落、信息膨胀、定位困难三大痛点。
典型使用场景：
1. 初始化新工作空间 — 运行 workspace-init.sh 创建标准目录树
2. 迁移扁平化文档 — 将 docs/ 下混乱文件按「角色」迁移至结构化布局
3. 新增项目 — 一键生成带 front-matter 的项目骨架
4. 日常维护 — 运行 workspace-audit.sh 检查健康度（staleness、预算超限、front-matter 缺失）
5. 决策支持 — 通过「Where to Write」表格快速确定信息归属
关键机制：
- Role Taxonomy（角色分类）：7 种角色（reference/plan/research/report/runbook/log/entity）决定文件存放位置与生命周期
- MEMORY.md 预算：硬性限制 ≤100 行，强制压缩当前状态，历史细节下沉至项目文件
- 自动化审计：exit code 即为问题数量，可集成 CI
显著优点
- 代理自洽：无需人工指示，代理通过 SKILL.md 自动理解「该写什么、写在哪」
- 可逆无锁：纯 Markdown + Bash，移除 skill 后文件仍可读
- 渐进迁移：支持存量工作空间逐步改造，非破坏性
- 可配置：
.workspace-standard.yml覆盖预算、过期天数、实体种子等默认值
潜在局限
- 人工前置成本：存量文件分类需人工介入（虽有决策树辅助）
- 无 IDE 集成：纯命令行工具，无图形化项目导航
- 依赖 Git：迁移流程推荐
git mv保历史，纯 SVN/Hg 环境体验降级 - 审计非实时：需主动触发脚本，无文件系统监听
适合人群
- 使用 OpenClaw 进行多项目长期协作的开发者/团队
- 受困于
MEMORY.md膨胀导致上下文窗口溢出的重度用户 - 需要从「对话式开发」过渡到「可审计知识沉淀」的组织
常规风险
| 风险项 | 说明 |
|--------|------|
| **误删风险** | `workspace-init.sh` 与 `workspace-audit.sh` 均为只读/创建操作，无删除逻辑，但用户误配 `.workspace-standard.yml` 可能导致预期外路径创建 |
| **预算硬截断** | MEMORY.md 超限时需人工修剪，脚本不会自动删除内容，存在「不处理则每次加载烧钱」的隐性成本 |
| **角色误判** | 文件角色分类依赖人工判断，错误归类会导致审计通过但信息检索失效 |
| **跨项目引用脆弱** | 路径硬编码于 front-matter 和 MEMORY.md，项目重命名需批量更新 |
> 注：安全认证报告显示为占位符，未执行实际扫描，建议团队自行 review scripts/ 目录下的 Bash 代码。