核心功能
Workplace Skill 是一款面向复杂开发场景的项目工作空间管理工具，采用分层架构设计实现多项目、多Agent的精细化管控。其核心能力包括：
工作空间生命周期管理：通过 workplace init/scan/list/switch 等命令实现项目发现、初始化与快速切换，自动识别 .git 目录并支持父子层级嵌套。Colon 语法（parent:child）支持无需菜单导航的直接跳转。
多Agent Swarm 编排：每个工作空间拥有独立的 Agent 定义（.workplace/agents/*.md），支持 Kernel Agent 常驻运行，通过结构化协议（chat.md）实现 Agent 间通信，Rust 文件监听器实时捕获消息流转。
上下文隔离与同步：工作空间级隔离的记忆系统（memory/）、技能库（skills/）和部署配置（deploy/），同时通过 workplace sync 将上下文推送至 Cursor、Claude Code、OpenCode 等主流 IDE。
交互式多平台 UI：Telegram/Discord 平台支持内联按钮导航，WhatsApp/Signal fallback 至编号文本列表，实现无缝跨平台体验。
显著优点
- 真正的项目级隔离：不同于简单的目录切换，每个工作空间拥有独立的 Agent 集合、记忆容器和运行时状态，避免跨项目上下文污染
- 生产级 Agent 编排：Swarm 风格的 handoff 机制、持久化 Kernel Agent、结构化 inter-agent 通信协议，超越基础的 prompt 切换
- 开发者生态深度整合：原生支持 Cursor MDC、Claude Code、OpenCode 的上下文同步规则，降低工具链摩擦
- 可移植与可恢复：Export/Import 支持 ZIP 完整备份与 JSON 配置迁移，UUID 重新生成机制避免冲突
潜在局限
- Rust 服务器依赖：文件监听功能依赖平台特定二进制（
workplace-server-{os}-{arch}），非主流架构需手动编译 - 存储冗余：每个工作空间独立维护
memory/日志，高频项目可能导致~/.openclaw/workspace/体积膨胀 - Telegram 功能优先：交互式按钮体验在 Telegram/Discord 最佳，其他平台功能降级明显
- Agent 运行时耦合：Agent 启动依赖外部
sessions_spawn机制，非自包含实现
适合人群
- 同时维护 5+ 个代码库的资深开发者 / 技术负责人
- 需要为不同项目配置差异化 AI Agent 角色的团队
- 使用 Cursor/Claude Code/OpenCode 多 IDE 切换的跨工具开发者
- 追求"项目即容器"严格隔离的洁癖型工程师
常规风险
| 风险类别 | 描述 | 缓解措施 |
|---------|------|---------|
| 路径遍历 | `workplace switch` 等命令处理用户输入路径 | 路径规范化 + UUID 校验 |
| Agent 逃逸 | 子 Agent 可能访问父工作空间文件 | `.workplace/` 边界校验 + 沙箱建议 |
| 敏感信息泄露 | `memory/` 可能记录代码片段或密钥 | 敏感模式过滤 + export 排除规则 |
| 并发冲突 | 多会话同时修改 `current.json` | 文件锁机制（需底层实现验证） |
来源可信度说明
本技能文档结构完整、功能边界清晰，但安全认证报告显示为"系统自动生成占位，未执行安全扫描"，实际安全等级需待正式审计后确认。