安装工作树环境Skill install-worktree

---

name: install-worktree description: 设置隔离的Git工作树环境用于并行代理执行。在跨分支并行化代理时使用。 argument-hint: [工作树路径] [后端端口] [前端端口] allowed-tools: 读取、写入、Bash

安装工作树

设置隔离的Git工作树环境用于并行代理执行。

参数

• $1: 工作树路径（例如：trees/abc123）
• $2: 后端端口（例如：9105）
• $3: 前端端口（例如：9205）

指令

您正在为代理并行化设置隔离的工作树环境。

步骤 1: 验证参数

确保提供所有三个参数：

• 工作树路径：$1
• 后端端口：$2
• 前端端口：$3

如果缺少任何参数，报告需要的内容。

步骤 2: 创建端口配置

在工作树中创建 .ports.env 文件：

BACKEND_PORT=$2
FRONTEND_PORT=$3
VITE_BACKEND_URL=http://localhost:$2

步骤 3: 复制环境文件

复制主要环境文件并附加端口覆盖：

# 复制基础 .env
cp .env $1/.env

# 附加端口配置
cat $1/.ports.env >> $1/.env

如果有服务器特定的 .env，同样操作：

cp app/server/.env $1/app/server/.env
cat $1/.ports.env >> $1/app/server/.env

步骤 4: 更新 MCP 配置

如果 .mcp.json 存在，复制并更新路径：

1. 复制 .mcp.json 到工作树
2. 更新任何路径为工作树的绝对路径
3. 复制任何 MCP 相关配置（例如：playwright-mcp-config.json）

步骤 5: 安装依赖

后端：

cd $1/app/server && uv sync --all-extras

前端：

cd $1/app/client && bun install

步骤 6: 初始化数据库（如果适用）

如果有数据库重置脚本：

cd $1 && ./scripts/reset_db.sh

步骤 7: 验证安装

运行验证检查：

• [ ] 目录存在
• [ ] .ports.env 已创建
• [ ] .env 文件已配置
• [ ] 依赖已安装

输出

报告安装状态：

{
  "success": true,
  "worktree_path": "$1",
  "backend_port": $2,
  "frontend_port": $3,
  "steps_completed": ["ports", "env", "deps", "db"]
}

注意事项

• 使用确定性端口分配：slot = hash(adw_id) % 15
• 后端端口：9100-9114
• 前端端口：9200-9214
• 始终在配置中使用绝对路径