用途:初始化一个新的工作区配置,用于管理多个相关联的项目/仓库。当用户表达“setup workspace”“create workspace”“init workspace”等意图时使用。
主要能力:
- 交互式创建工作区,收集工作区名称、公司/项目名称和描述;
- 逐个项目收集名称、仓库 URL、本地路径、技术栈和开发端口,并在每步后显示摘要;
- 可选定义项目间依赖关系(如 frontend -> api)、文档链接和常用工作区级命令(如 start-all、stop-all、test-all);
- 自动检测本地已有仓库:先在当前目录及常见位置(~/Sites、~/work、~/projects、~/code、~/dev)查找与仓库名匹配的文件夹,找到则直接使用,未找到才询问克隆位置;
- 支持 GitHub MCP 集成,可自动获取用户仓库列表、搜索仓库并读取克隆地址、描述和默认分支,项目名默认使用真实仓库名;
- 支持 --from <url>,从 gist 或仓库 URL 拉取内容,按 WORKSPACE.md 格式解析并创建配置;
- 最终在 ~/.claude/workspaces/<name>/ 下生成 WORKSPACE.md,并可提示使用 /workspaces:clone all 克隆缺失仓库。
使用方式:依次完成检查 GitHub MCP、收集基本信息、添加项目、定义关系、添加文档链接、定义命令、生成配置、提供克隆八个步骤。
适用场景:需要统一管理多个相关仓库或服务的开发者,尤其适合已配置 GitHub MCP 的 Claude 用户。
限制:部分步骤(如依赖关系、文档链接、命令)为可选;本地路径自动检测效果取决于本机目录结构;GitHub MCP 和远程导入的具体可用性取决于环境;其余收费、平台支持等信息暂未提供。