Skill: mslchy/workspace-manage (version 1.0.0)

--- name: workspace-manager description: | 用于管理和维护 OpenClaw 工作区的结构。当用户提到工作区混乱、需要整理文件夹、或者希望建立标准目录结构时使用。提供自动归档、分类、清理和健康审计功能。 metadata: pattern: ["pipeline", "tool-wrapper"] --- ### Design Pattern 此技能使用 **Pipeline（流水线）模式** 来执行多步骤工作区管理，并通过 **Tool Wrapper（工具包装器）模式** 安全地封装文件系统操作。**优先调用配套脚本**，避免在 Prompt 中内联复杂 bash 命令，以控制 Token 成本并提升执行稳定性。 # Workspace Manager 此技能旨在保持工作区的整洁和高效，将人类文件与 Agent 文件分离，并提供一站式维护能力。 --- ## 标准目录结构 (Standard Structure) ``` ~/.openclaw/workspace/ ├── Workspace_Human/ # ❶ 供人类使用的文件（输入、输出、备份） │ ├── input/ # 用户提供或导入的原始文件 │ ├── output/ # 生成的产物（图片、PDF、文档） │ │ ├── images/ # 图片文件 │ │ ├── docs/ # 文档文件 (PDF, DOCX) │ │ └── data/ # 结构化数据 (JSON, CSV) │ ├── backup/ # 备份文件（手动 + 自动） │ └── temp/ # 临时文件（CDP 截图、缓存等，可安全清理） │ ├── Workspace_Agent/ # ❷ 供 Agent 之间交互的文件 │ ├── memory/ # 每日日志 (YYYY-MM-DD.md) + 长期记忆 │ ├── skills/ # 已安装的技能目录 │ ├── subagents/ # 永久子 agent 配置 │ ├── shared_context/ # 多 agent 共享上下文 │ ├── artifacts/ # 中间产物（构建产物、待整理文件） │ ├── cache/ # 可复用的缓存数据 │ ├── logs/ # 操作日志 │ ├── skills_custom/ # 自定义编写的技能 │ ├── prompts/ # 常用提示词模板 │ └── kb/ # Agent 知识库 │ ├── archive/ # 归档目录（按 YYYY-MM/ 组织） ├── scripts/ # 本地脚本（workspace-manager 专用） └── secret/ # 敏感凭据 ``` --- ## 核心文件保护（永不删除） 以下文件无论任何情况都受到保护： - `MEMORY.md`, `SOUL.md`, `USER.md`, `AGENTS.md`, `HEARTBEAT.md` - `.git/`, `memory/`, `skills/`, `subagents/`, `Workspace_Human/` --- ## Pipeline 工作流 **所有步骤均通过配套脚本执行**。推荐使用一键全量 Pipeline，复杂场景可单独触发某一阶段。 ### 推荐：一键全量 Pipeline ```bash # 执行完整 5 步流水线（Audit → Organize → Clean → Archive → Sync） bash {{SKILL_DIR}}/scripts/pipeline.sh --all # 仅预览（不实际执行任何写入操作） bash {{SKILL_DIR}}/scripts/pipeline.sh --all --dry-run # 执行指定步骤 bash {{SKILL_DIR}}/scripts/pipeline.sh audit organize ``` --- ### Step 1 — 健康审计 (Audit) ```bash bash {{SKILL_DIR}}/scripts/health-check.sh ``` 自动检查：断链、空目录、大文件(>10MB)、畸形命名、磁盘占用、最近活动。 输出 0-100 健康评分及分级建议。 ### Step 2 — 规范化 (Standardize) ```bash bash {{SKILL_DIR}}/scripts/standardize.sh ``` 确保标准目录结构完整，检测根目录散落文件并给出整理建议。 ### Step 3 — 自动整理 (Organize) ```bash bash {{SKILL_DIR}}/scripts/organize.sh ``` 将 `Workspace_Agent/artifacts/` 中的散落文件按类型移动到 `Workspace_Human/output/` 对应子目录： | 文件类型 | 目标位置 | |----------|----------| | `*.png`, `*.jpg`, `*.webp`, `*.gif` | `Workspace_Human/output/images/` | | `*.pdf`, `*.docx`, `*.doc` | `Workspace_Human/output/docs/` | | `*.json`, `*.csv`, `*.xml` | `Workspace_Human/output/data/` | | `*screenshot*`, `cdp_tmp_*`, `*.tmp` | `Workspace_Human/temp/` | ### Step 4 — 安全清理 (Clean) ```bash # 预览（默认，永远先预览） python3 {{SKILL_DIR}}/scripts/cleanup.py # 执行清理（移动到系统 trash，可恢复） python3 {{SKILL_DIR}}/scripts/cleanup.py --execute # 按条件清理 python3 {{SKILL_DIR}}/scripts/cleanup.py --min-age 30 --execute # 30天以上 python3 {{SKILL_DIR}}/scripts/cleanup.py --min-size 50 # >50MB ``` **保护规则**：永不删除 `.git/`、`memory/`、`skills/`、`Workspace_Human/`、最近 24h 文件及所有核心配置文件。 ### Step 5 — 归档 (Archive) ```bash # 交互式归档（7天以上文件，按月组织） bash {{SKILL_DIR}}/scripts/archive.sh # 自定义天数 DAYS=30 bash {{SKILL_DIR}}/scripts/archive.sh ``` 归档结构：`archive/YYYY-MM/`。仅处理 `Workspace_Agent/artifacts/`。 ### Step 5 — 云端同步 (Sync) ⭐ 可选扩展 ```bash bash {{SKILL_DIR}}/scripts/sync.sh ``` **此步骤为可选扩展**，需要 `gog` CLI 已安装并认证。未安装或未认证时自动跳过，不阻断其他 Pipeline 步骤。 **同步范围**（可通过 `config/sync-config.json` 配置开关）： - ✅ `Workspace_Human/` 全部内容 → Google Drive `AI_Workspace/Workspace_Human/` - ✅ `Workspace_Agent/` 全部内容 → Google Drive `AI_Workspace/Workspace_Agent/`（默认关闭） - ✅ 核心配置文件（MEMORY.md 等） → Google Drive `AI_Workspace_Backup/` **启用同步**：安装 `gog` CLI 并运行 `gog auth login` 即可自动启用。 **关闭同步**：删除 `gog` 或不运行 `gog auth login`，Pipeline 自动跳过此步骤。 --- ## 常用命令速查 | 任务 | 命令 | |------|------| | **一键全量** | `bash {{SKILL_DIR}}/scripts/pipeline.sh --all` | | 健康审计 | `bash {{SKILL_DIR}}/scripts/health-check.sh` | | 规范化 | `bash {{SKILL_DIR}}/scripts/standardize.sh` | | 整理文件 | `bash {{SKILL_DIR}}/scripts/organize.sh` | | 预览清理 | `python3 {{SKILL_DIR}}/scripts/cleanup.py` | | 执行清理 | `python3 {{SKILL_DIR}}/scripts/cleanup.py --execute` | | 归档旧文件 | `bash {{SKILL_DIR}}/scripts/archive.sh` | | 云端同步 | `bash {{SKILL_DIR}}/scripts/sync.sh` ⭐可选 | --- ## 目录命名规则 - **所有目录名**：kebab-case，无空格，无特殊字符 - 示例：`Workspace_Human`, `Workspace_Agent`, `shared_context`, `skills_custom` - **文件扩展名**：全部小写 ## 最佳实践 - **每次会话结束前**：`bash {{SKILL_DIR}}/scripts/pipeline.sh audit organize` - **每周定期维护**：`bash {{SKILL_DIR}}/scripts/pipeline.sh --all`（完整流水线） - **永远先预览再执行**：特别是 `cleanup.py`（默认就是预览模式） - **永远用 `trash` 代替 `rm`**：所有脚本均使用 `trash-put`，误删可从系统回收站恢复 - 引导用户将临时文件生成在 `Workspace_Agent/artifacts/`，会话结束后由 Pipeline 自动整理

path: config/sync-config.json
content: sync_human: yes
sync_agent: no
sync_backup: yes
output_folder: AI_Workspace
backup_folder: AI_Workspace_Backup
_comment: Set sync_human/sync_agent to true to enable, false to skip. Requires gog CLI installed and authenticated.

Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)