yg-team-cli 2.7.1 → 2.8.0

package/dist/index.js

@@ -379,8 +379,8 @@ var init_utils = __esm({
        * 获取当前分支名
        */
       static async getCurrentBranch(cwd = process.cwd()) {
-        const { execa: execa5 } = await import("execa");
-        const { stdout } = await execa5("git", ["rev-parse", "--abbrev-ref", "HEAD"], {
+        const { execa: execa6 } = await import("execa");
+        const { stdout } = await execa6("git", ["rev-parse", "--abbrev-ref", "HEAD"], {
           cwd
         });
         return stdout.trim();
@@ -389,8 +389,8 @@ var init_utils = __esm({
        * 获取当前 commit hash
        */
       static async getCurrentCommit(cwd = process.cwd()) {
-        const { execa: execa5 } = await import("execa");
-        const { stdout } = await execa5("git", ["rev-parse", "HEAD"], { cwd });
+        const { execa: execa6 } = await import("execa");
+        const { stdout } = await execa6("git", ["rev-parse", "HEAD"], { cwd });
         return stdout.trim().slice(0, 7);
       }
     };
@@ -1007,22 +1007,22 @@ var init_gitlab_api = __esm({
        * 从 Git URL 中提取项目路径
        */
       static parseProjectPath(repository) {
-        let path22 = repository;
-        if (path22.startsWith("git@")) {
-          path22 = path22.replace(/^git@/, "");
-          const colonIndex = path22.indexOf(":");
+        let path26 = repository;
+        if (path26.startsWith("git@")) {
+          path26 = path26.replace(/^git@/, "");
+          const colonIndex = path26.indexOf(":");
           if (colonIndex !== -1) {
-            path22 = path22.substring(colonIndex + 1);
+            path26 = path26.substring(colonIndex + 1);
           }
         } else {
-          path22 = path22.replace(/^https?:\/\//, "");
-          const parts = path22.split("/");
+          path26 = path26.replace(/^https?:\/\//, "");
+          const parts = path26.split("/");
           if (parts.length > 1) {
-            path22 = parts.slice(1).join("/");
+            path26 = parts.slice(1).join("/");
           }
         }
-        path22 = path22.replace(/\.git$/, "");
-        return path22;
+        path26 = path26.replace(/\.git$/, "");
+        return path26;
       }
       /**
        * 编码项目路径用于 API 请求
@@ -1076,10 +1076,10 @@ var init_gitlab_api = __esm({
 // src/index.ts
 init_esm_shims();
 init_logger();
-import { Command as Command18 } from "commander";
+import { Command as Command19 } from "commander";
 import chalk4 from "chalk";
-import fs6 from "fs-extra";
-import path21 from "path";
+import fs9 from "fs-extra";
+import path25 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/commands/init.ts
@@ -4924,8 +4924,8 @@ var hotfixCommand = new Command6("hotfix").description("\u7D27\u6025\u4FEE\u590D
       {
         title: "\u521B\u5EFA hotfix \u5206\u652F",
         task: async () => {
-          const { execa: execa5 } = await import("execa");
-          await execa5("git", ["checkout", "-b", branchName], { stdio: "inherit" });
+          const { execa: execa6 } = await import("execa");
+          await execa6("git", ["checkout", "-b", branchName], { stdio: "inherit" });
         }
       },
       {
@@ -4949,9 +4949,9 @@ var hotfixCommand = new Command6("hotfix").description("\u7D27\u6025\u4FEE\u590D
       {
         title: "\u521B\u5EFA\u521D\u59CB commit",
         task: async () => {
-          const { execa: execa5 } = await import("execa");
-          await execa5("git", ["add", "docs/hotfixes"], { stdio: "pipe" });
-          await execa5(
+          const { execa: execa6 } = await import("execa");
+          await execa6("git", ["add", "docs/hotfixes"], { stdio: "pipe" });
+          await execa6(
             "git",
             [
               "commit",
@@ -6165,11 +6165,11 @@ async function verifyApiImplementationByPath(apiPath) {
     return { status: "pending" };
   }
   const method = apiMatch[1].toUpperCase();
-  const path22 = "/" + apiMatch[2];
+  const path26 = "/" + apiMatch[2];
   const controllerFiles = await FileUtils.findFiles("**/*Controller.java", "backend/src");
   for (const cf of controllerFiles) {
     const content = await FileUtils.read(cf);
-    if (content.includes(`"${path22}"`) || content.includes(`"${path22}/"`)) {
+    if (content.includes(`"${path26}"`) || content.includes(`"${path26}/"`)) {
       const annotationMap = {
         GET: ["@GetMapping", "@RequestMapping(method = RequestMethod.GET)"],
         POST: ["@PostMapping", "@RequestMapping(method = RequestMethod.POST)"],
@@ -7589,15 +7589,15 @@ async function syncTemplateVersions(aiMemoryFile, projectDir) {
   await replaceOrInsertSection(aiMemoryFile, "## \u6A21\u677F\u7248\u672C\u4FE1\u606F", newContent);
 }
 function extractRepoName(repository) {
-  let path22 = repository;
-  path22 = path22.replace(/^https?:\/\//, "");
-  path22 = path22.replace(/^git@/, "");
-  const parts = path22.split("/");
+  let path26 = repository;
+  path26 = path26.replace(/^https?:\/\//, "");
+  path26 = path26.replace(/^git@/, "");
+  const parts = path26.split("/");
   if (parts.length > 1) {
-    path22 = parts.slice(1).join("/");
+    path26 = parts.slice(1).join("/");
   }
-  path22 = path22.replace(/\.git$/, "");
-  return path22;
+  path26 = path26.replace(/\.git$/, "");
+  return path26;
 }
 
 // src/commands/check-api.ts
@@ -7912,10 +7912,10 @@ function extractApisFromRegistry(registryContent) {
   let match;
   while ((match = apiRegex.exec(registryContent)) !== null) {
     const method = match[1];
-    const path22 = match[2].trim();
+    const path26 = match[2].trim();
     const description = match[3].trim();
-    const key = `${method}:${path22}`;
-    apis.set(key, { method, path: path22, description });
+    const key = `${method}:${path26}`;
+    apis.set(key, { method, path: path26, description });
   }
   return apis;
 }
@@ -8570,9 +8570,9 @@ async function compareTemplate(projectPath, type, localConfig, remoteTag, remote
       }
     }
     if (!remoteCommit) {
-      const { execa: execa5 } = await import("execa");
+      const { execa: execa6 } = await import("execa");
       const ref = remoteTag || remoteBranch || "HEAD";
-      const { stdout } = await execa5("git", ["ls-remote", repository, ref], {
+      const { stdout } = await execa6("git", ["ls-remote", repository, ref], {
         stdio: "pipe"
       });
       remoteCommit = stdout.split("	")[0];
@@ -8728,10 +8728,2004 @@ var Table = class {
   }
 };
 
+// src/commands/dev-worktree.ts
+init_esm_shims();
+init_utils();
+init_logger();
+import { Command as Command18 } from "commander";
+import inquirer13 from "inquirer";
+import path24 from "path";
+
+// src/lib/worktree-manager.ts
+init_esm_shims();
+import { execa as execa5 } from "execa";
+import path21 from "path";
+import fs6 from "fs-extra";
+
+// src/types/worktree.ts
+init_esm_shims();
+var DEFAULT_WORKTREE_CONFIG = {
+  baseDir: "../wt/",
+  handoffDir: ".handoff/",
+  templateDir: ".handoff/templates/"
+};
+var DEFAULT_ROLES = [
+  {
+    role: "planner",
+    displayName: "Planner",
+    description: "\u9700\u6C42\u5206\u6790\u4E0E BDD \u573A\u666F\u8BBE\u8BA1",
+    branchPrefix: "feat",
+    worktreeSuffix: "planner",
+    required: true
+  },
+  {
+    role: "architect",
+    displayName: "Architect",
+    description: "\u6280\u672F\u67B6\u6784\u4E0E API \u8BBE\u8BA1",
+    branchPrefix: "feat",
+    worktreeSuffix: "arch",
+    required: true
+  },
+  {
+    role: "backend",
+    displayName: "Backend",
+    description: "\u540E\u7AEF\u5B9E\u73B0\u4E0E OpenAPI",
+    branchPrefix: "feat",
+    worktreeSuffix: "backend",
+    required: true
+  },
+  {
+    role: "frontend",
+    displayName: "Frontend",
+    description: "\u524D\u7AEF\u5B9E\u73B0",
+    branchPrefix: "feat",
+    worktreeSuffix: "frontend",
+    required: true
+  },
+  {
+    role: "qa",
+    displayName: "QA/BDD",
+    description: "BDD \u9A8C\u6536\u6D4B\u8BD5",
+    branchPrefix: "test",
+    worktreeSuffix: "qa",
+    required: true
+  },
+  {
+    role: "reviewer",
+    displayName: "Reviewer",
+    description: "\u4EE3\u7801\u5BA1\u67E5\u4E0E\u53D1\u5E03",
+    branchPrefix: "integration",
+    worktreeSuffix: "review",
+    required: true
+  }
+];
+
+// src/lib/worktree-manager.ts
+init_logger();
+var WorktreeManager = class {
+  repoRoot;
+  wtBaseDir;
+  roles;
+  constructor(repoRoot) {
+    this.repoRoot = repoRoot || process.cwd();
+    this.wtBaseDir = path21.resolve(this.repoRoot, DEFAULT_WORKTREE_CONFIG.baseDir);
+    this.roles = DEFAULT_ROLES;
+  }
+  /**
+   * 创建新的 Worktree 会话
+   */
+  async createSession(config) {
+    const { ticket, goal, baseBranch, enabledRoles } = config;
+    const enabled = enabledRoles || this.roles.map((r) => r.role);
+    logger.info(`\u521B\u5EFA Worktree \u4F1A\u8BDD: ${ticket}`);
+    logger.info(`\u76EE\u6807: ${goal}`);
+    logger.info(`\u57FA\u7840\u5206\u652F: ${baseBranch}`);
+    await fs6.ensureDir(this.wtBaseDir);
+    const worktrees = [];
+    for (const roleConfig of this.roles) {
+      if (!enabled.includes(roleConfig.role)) {
+        continue;
+      }
+      const wtName = `${roleConfig.worktreeSuffix}-${ticket}`;
+      const wtPath = path21.join(this.wtBaseDir, wtName);
+      const branchName = `${roleConfig.branchPrefix}/${ticket}-${roleConfig.worktreeSuffix}`;
+      const exists = await this.exists(wtName);
+      if (exists) {
+        logger.warn(`Worktree \u5DF2\u5B58\u5728: ${wtName}`);
+        worktrees.push({
+          role: roleConfig.role,
+          name: wtName,
+          path: path21.relative(this.repoRoot, wtPath),
+          branch: branchName,
+          status: "idle",
+          lastActivity: (/* @__PURE__ */ new Date()).toISOString()
+        });
+        continue;
+      }
+      try {
+        await this.create(wtName, branchName, baseBranch);
+        logger.success(`\u521B\u5EFA Worktree: ${wtName}`);
+        worktrees.push({
+          role: roleConfig.role,
+          name: wtName,
+          path: path21.relative(this.repoRoot, wtPath),
+          branch: branchName,
+          status: "idle",
+          lastActivity: (/* @__PURE__ */ new Date()).toISOString()
+        });
+      } catch (error) {
+        logger.error(`\u521B\u5EFA Worktree \u5931\u8D25: ${wtName}`);
+        throw error;
+      }
+    }
+    const sessionConfig = {
+      ticket,
+      goal,
+      baseBranch,
+      worktrees,
+      phase: "planning",
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    await this.saveSessionState(sessionConfig);
+    return sessionConfig;
+  }
+  /**
+   * 创建 worktree
+   */
+  async create(name, branch, baseBranch) {
+    const wtPath = path21.join(this.wtBaseDir, name);
+    if (await fs6.pathExists(wtPath)) {
+      logger.warn(`Worktree \u5DF2\u5B58\u5728\uFF0C\u5148\u5220\u9664: ${name}`);
+      await this.remove(name);
+    }
+    const args = ["worktree", "add", wtPath];
+    if (baseBranch) {
+      args.push(baseBranch);
+    } else {
+      args.push("-b", branch);
+    }
+    await this.runGitCommand(args);
+  }
+  /**
+   * 删除 worktree
+   */
+  async remove(name, force) {
+    const wtPath = path21.join(this.wtBaseDir, name);
+    if (!fs6.pathExists(wtPath)) {
+      logger.warn(`Worktree \u4E0D\u5B58\u5728: ${name}`);
+      return;
+    }
+    const args = force ? ["worktree", "remove", "--force", wtPath] : ["worktree", "remove", wtPath];
+    await this.runGitCommand(args);
+    logger.success(`\u5220\u9664 Worktree: ${name}`);
+  }
+  /**
+   * 列出所有 worktree
+   */
+  async list() {
+    const worktrees = [];
+    if (!fs6.pathExists(this.wtBaseDir)) {
+      return [];
+    }
+    const entries = await fs6.readdir(this.wtBaseDir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isDirectory()) {
+        continue;
+      }
+      const name = entry.name;
+      const wtPath = path21.join(this.wtBaseDir, name);
+      const isWorktree = await this.isWorktree(wtPath);
+      if (!isWorktree) {
+        continue;
+      }
+      const branch = await this.getBranch(wtPath);
+      const status = await this.getWorktreeStatus(wtPath);
+      worktrees.push({
+        role: this.extractRole(name),
+        name,
+        path: path21.relative(this.repoRoot, wtPath),
+        branch,
+        status,
+        lastActivity: await this.getLastActivity(wtPath)
+      });
+    }
+    return worktrees;
+  }
+  /**
+   * 切换到 worktree
+   */
+  async checkout(name) {
+    const wtPath = path21.join(this.wtBaseDir, name);
+    if (!fs6.pathExists(wtPath)) {
+      throw new Error(`Worktree \u4E0D\u5B58\u5728: ${name}`);
+    }
+    logger.info(`\u5207\u6362\u5230 Worktree: ${name}`);
+    logger.info(`\u8DEF\u5F84: ${wtPath}`);
+    logger.info("");
+    logger.info("\u8BF7\u5728\u65B0\u7684\u7EC8\u7AEF\u7A97\u53E3\u4E2D\u6267\u884C:");
+    logger.info(`  cd ${wtPath}`);
+    logger.info(`  git checkout ${await this.getBranch(wtPath)}`);
+    logger.info("");
+    logger.info("\u6216\u8005\u4F7F\u7528 IDE \u6253\u5F00\u8BE5\u76EE\u5F55\u7EE7\u7EED\u5F00\u53D1");
+  }
+  /**
+   * 切换到 worktree 并执行命令
+   */
+  async exec(name, command) {
+    const wtPath = path21.join(this.wtBaseDir, name);
+    if (!fs6.pathExists(wtPath)) {
+      throw new Error(`Worktree \u4E0D\u5B58\u5728: ${name}`);
+    }
+    return await this.runGitCommand(["-C", wtPath, ...command.split(" ")]);
+  }
+  /**
+   * 检查 worktree 是否存在
+   */
+  async exists(name) {
+    const wtPath = path21.join(this.wtBaseDir, name);
+    return this.isWorktree(wtPath);
+  }
+  /**
+   * 获取 worktree 路径
+   */
+  getPath(name) {
+    return path21.join(this.wtBaseDir, name);
+  }
+  /**
+   * 清理孤立 worktree
+   */
+  async prune() {
+    await this.runGitCommand(["worktree", "prune"]);
+    logger.success("\u6E05\u7406\u5B64\u7ACB worktree \u5B8C\u6210");
+  }
+  /**
+   * 获取会话状态
+   */
+  async getSessionState(ticket) {
+    const stateFile = this.getStateFilePath(ticket);
+    if (!fs6.pathExists(stateFile)) {
+      return null;
+    }
+    const content = await fs6.readFile(stateFile, "utf-8");
+    return JSON.parse(content);
+  }
+  /**
+   * 更新会话状态
+   */
+  async updateSessionState(ticket, updates) {
+    const state = await this.getSessionState(ticket);
+    if (!state) {
+      throw new Error(`\u4F1A\u8BDD\u4E0D\u5B58\u5728: ${ticket}`);
+    }
+    const updated = {
+      ...state,
+      ...updates,
+      lastActivity: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    await fs6.writeFile(
+      this.getStateFilePath(ticket),
+      JSON.stringify(updated, null, 2)
+    );
+  }
+  /**
+   * 获取指定角色的 worktree
+   */
+  async getWorktreeByRole(ticket, role) {
+    const state = await this.getSessionState(ticket);
+    if (!state) {
+      return null;
+    }
+    return state.worktrees.get(role) || null;
+  }
+  /**
+   * 初始化 handoff 目录
+   */
+  async initHandoffDirs(ticket) {
+    const handoffBase = path21.join(this.repoRoot, ".handoff", ticket);
+    const roles = this.roles.map((r) => r.role);
+    for (const role of roles) {
+      const roleDir = path21.join(handoffBase, role);
+      await fs6.ensureDir(roleDir);
+    }
+    const bddDir = path21.join(handoffBase, "planner", "BDD_FEATURES");
+    await fs6.ensureDir(bddDir);
+    logger.success(`\u521D\u59CB\u5316 handoff \u76EE\u5F55: ${handoffBase}`);
+  }
+  // ========== 私有方法 ==========
+  /**
+   * 运行 git 命令
+   */
+  async runGitCommand(args) {
+    try {
+      const result = await execa5("git", args, {
+        cwd: this.repoRoot,
+        stdio: "pipe"
+      });
+      return {
+        stdout: result.stdout || "",
+        stderr: result.stderr || "",
+        exitCode: result.exitCode || 0
+      };
+    } catch (error) {
+      return {
+        stdout: error.stdout || "",
+        stderr: error.stderr || error.message,
+        exitCode: error.exitCode || -1
+      };
+    }
+  }
+  /**
+   * 检查路径是否是有效的 worktree
+   */
+  async isWorktree(wtPath) {
+    const gitDir = path21.join(wtPath, ".git");
+    if (!fs6.pathExists(gitDir)) {
+      return false;
+    }
+    const stats = await fs6.stat(gitDir);
+    if (!stats.isFile()) {
+      return false;
+    }
+    const content = await fs6.readFile(gitDir, "utf-8");
+    return content.includes("gitdir:");
+  }
+  /**
+   * 获取 worktree 的分支
+   */
+  async getBranch(wtPath) {
+    const result = await this.runGitCommand(["-C", wtPath, "rev-parse", "--abbrev-ref", "HEAD"]);
+    return result.stdout.trim();
+  }
+  /**
+   * 获取 worktree 的状态
+   */
+  async getWorktreeStatus(wtPath) {
+    const status = await this.runGitCommand(["-C", wtPath, "status", "--porcelain"]);
+    if (status.stdout.trim()) {
+      return "active";
+    }
+    return "idle";
+  }
+  /**
+   * 获取最后活动时间
+   */
+  async getLastActivity(wtPath) {
+    const reflog = await this.runGitCommand(["-C", wtPath, "reflog", "-n", "1"]);
+    if (!reflog.stdout) {
+      return (/* @__PURE__ */ new Date()).toISOString();
+    }
+    const match = reflog.stdout.match(/HEAD@\{([^}]+)\}/);
+    if (match) {
+      return match[1];
+    }
+    return (/* @__PURE__ */ new Date()).toISOString();
+  }
+  /**
+   * 从 worktree 名称提取角色
+   */
+  extractRole(name) {
+    for (const roleConfig of this.roles) {
+      if (name.startsWith(roleConfig.worktreeSuffix)) {
+        return roleConfig.role;
+      }
+    }
+    return "backend";
+  }
+  /**
+   * 获取状态文件路径
+   */
+  getStateFilePath(ticket) {
+    return path21.join(this.repoRoot, ".handoff", `session-${ticket}.json`);
+  }
+  /**
+   * 保存会话状态
+   */
+  async saveSessionState(config) {
+    const stateFile = this.getStateFilePath(config.ticket);
+    const worktrees = /* @__PURE__ */ new Map();
+    for (const wt of config.worktrees) {
+      worktrees.set(wt.role, wt);
+    }
+    const sessionState = {
+      ticket: config.ticket,
+      currentPhase: config.phase,
+      completedPhases: [],
+      worktrees,
+      results: /* @__PURE__ */ new Map(),
+      gateStatuses: /* @__PURE__ */ new Map(),
+      startedAt: config.createdAt,
+      lastActivity: config.updatedAt
+    };
+    await fs6.ensureDir(path21.dirname(stateFile));
+    await fs6.writeFile(stateFile, JSON.stringify(sessionState, null, 2));
+  }
+};
+
+// src/lib/handoff-manager.ts
+init_esm_shims();
+import fs7 from "fs-extra";
+import path22 from "path";
+init_logger();
+var HandoffManager = class {
+  repoRoot;
+  handoffDir;
+  templateDir;
+  constructor(repoRoot) {
+    this.repoRoot = repoRoot || process.cwd();
+    this.handoffDir = path22.join(this.repoRoot, DEFAULT_WORKTREE_CONFIG.handoffDir);
+    this.templateDir = path22.join(this.repoRoot, DEFAULT_WORKTREE_CONFIG.templateDir);
+  }
+  /**
+   * 初始化交接物目录
+   */
+  async init(ticket, enabledRoles) {
+    const handoffBase = path22.join(this.handoffDir, ticket);
+    const roles = enabledRoles || ["planner", "architect", "backend", "frontend", "qa", "reviewer"];
+    logger.info(`\u521D\u59CB\u5316\u4EA4\u63A5\u7269\u76EE\u5F55: ${handoffBase}`);
+    for (const role of roles) {
+      const roleDir = path22.join(handoffBase, role);
+      await fs7.ensureDir(roleDir);
+    }
+    const bddDir = path22.join(handoffBase, "planner", "BDD_FEATURES");
+    await fs7.ensureDir(bddDir);
+    logger.success(`\u4EA4\u63A5\u7269\u76EE\u5F55\u5DF2\u521B\u5EFA: ${handoffBase}`);
+  }
+  /**
+   * 生成交接物清单
+   */
+  async generateManifest(ticket, phase) {
+    const handoffDir = path22.join(this.handoffDir, ticket);
+    const items = [];
+    const phaseItems = this.getRequiredItemsByPhase(phase);
+    for (const item of phaseItems) {
+      const filePath = path22.join(handoffDir, item.role, item.file);
+      items.push({
+        id: `${ticket}-${item.role}-${item.type}`,
+        role: item.role,
+        file: item.file,
+        type: item.type,
+        description: item.description,
+        status: fs7.pathExistsSync(filePath) ? "ready" : "pending",
+        requiredBy: item.requiredBy
+      });
+    }
+    const manifest = {
+      ticket,
+      phase,
+      fromRole: "system",
+      toRoles: items.map((i) => i.role),
+      items,
+      createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    await this.saveManifest(ticket, manifest);
+    return manifest;
+  }
+  /**
+   * 验证交接物完整性
+   */
+  async verify(ticket) {
+    const manifest = await this.loadManifest(ticket);
+    if (!manifest) {
+      return {
+        complete: false,
+        items: [],
+        missing: ["Manifest not found"]
+      };
+    }
+    const missing = [];
+    const handoffDir = path22.join(this.handoffDir, ticket);
+    for (const item of manifest.items) {
+      const filePath = path22.join(handoffDir, item.role, item.file);
+      if (!fs7.existsSync(filePath)) {
+        missing.push(`${item.role}/${item.file}`);
+        item.status = "pending";
+      } else {
+        item.status = "ready";
+      }
+    }
+    await this.saveManifest(ticket, manifest);
+    return {
+      complete: missing.length === 0,
+      items: manifest.items,
+      missing
+    };
+  }
+  /**
+   * 生成模板文件
+   */
+  async generateTemplate(ticket, role, templateType, data) {
+    const templatePath = path22.join(this.templateDir, `${templateType}.md`);
+    const outputPath = path22.join(this.handoffDir, ticket, role, `${templateType}.md`);
+    if (!fs7.existsSync(templatePath)) {
+      throw new Error(`\u6A21\u677F\u4E0D\u5B58\u5728: ${templatePath}`);
+    }
+    let content = await fs7.readFile(templatePath, "utf-8");
+    for (const [key, value] of Object.entries(data)) {
+      content = content.replace(new RegExp(`{{${key}}}`, "g"), value);
+    }
+    await fs7.ensureDir(path22.dirname(outputPath));
+    await fs7.writeFile(outputPath, content, "utf-8");
+    logger.success(`\u751F\u6210\u6A21\u677F: ${outputPath}`);
+    return outputPath;
+  }
+  /**
+   * 生成 OpenAPI 模板
+   */
+  async generateOpenAPITemplate(ticket, data) {
+    const templatePath = path22.join(this.templateDir, "API_OPENAPI.yaml");
+    const outputPath = path22.join(this.handoffDir, ticket, "backend", "API_OPENAPI.yaml");
+    if (!fs7.existsSync(templatePath)) {
+      throw new Error(`\u6A21\u677F\u4E0D\u5B58\u5728: ${templatePath}`);
+    }
+    let content = await fs7.readFile(templatePath, "utf-8");
+    for (const [key, value] of Object.entries(data)) {
+      content = content.replace(new RegExp(`{{${key}}}`, "g"), value);
+    }
+    await fs7.ensureDir(path22.dirname(outputPath));
+    await fs7.writeFile(outputPath, content, "utf-8");
+    logger.success(`\u751F\u6210 OpenAPI: ${outputPath}`);
+    return outputPath;
+  }
+  /**
+   * 生成 BDD Feature 模板
+   */
+  async generateBDDFeature(ticket, featureName, scenarios) {
+    const outputPath = path22.join(
+      this.handoffDir,
+      ticket,
+      "planner",
+      "BDD_FEATURES",
+      `${featureName}.feature`
+    );
+    const lines = [];
+    lines.push(`# language: zh-CN`);
+    lines.push(`@${ticket}`);
+    lines.push(`\u529F\u80FD: ${featureName}`);
+    lines.push("");
+    for (const scenario of scenarios) {
+      lines.push(`  \u573A\u666F: ${scenario.title} [${scenario.priority}]`);
+      for (const given of scenario.given) {
+        lines.push(`    \u5047\u5982 ${given}`);
+      }
+      for (const when of scenario.when) {
+        lines.push(`    \u5F53 ${when}`);
+      }
+      for (const then of scenario.then) {
+        lines.push(`    \u90A3\u4E48 ${then}`);
+      }
+      lines.push("");
+    }
+    await fs7.ensureDir(path22.dirname(outputPath));
+    await fs7.writeFile(outputPath, lines.join("\n"), "utf-8");
+    logger.success(`\u751F\u6210 BDD Feature: ${outputPath}`);
+    return outputPath;
+  }
+  /**
+   * 获取交接物清单
+   */
+  async loadManifest(ticket) {
+    const manifestPath = path22.join(this.handoffDir, ticket, "MANIFEST.json");
+    if (!fs7.existsSync(manifestPath)) {
+      return null;
+    }
+    const content = await fs7.readFile(manifestPath, "utf-8");
+    return JSON.parse(content);
+  }
+  /**
+   * 保存交接物清单
+   */
+  async saveManifest(ticket, manifest) {
+    const manifestPath = path22.join(this.handoffDir, ticket, "MANIFEST.json");
+    await fs7.ensureDir(path22.dirname(manifestPath));
+    await fs7.writeFile(manifestPath, JSON.stringify(manifest, null, 2), "utf-8");
+  }
+  /**
+   * 标记交接物已验证
+   */
+  async markVerified(ticket, file, verifiedBy) {
+    const manifest = await this.loadManifest(ticket);
+    if (!manifest) {
+      throw new Error(`Manifest not found: ${ticket}`);
+    }
+    for (const item of manifest.items) {
+      if (item.file === file) {
+        item.status = "verified";
+        item.verifiedBy = verifiedBy;
+        item.verifiedAt = (/* @__PURE__ */ new Date()).toISOString();
+        break;
+      }
+    }
+    await this.saveManifest(ticket, manifest);
+  }
+  /**
+   * 获取指定角色的交接物
+   */
+  async getRoleHandoffs(ticket, role) {
+    const roleDir = path22.join(this.handoffDir, ticket, role);
+    if (!fs7.existsSync(roleDir)) {
+      return [];
+    }
+    const files = await fs7.readdir(roleDir);
+    return files.filter((f) => f.endsWith(".md") || f.endsWith(".yaml") || f.endsWith(".json"));
+  }
+  /**
+   * 获取交接物摘要
+   */
+  async getSummary(ticket) {
+    const manifest = await this.loadManifest(ticket);
+    if (!manifest) {
+      return {
+        total: 0,
+        ready: 0,
+        pending: 0,
+        verified: 0,
+        byRole: {
+          planner: 0,
+          architect: 0,
+          backend: 0,
+          frontend: 0,
+          qa: 0,
+          reviewer: 0
+        }
+      };
+    }
+    const summary = {
+      total: manifest.items.length,
+      ready: 0,
+      pending: 0,
+      verified: 0,
+      byRole: {
+        planner: 0,
+        architect: 0,
+        backend: 0,
+        frontend: 0,
+        qa: 0,
+        reviewer: 0
+      }
+    };
+    for (const item of manifest.items) {
+      if (item.status === "ready" || item.status === "verified") {
+        summary.ready++;
+      }
+      if (item.status === "pending") {
+        summary.pending++;
+      }
+      if (item.status === "verified") {
+        summary.verified++;
+      }
+      summary.byRole[item.role]++;
+    }
+    return summary;
+  }
+  /**
+   * 根据阶段获取所需的交接物列表
+   */
+  getRequiredItemsByPhase(phase) {
+    const items = [];
+    if (phase === "planning" || phase === "all") {
+      items.push(
+        { role: "planner", file: "SPEC.md", type: "spec", description: "\u529F\u80FD\u89C4\u683C\u6587\u6863", requiredBy: ["architect", "backend", "frontend"] },
+        { role: "planner", file: "TASKS.md", type: "tasks", description: "\u4EFB\u52A1\u62C6\u5206", requiredBy: ["architect", "backend", "frontend"] },
+        { role: "planner", file: "BDD_FEATURES/*.feature", type: "feature", description: "BDD \u573A\u666F", requiredBy: ["qa"] },
+        { role: "planner", file: "BDD_TRACEABILITY.md", type: "bdd", description: "BDD \u8FFD\u6EAF\u77E9\u9635", requiredBy: ["qa"] }
+      );
+    }
+    if (phase === "architecture" || phase === "all") {
+      items.push(
+        { role: "architect", file: "ADR.md", type: "adr", description: "\u67B6\u6784\u51B3\u7B56\u8BB0\u5F55", requiredBy: ["backend"] },
+        { role: "architect", file: "API_RULES.md", type: "api", description: "API \u8BBE\u8BA1\u89C4\u5219", requiredBy: ["backend", "frontend"] },
+        { role: "architect", file: "MODULE_OWNERSHIP.md", type: "other", description: "\u6A21\u5757\u5F52\u5C5E", requiredBy: ["backend", "frontend"] },
+        { role: "architect", file: "IMPACT.md", type: "other", description: "\u5F71\u54CD\u9762\u8BC4\u4F30", requiredBy: ["reviewer"] }
+      );
+    }
+    if (phase === "openapi" || phase === "all") {
+      items.push(
+        { role: "backend", file: "API_OPENAPI.yaml", type: "openapi", description: "OpenAPI \u89C4\u8303", requiredBy: ["frontend", "qa"] },
+        { role: "backend", file: "API_EXAMPLES.md", type: "api", description: "API \u793A\u4F8B", requiredBy: ["frontend"] },
+        { role: "backend", file: "MOCK_GUIDE.md", type: "other", description: "Mock \u4F7F\u7528\u6307\u5357", requiredBy: ["frontend"] }
+      );
+    }
+    if (phase === "implementation" || phase === "all") {
+      items.push(
+        { role: "backend", file: "CHANGELOG_BACKEND.md", type: "changelog", description: "\u540E\u7AEF\u53D8\u66F4\u65E5\u5FD7", requiredBy: ["reviewer"] },
+        { role: "backend", file: "TESTING_BACKEND.md", type: "testing", description: "\u540E\u7AEF\u6D4B\u8BD5\u62A5\u544A", requiredBy: ["qa"] },
+        { role: "frontend", file: "CHANGELOG_FRONTEND.md", type: "changelog", description: "\u524D\u7AEF\u53D8\u66F4\u65E5\u5FD7", requiredBy: ["reviewer"] },
+        { role: "frontend", file: "TESTING_FRONTEND.md", type: "testing", description: "\u524D\u7AEF\u6D4B\u8BD5\u62A5\u544A", requiredBy: ["qa"] }
+      );
+    }
+    if (phase === "bdd" || phase === "all") {
+      items.push(
+        { role: "qa", file: "BDD_RUN_GUIDE.md", type: "report", description: "BDD \u6267\u884C\u6307\u5357", requiredBy: [] },
+        { role: "qa", file: "BDD_REPORT.md", type: "report", description: "BDD \u9A8C\u6536\u62A5\u544A", requiredBy: ["reviewer"] },
+        { role: "qa", file: "REGRESSION.md", type: "report", description: "\u56DE\u5F52\u6E05\u5355", requiredBy: ["qa"] }
+      );
+    }
+    if (phase === "integration" || phase === "all") {
+      items.push(
+        { role: "reviewer", file: "REVIEW.md", type: "review", description: "\u5BA1\u67E5\u62A5\u544A", requiredBy: [] },
+        { role: "reviewer", file: "RELEASE.md", type: "release", description: "\u53D1\u5E03\u65B9\u6848", requiredBy: [] },
+        { role: "reviewer", file: "ROLLBACK.md", type: "rollback", description: "\u56DE\u6EDA\u65B9\u6848", requiredBy: [] }
+      );
+    }
+    return items;
+  }
+};
+function createHandoffManager(repoRoot) {
+  return new HandoffManager(repoRoot);
+}
+
+// src/lib/concurrent-executor.ts
+init_esm_shims();
+import { spawn } from "child_process";
+import path23 from "path";
+import fs8 from "fs-extra";
+
+// src/lib/role-prompts.ts
+init_esm_shims();
+var PLANNER_PROMPT = {
+  role: "planner",
+  displayName: "Planner",
+  systemPrompt: `\u4F60\u662F Product Planner\uFF0C\u8D1F\u8D23\u9700\u6C42\u5206\u6790\u548C BDD \u573A\u666F\u8BBE\u8BA1\u3002
+
+\u4F60\u7684\u804C\u8D23\uFF1A
+1. \u5206\u6790 PRD\uFF0C\u7F16\u5199 SPEC.md
+2. \u62C6\u89E3\u4EFB\u52A1\uFF0C\u7F16\u5199 TASKS.md
+3. \u7F16\u5199 BDD \u573A\u666F\uFF08Gherkin \u683C\u5F0F\uFF09
+4. \u521B\u5EFA BDD_TRACEABILITY.md
+
+\u91CD\u8981\u89C4\u5219\uFF1A
+- \u53EA\u8F93\u51FA\u6587\u6863\uFF0C\u4E0D\u8981\u5199\u4E1A\u52A1\u4EE3\u7801
+- BDD \u573A\u666F\u5FC5\u987B Given/When/Then \u5B8C\u6574
+- \u573A\u666F\u5FC5\u987B\u53EF\u6D4B\u8BD5\u3001\u65E0\u6B67\u4E49
+
+\u5F53\u524D\u4EFB\u52A1\uFF1A
+- TICKET: {{TICKET}}
+- \u76EE\u6807: {{GOAL}}
+- \u7EA6\u675F: {{CONSTRAINTS}}`,
+  taskPrompt: `\u8BF7\u4E3A\u4EE5\u4E0B\u4EFB\u52A1\u521B\u5EFA\u9700\u6C42\u6587\u6863\uFF1A
+
+## TICKET
+{{TICKET}}
+
+## \u76EE\u6807
+{{GOAL}}
+
+## \u7EA6\u675F
+{{CONSTRAINTS}}
+
+## \u5DF2\u6709\u4FE1\u606F
+{{CONTEXT}}
+
+\u8BF7\u8F93\u51FA\u4EE5\u4E0B\u6587\u6863\uFF08\u653E\u5728 .handoff/{{TICKET}}/planner/ \u76EE\u5F55\uFF09\uFF1A
+
+1. **SPEC.md** - \u529F\u80FD\u89C4\u683C\u6587\u6863
+   - \u76EE\u6807\u4E0E\u975E\u76EE\u6807
+   - \u8303\u56F4\u4E0E\u7EA6\u675F
+   - \u9A8C\u6536\u6807\u51C6\uFF08\u81F3\u5C11 5 \u6761\uFF09
+   - \u4F9D\u8D56\u5173\u7CFB
+
+2. **TASKS.md** - \u4EFB\u52A1\u62C6\u5206
+   - \u6309\u9636\u6BB5\u62C6\u5206\u4EFB\u52A1
+   - \u6807\u6CE8\u6BCF\u4E2A\u4EFB\u52A1\u7684 Owner
+   - \u5173\u8054 BDD \u573A\u666F
+
+3. **BDD_FEATURES/*.feature** - BDD \u573A\u666F
+   - \u4E3B\u8DEF\u5F84\u573A\u666F\uFF08Must\uFF09
+   - \u5F02\u5E38\u8DEF\u5F84\u573A\u666F\uFF08Should\uFF09
+   - \u8FB9\u754C\u573A\u666F\uFF08May\uFF09
+
+4. **BDD_TRACEABILITY.md** - \u8FFD\u6EAF\u77E9\u9635
+   - \u9A8C\u6536\u6807\u51C6 \u2194 BDD \u573A\u666F \u2194 \u4EFB\u52A1`,
+  outputFormat: `\u8BF7\u8F93\u51FA\u5B8C\u6574\u7684\u6587\u6863\u5185\u5BB9\uFF0CMarkdown \u683C\u5F0F\u3002`
+};
+var ARCHITECT_PROMPT = {
+  role: "architect",
+  displayName: "Architect",
+  systemPrompt: `\u4F60\u662F System Architect\uFF0C\u8D1F\u8D23\u6280\u672F\u67B6\u6784\u8BBE\u8BA1\u3002
+
+\u4F60\u7684\u804C\u8D23\uFF1A
+1. \u7F16\u5199 ADR\uFF08\u67B6\u6784\u51B3\u7B56\u8BB0\u5F55\uFF09
+2. \u5B9A\u4E49 API \u89C4\u5219\uFF08\u9519\u8BEF\u7801\u3001\u9274\u6743\u3001\u5206\u9875\u7B49\uFF09
+3. \u5212\u5206\u6A21\u5757\u8FB9\u754C
+4. \u8BC4\u4F30\u5F71\u54CD\u9762\u548C\u98CE\u9669
+
+\u91CD\u8981\u89C4\u5219\uFF1A
+- \u53EA\u8F93\u51FA\u8BBE\u8BA1\u6587\u6863\uFF0C\u4E0D\u8981\u5199\u5B9E\u73B0\u4EE3\u7801
+- API \u89C4\u5219\u5FC5\u987B\u5B8C\u6574\u3001\u53EF\u6267\u884C
+- \u6A21\u5757\u8FB9\u754C\u5FC5\u987B\u6E05\u6670\uFF0C\u907F\u514D\u51B2\u7A81
+
+\u5F53\u524D\u4EFB\u52A1\uFF1A
+- TICKET: {{TICKET}}
+- \u76EE\u6807: {{GOAL}}`,
+  taskPrompt: `\u8BF7\u4E3A\u4EE5\u4E0B\u4EFB\u52A1\u521B\u5EFA\u67B6\u6784\u6587\u6863\uFF1A
+
+## TICKET
+{{TICKET}}
+
+## \u76EE\u6807
+{{GOAL}}
+
+## \u5DF2\u6709\u6587\u6863
+\u8BF7\u5148\u9605\u8BFB\uFF1A.handoff/{{TICKET}}/planner/SPEC.md
+
+\u8BF7\u8F93\u51FA\u4EE5\u4E0B\u6587\u6863\uFF08\u653E\u5728 .handoff/{{TICKET}}/architect/ \u76EE\u5F55\uFF09\uFF1A
+
+1. **ADR.md** - \u67B6\u6784\u51B3\u7B56\u8BB0\u5F55
+   - \u5173\u952E\u6280\u672F\u51B3\u7B56
+   - \u51B3\u7B56\u7406\u7531
+   - \u9884\u671F\u540E\u679C
+
+2. **API_RULES.md** - API \u8BBE\u8BA1\u89C4\u5219
+   - \u9519\u8BEF\u7801\u89C4\u8303
+   - \u9274\u6743\u7B56\u7565
+   - \u5206\u9875\u89C4\u5219
+   - \u5E42\u7B49\u6027
+   - \u7248\u672C\u517C\u5BB9
+
+3. **MODULE_OWNERSHIP.md** - \u6A21\u5757\u5F52\u5C5E
+   - \u76EE\u5F55\u7ED3\u6784
+   - \u53D8\u66F4\u8FB9\u754C
+   - \u8C01\u80FD\u6539\u4EC0\u4E48
+
+4. **IMPACT.md** - \u5F71\u54CD\u9762\u8BC4\u4F30
+   - \u53D7\u5F71\u54CD\u6A21\u5757
+   - \u6F5C\u5728\u98CE\u9669
+   - \u56DE\u6EDA\u7B56\u7565`,
+  outputFormat: `\u8BF7\u8F93\u51FA\u5B8C\u6574\u7684\u6587\u6863\u5185\u5BB9\uFF0CMarkdown \u683C\u5F0F\u3002`
+};
+var BACKEND_PROMPT = {
+  role: "backend",
+  displayName: "Backend Developer",
+  systemPrompt: `\u4F60\u662F Backend Developer\uFF0C\u8D1F\u8D23\u540E\u7AEF\u5B9E\u73B0\u3002
+
+\u4F60\u7684\u804C\u8D23\uFF1A
+1. \u7F16\u5199 OpenAPI \u89C4\u8303
+2. \u5B9E\u73B0 API Mock \u670D\u52A1
+3. \u5B9E\u73B0\u771F\u5B9E\u540E\u7AEF\u4EE3\u7801
+4. \u7F16\u5199\u5355\u5143\u6D4B\u8BD5
+
+\u91CD\u8981\u89C4\u5219\uFF1A
+- \u5FC5\u987B\u5148\u5B8C\u6210 OpenAPI + Mock \u624D\u80FD\u5BF9\u63A5\u524D\u7AEF
+- API \u5FC5\u987B\u7B26\u5408 API_RULES.md \u89C4\u8303
+- \u4EE3\u7801\u5FC5\u987B\u6709\u6D4B\u8BD5\u8986\u76D6
+
+\u5F53\u524D\u4EFB\u52A1\uFF1A
+- TICKET: {{TICKET}}
+- \u9636\u6BB5: {{PHASE}}`,
+  taskPrompt: `\u8BF7\u4E3A\u4EE5\u4E0B\u4EFB\u52A1\u5B8C\u6210\u540E\u7AEF\u5DE5\u4F5C\uFF1A
+
+## TICKET
+{{TICKET}}
+
+## \u9636\u6BB5
+{{PHASE}} (openapi | implementation)
+
+## \u5DF2\u6709\u6587\u6863
+\u8BF7\u5148\u9605\u8BFB\uFF1A
+- .handoff/{{TICKET}}/architect/API_RULES.md
+- .handoff/{{TICKET}}/architect/MODULE_OWNERSHIP.md
+
+**\u5982\u679C\u662F OpenAPI \u9636\u6BB5\uFF1A**
+
+\u8BF7\u8F93\u51FA\u4EE5\u4E0B\u6587\u6863\uFF08\u653E\u5728 .handoff/{{TICKET}}/backend/ \u76EE\u5F55\uFF09\uFF1A
+
+1. **API_OPENAPI.yaml** - OpenAPI 3.0 \u89C4\u8303
+   - \u5B8C\u6574\u7684 API \u5B9A\u4E49
+   - \u8BF7\u6C42/\u54CD\u5E94 Schema
+   - \u8BA4\u8BC1\u8BF4\u660E
+
+2. **API_EXAMPLES.md** - API \u793A\u4F8B
+   - \u8BF7\u6C42\u793A\u4F8B
+   - \u54CD\u5E94\u793A\u4F8B
+   - \u9519\u8BEF\u793A\u4F8B
+
+3. **MOCK_GUIDE.md** - Mock \u4F7F\u7528\u6307\u5357
+   - \u5982\u4F55\u542F\u52A8 Mock
+   - \u8986\u76D6\u7684\u63A5\u53E3\u6E05\u5355
+   - \u793A\u4F8B\u6570\u636E
+
+**\u5982\u679C\u662F Implementation \u9636\u6BB5\uFF1A**
+
+\u8BF7\u5B8C\u6210\u540E\u7AEF\u5B9E\u73B0\uFF1A
+
+1. \u7F16\u5199 API \u5B9E\u73B0\u4EE3\u7801
+2. \u7F16\u5199\u5355\u5143\u6D4B\u8BD5
+3. \u66F4\u65B0 CHANGELOG_BACKEND.md
+4. \u66F4\u65B0 TESTING_BACKEND.md`,
+  outputFormat: `\u8BF7\u8F93\u51FA\u5B8C\u6574\u7684\u6587\u6863\u548C\u4EE3\u7801\u3002`
+};
+var FRONTEND_PROMPT = {
+  role: "frontend",
+  displayName: "Frontend Developer",
+  systemPrompt: `\u4F60\u662F Frontend Developer\uFF0C\u8D1F\u8D23\u524D\u7AEF\u5B9E\u73B0\u3002
+
+\u4F60\u7684\u804C\u8D23\uFF1A
+1. \u57FA\u4E8E OpenAPI \u5BF9\u63A5\u524D\u7AEF
+2. \u5B9E\u73B0 UI \u7EC4\u4EF6
+3. \u7F16\u5199\u5355\u5143\u6D4B\u8BD5
+
+\u91CD\u8981\u89C4\u5219\uFF1A
+- \u5FC5\u987B\u57FA\u4E8E Mock \u670D\u52A1\u5148\u5B8C\u6210\u8054\u8C03
+- \u5FC5\u987B\u7B26\u5408\u8BBE\u8BA1\u89C4\u8303
+- \u4EE3\u7801\u5FC5\u987B\u6709\u6D4B\u8BD5\u8986\u76D6
+
+\u5F53\u524D\u4EFB\u52A1\uFF1A
+- TICKET: {{TICKET}}
+- \u9636\u6BB5: {{PHASE}}`,
+  taskPrompt: `\u8BF7\u4E3A\u4EE5\u4E0B\u4EFB\u52A1\u5B8C\u6210\u524D\u7AEF\u5DE5\u4F5C\uFF1A
+
+## TICKET
+{{TICKET}}
+
+## \u9636\u6BB5
+{{PHASE}}
+
+## \u5DF2\u6709\u6587\u6863/\u8D44\u6E90
+\u8BF7\u5148\u9605\u8BFB\uFF1A
+- .handoff/{{TICKET}}/backend/API_OPENAPI.yaml\uFF08\u5982\u679C\u5B58\u5728\uFF09
+- .handoff/{{TICKET}}/backend/MOCK_GUIDE.md\uFF08\u5982\u679C\u5B58\u5728\uFF09
+
+\u8BF7\u5B8C\u6210\u540E\u7AEF\u5B9E\u73B0\uFF1A
+
+1. \u57FA\u4E8E Mock \u670D\u52A1\u5BF9\u63A5 API
+2. \u5B9E\u73B0 UI \u7EC4\u4EF6
+3. \u7F16\u5199\u5355\u5143\u6D4B\u8BD5
+4. \u66F4\u65B0 CHANGELOG_FRONTEND.md
+5. \u66F4\u65B0 TESTING_FRONTEND.md
+
+\u8BF7\u5C06\u4EA7\u7269\u653E\u5728 .handoff/{{TICKET}}/frontend/ \u76EE\u5F55`,
+  outputFormat: `\u8BF7\u8F93\u51FA\u5B8C\u6574\u7684\u6587\u6863\u548C\u4EE3\u7801\u3002`
+};
+var QA_PROMPT = {
+  role: "qa",
+  displayName: "QA Engineer",
+  systemPrompt: `\u4F60\u662F QA Engineer\uFF0C\u8D1F\u8D23 BDD \u9A8C\u6536\u6D4B\u8BD5\u3002
+
+\u4F60\u7684\u804C\u8D23\uFF1A
+1. \u5C06 Gherkin \u573A\u666F\u8F6C\u4E3A\u53EF\u6267\u884C\u6B65\u9AA4
+2. \u6267\u884C BDD \u6D4B\u8BD5
+3. \u751F\u6210\u9A8C\u6536\u62A5\u544A
+
+\u91CD\u8981\u89C4\u5219\uFF1A
+- \u4E25\u683C\u6309 BDD \u573A\u666F\u6267\u884C
+- \u5931\u8D25\u573A\u666F\u5FC5\u987B\u6709\u590D\u73B0\u6B65\u9AA4
+- \u62A5\u544A\u5FC5\u987B\u5305\u542B\u622A\u56FE/\u65E5\u5FD7\u6307\u5F15
+
+\u5F53\u524D\u4EFB\u52A1\uFF1A
+- TICKET: {{TICKET}}`,
+  taskPrompt: `\u8BF7\u4E3A\u4EE5\u4E0B\u4EFB\u52A1\u6267\u884C BDD \u9A8C\u6536\uFF1A
+
+## TICKET
+{{TICKET}}
+
+## \u5DF2\u6709\u6587\u6863
+\u8BF7\u5148\u9605\u8BFB\uFF1A
+- .handoff/{{TICKET}}/planner/BDD_FEATURES/*.feature
+- .handoff/{{TICKET}}/planner/BDD_TRACEABILITY.md
+
+## \u4EFB\u52A1
+
+1. **BDD_RUN_GUIDE.md** - \u6267\u884C\u6307\u5357
+   - \u73AF\u5883\u51C6\u5907
+   - \u6570\u636E\u51C6\u5907
+   - \u6267\u884C\u547D\u4EE4
+
+2. **\u6267\u884C BDD \u6D4B\u8BD5**
+   - \u8BB0\u5F55\u6267\u884C\u7ED3\u679C
+   - \u622A\u56FE/\u65E5\u5FD7
+
+3. **BDD_REPORT.md** - \u9A8C\u6536\u62A5\u544A
+   - \u6267\u884C\u6458\u8981
+   - \u6210\u529F\u573A\u666F
+   - \u5931\u8D25\u573A\u666F\uFF08\u542B\u590D\u73B0\u6B65\u9AA4\uFF09
+   - \u5EF6\u671F/\u964D\u7EA7\u8BB0\u5F55
+
+4. **REGRESSION.md** - \u56DE\u5F52\u6E05\u5355
+   - \u9700\u8981\u56DE\u5F52\u7684\u6D4B\u8BD5\u9879
+   - \u624B\u52A8\u6D4B\u8BD5\u6307\u5F15
+
+\u8BF7\u5C06\u4EA7\u7269\u653E\u5728 .handoff/{{TICKET}}/qa/ \u76EE\u5F55`,
+  outputFormat: `\u8BF7\u8F93\u51FA\u5B8C\u6574\u7684\u9A8C\u6536\u62A5\u544A\u3002`
+};
+var REVIEWER_PROMPT = {
+  role: "reviewer",
+  displayName: "Reviewer",
+  systemPrompt: `\u4F60\u662F Code Reviewer\uFF0C\u8D1F\u8D23\u4EE3\u7801\u5BA1\u67E5\u4E0E\u53D1\u5E03\u3002
+
+\u4F60\u7684\u804C\u8D23\uFF1A
+1. \u4EE3\u7801\u5BA1\u67E5
+2. \u95E8\u7981\u68C0\u67E5
+3. \u53D1\u5E03\u4E0E\u56DE\u6EDA\u65B9\u6848
+
+\u91CD\u8981\u89C4\u5219\uFF1A
+- \u4E25\u683C\u68C0\u67E5\u8D28\u91CF\u95E8\u7981
+- \u53D1\u5E03\u65B9\u6848\u5FC5\u987B\u53EF\u6267\u884C
+- \u56DE\u6EDA\u65B9\u6848\u5FC5\u987B\u6709\u9A8C\u8BC1\u6B65\u9AA4
+
+\u5F53\u524D\u4EFB\u52A1\uFF1A
+- TICKET: {{TICKET}}`,
+  taskPrompt: `\u8BF7\u4E3A\u4EE5\u4E0B\u4EFB\u52A1\u6267\u884C\u5BA1\u67E5\u4E0E\u53D1\u5E03\u51C6\u5907\uFF1A
+
+## TICKET
+{{TICKET}}
+
+## \u5DF2\u6709\u6587\u6863
+\u8BF7\u5148\u9605\u8BFB\u6240\u6709 .handoff/{{TICKET}}/*/ \u4E0B\u7684\u6587\u6863
+
+## \u4EFB\u52A1
+
+1. **REVIEW.md** - \u5BA1\u67E5\u62A5\u544A
+   - \u4EE3\u7801\u5BA1\u67E5 checklist
+   - \u53D1\u73B0\u7684\u95EE\u9898
+   - \u5BA1\u67E5\u7ED3\u8BBA
+
+2. **RELEASE.md** - \u53D1\u5E03\u65B9\u6848
+   - \u53D1\u5E03\u6B65\u9AA4
+   - \u76D1\u63A7\u9879
+   - \u53D1\u5E03\u68C0\u67E5\u6E05\u5355
+
+3. **ROLLBACK.md** - \u56DE\u6EDA\u65B9\u6848
+   - \u56DE\u6EDA\u89E6\u53D1\u6761\u4EF6
+   - \u56DE\u6EDA\u6B65\u9AA4
+   - \u6570\u636E\u6062\u590D\uFF08\u5982\u9700\u8981\uFF09
+   - \u9A8C\u8BC1\u6B65\u9AA4
+
+\u8BF7\u5C06\u4EA7\u7269\u653E\u5728 .handoff/{{TICKET}}/reviewer/ \u76EE\u5F55`,
+  outputFormat: `\u8BF7\u8F93\u51FA\u5B8C\u6574\u7684\u5BA1\u67E5\u548C\u53D1\u5E03\u6587\u6863\u3002`
+};
+var ROLE_PROMPTS = {
+  planner: PLANNER_PROMPT,
+  architect: ARCHITECT_PROMPT,
+  backend: BACKEND_PROMPT,
+  frontend: FRONTEND_PROMPT,
+  qa: QA_PROMPT,
+  reviewer: REVIEWER_PROMPT
+};
+function getRolePrompt(role) {
+  return ROLE_PROMPTS[role];
+}
+function buildRolePrompt(role, data) {
+  const config = getRolePrompt(role);
+  if (!config) {
+    throw new Error(`Unknown role: ${role}`);
+  }
+  let taskPrompt = config.taskPrompt;
+  for (const [key, value] of Object.entries(data)) {
+    taskPrompt = taskPrompt.replace(new RegExp(`{{${key}}}`, "g"), value);
+  }
+  return taskPrompt;
+}
+
+// src/lib/phase-config.ts
+init_esm_shims();
+var PHASE_CONFIGS = {
+  planning: {
+    phase: "planning",
+    displayName: "\u9700\u6C42\u4E0E BDD \u8BBE\u8BA1",
+    description: "Planner \u521B\u5EFA SPEC\u3001TASKS\u3001BDD \u573A\u666F",
+    gateNumber: 1,
+    parallelRoles: [["planner"]],
+    dependsOn: [],
+    minDuration: 15,
+    maxDuration: 60
+  },
+  architecture: {
+    phase: "architecture",
+    displayName: "\u67B6\u6784\u4E0E\u5951\u7EA6",
+    description: "Architect \u521B\u5EFA ADR\u3001API \u89C4\u5219\u3001\u6A21\u5757\u5F52\u5C5E",
+    gateNumber: 2,
+    parallelRoles: [["architect"]],
+    dependsOn: ["planning"],
+    minDuration: 15,
+    maxDuration: 45
+  },
+  openapi: {
+    phase: "openapi",
+    displayName: "OpenAPI + Mock",
+    description: "Backend \u5148\u51FA OpenAPI + Mock\uFF0C\u524D\u7AEF\u624D\u80FD\u5BF9\u63A5",
+    gateNumber: 3,
+    parallelRoles: [["backend"]],
+    dependsOn: ["architecture"],
+    minDuration: 20,
+    maxDuration: 90
+  },
+  implementation: {
+    phase: "implementation",
+    displayName: "\u5E76\u884C\u5B9E\u73B0",
+    description: "Backend \u4E0E Frontend \u5E76\u884C\u5F00\u53D1",
+    gateNumber: 4,
+    parallelRoles: [["backend", "frontend"]],
+    dependsOn: ["openapi"],
+    minDuration: 60,
+    maxDuration: 480
+  },
+  bdd: {
+    phase: "bdd",
+    displayName: "BDD \u9A8C\u6536",
+    description: "QA \u6267\u884C BDD \u9A8C\u6536\u6D4B\u8BD5",
+    gateNumber: 5,
+    parallelRoles: [["qa"]],
+    dependsOn: ["implementation"],
+    minDuration: 30,
+    maxDuration: 120
+  },
+  integration: {
+    phase: "integration",
+    displayName: "\u96C6\u6210\u4E0E\u53D1\u5E03",
+    description: "\u6536\u655B\u5230 integration \u5206\u652F\uFF0C\u6267\u884C CI/CD",
+    gateNumber: 6,
+    parallelRoles: [["reviewer"]],
+    dependsBy: ["bdd"],
+    minDuration: 15,
+    maxDuration: 60
+  }
+};
+var PHASE_SEQUENCE = [
+  "planning",
+  "architecture",
+  "openapi",
+  "implementation",
+  "bdd",
+  "integration"
+];
+var GATE_CONDITIONS = {
+  1: [
+    {
+      description: "SPEC.md \u5305\u542B\u76EE\u6807/\u975E\u76EE\u6807/\u8303\u56F4",
+      status: "pending"
+    },
+    {
+      description: "TASKS.md \u4EFB\u52A1\u62C6\u5206\u5230\u53EF\u72EC\u7ACB\u5408\u5E76",
+      status: "pending"
+    },
+    {
+      description: "BDD \u573A\u666F Given/When/Then \u5B8C\u6574",
+      status: "pending"
+    },
+    {
+      description: "\u9A8C\u6536\u6807\u51C6\u4E0E BDD \u573A\u666F\u4E00\u4E00\u5BF9\u5E94",
+      status: "pending"
+    }
+  ],
+  2: [
+    {
+      description: "ADR \u51B3\u7B56\u8BB0\u5F55\u5B8C\u6574",
+      status: "pending"
+    },
+    {
+      description: "API_RULES \u5305\u542B\u9519\u8BEF\u7801\u89C4\u8303",
+      status: "pending"
+    },
+    {
+      description: "MODULE_OWNERSHIP \u76EE\u5F55\u8FB9\u754C\u660E\u786E",
+      status: "pending"
+    },
+    {
+      description: "IMPACT \u98CE\u9669\u8BC4\u4F30\u5B8C\u6210",
+      status: "pending"
+    }
+  ],
+  3: [
+    {
+      description: "OpenAPI \u6587\u4EF6\u7B26\u5408\u89C4\u8303",
+      status: "pending"
+    },
+    {
+      description: "Mock \u670D\u52A1\u53EF\u542F\u52A8",
+      status: "pending"
+    },
+    {
+      description: "\u524D\u7AEF\u53EF\u7528 Mock \u5B8C\u6210\u4E3B\u8DEF\u5F84",
+      status: "pending"
+    },
+    {
+      description: "API_EXAMPLES \u5305\u542B\u5B8C\u6574\u793A\u4F8B",
+      status: "pending"
+    }
+  ],
+  4: [
+    {
+      description: "\u540E\u7AEF\u5355\u5143\u6D4B\u8BD5\u8986\u76D6\u7387 > 70%",
+      status: "pending"
+    },
+    {
+      description: "\u524D\u7AEF\u5355\u5143\u6D4B\u8BD5\u8986\u76D6\u7387 > 70%",
+      status: "pending"
+    },
+    {
+      description: "\u9759\u6001\u68C0\u67E5 (Lint) \u901A\u8FC7",
+      status: "pending"
+    },
+    {
+      description: "\u63A5\u53E3\u5951\u7EA6\u4E0E OpenAPI \u4E00\u81F4",
+      status: "pending"
+    }
+  ],
+  5: [
+    {
+      description: "Must \u7EA7\u522B\u573A\u666F 100% \u901A\u8FC7",
+      status: "pending"
+    },
+    {
+      description: "Should \u7EA7\u522B\u573A\u666F\u901A\u8FC7\u7387 > 90%",
+      status: "pending"
+    },
+    {
+      description: "BDD_REPORT \u5305\u542B\u5931\u8D25\u573A\u666F\u590D\u73B0",
+      status: "pending"
+    },
+    {
+      description: "\u56DE\u5F52\u6E05\u5355\u5DF2\u51C6\u5907",
+      status: "pending"
+    }
+  ],
+  6: [
+    {
+      description: "integration \u5206\u652F CI \u901A\u8FC7",
+      status: "pending"
+    },
+    {
+      description: "\u5168\u91CF BDD \u901A\u8FC7",
+      status: "pending"
+    },
+    {
+      description: ".handoff \u6587\u4EF6\u9F50\u5168",
+      status: "pending"
+    },
+    {
+      description: "ROLLBACK.md \u53EF\u6267\u884C",
+      status: "pending"
+    }
+  ]
+};
+function canEnterPhase(phase, completedPhases) {
+  const config = PHASE_CONFIGS[phase];
+  if (!config) return false;
+  return config.dependsOn.every((dep) => completedPhases.includes(dep));
+}
+function getGateNumber(phase) {
+  return PHASE_CONFIGS[phase]?.gateNumber || 0;
+}
+function getParallelRoles(phase) {
+  return PHASE_CONFIGS[phase]?.parallelRoles || [];
+}
+function getPhaseDisplayName(phase) {
+  return PHASE_CONFIGS[phase]?.displayName || phase;
+}
+function formatPhaseProgress(completedPhases) {
+  const total = PHASE_SEQUENCE.length;
+  const current = completedPhases.length;
+  const progressBar = "\u2588".repeat(current) + "\u2591".repeat(total - current);
+  return `[${progressBar}] ${current}/${total} \u9636\u6BB5\u5B8C\u6210`;
+}
+
+// src/lib/concurrent-executor.ts
+init_logger();
+var ConcurrentExecutor = class {
+  repoRoot;
+  constructor(repoRoot) {
+    this.repoRoot = repoRoot || process.cwd();
+  }
+  /**
+   * 并行执行多个角色任务
+   */
+  async executeParallel(configs) {
+    console.log(`
+\u{1F680} \u542F\u52A8 ${configs.length} \u4E2A\u5E76\u884C\u4EFB\u52A1...
+`);
+    const promises = configs.map(
+      (config) => this.executeInWorktree(config)
+    );
+    const results = await Promise.all(promises);
+    this.printSummary(results);
+    return results;
+  }
+  /**
+   * 在指定角色目录执行 Claude Code
+   */
+  async executeInWorktree(config) {
+    const startTime = Date.now();
+    const { role, prompt, systemPrompt, timeout = 30, cwd } = config;
+    const rolePrompt = getRolePrompt(role);
+    const finalSystemPrompt = systemPrompt || rolePrompt?.systemPrompt || "";
+    const fullPrompt = `${finalSystemPrompt}
+
+---
+
+\u5F53\u524D\u4EFB\u52A1\uFF1A
+${prompt}
+
+\u91CD\u8981\u63D0\u793A\uFF1A
+- \u53EA\u8F93\u51FA\u6587\u6863\u548C\u4EE3\u7801\uFF0C\u4E0D\u8981\u989D\u5916\u89E3\u91CA
+- \u5B8C\u6210\u540E\u7ACB\u5373\u9000\u51FA
+`;
+    const workDir = cwd || this.repoRoot;
+    logger.info(`[${role}] \u5F00\u59CB\u6267\u884C...`);
+    return new Promise((resolve) => {
+      const args = [
+        "--print",
+        // 非交互式
+        "--output-format",
+        "text",
+        "--no-session-persistence",
+        "--dangerously-skip-permissions"
+      ];
+      if (finalSystemPrompt) {
+        args.push("--system-prompt", finalSystemPrompt);
+      }
+      const proc = spawn("claude", args, {
+        cwd: workDir,
+        stdio: ["pipe", "pipe", "pipe"],
+        env: {
+          ...process.env,
+          FORCE_COLOR: "1"
+        }
+      });
+      let stdout = "";
+      let stderr = "";
+      proc.stdout.on("data", (data) => {
+        const text = data.toString();
+        stdout += text;
+        process.stdout.write(text);
+      });
+      proc.stderr.on("data", (data) => {
+        stderr += data.toString();
+      });
+      proc.on("close", (code) => {
+        const duration = Date.now() - startTime;
+        const result = {
+          role,
+          worktreePath: workDir,
+          success: code === 0,
+          output: stdout || stderr,
+          duration,
+          exitCode: code || 0,
+          artifacts: this.extractArtifacts(stdout)
+        };
+        const icon = result.success ? "\u2713" : "\u2717";
+        const durationSec = (duration / 1e3).toFixed(1);
+        console.log(`  ${icon} [${role.padEnd(12)}] ${result.success ? "\u6210\u529F" : "\u5931\u8D25"} (${durationSec}s)`);
+        resolve(result);
+      });
+      proc.on("error", (err) => {
+        const duration = Date.now() - startTime;
+        resolve({
+          role,
+          worktreePath: workDir,
+          success: false,
+          output: `Error: ${err.message}`,
+          duration,
+          exitCode: -1,
+          error: err.message,
+          artifacts: []
+        });
+      });
+      proc.stdin.write(fullPrompt);
+      proc.stdin.end();
+      const timeoutMs = timeout * 60 * 1e3;
+      setTimeout(() => {
+        if (!proc.killed) {
+          proc.kill("SIGTERM");
+          resolve({
+            role,
+            worktreePath: workDir,
+            success: false,
+            output: "Timeout: Task exceeded maximum duration",
+            duration: timeoutMs,
+            exitCode: -1,
+            error: "Timeout",
+            artifacts: []
+          });
+        }
+      }, timeoutMs);
+    });
+  }
+  /**
+   * 执行阶段任务
+   */
+  async executePhase(ticket, phase, taskData) {
+    const phaseConfig = PHASE_CONFIGS[phase];
+    if (!phaseConfig) {
+      throw new Error(`Unknown phase: ${phase}`);
+    }
+    console.log(`
+\u{1F4CB} Phase ${phaseConfig.gateNumber}: ${phaseConfig.displayName}`);
+    console.log(`${phaseConfig.description}
+`);
+    const parallelRoleGroups = getParallelRoles(phase);
+    const results = [];
+    for (const roleGroup of parallelRoleGroups) {
+      if (roleGroup.length === 1) {
+        const role = roleGroup[0];
+        const rolePrompt = getRolePrompt(role);
+        if (!rolePrompt) {
+          logger.warn(`Unknown role: ${role}`);
+          continue;
+        }
+        const prompt = buildRolePrompt(role, {
+          TICKET: ticket,
+          ...taskData
+        });
+        const result = await this.executeInWorktree({
+          role,
+          prompt,
+          systemPrompt: rolePrompt.systemPrompt
+        });
+        results.push(result);
+      } else {
+        const configs = roleGroup.map((role) => {
+          const rolePrompt = getRolePrompt(role);
+          if (!rolePrompt) {
+            return null;
+          }
+          return {
+            role,
+            prompt: buildRolePrompt(role, {
+              TICKET: ticket,
+              ...taskData
+            }),
+            systemPrompt: rolePrompt.systemPrompt
+          };
+        }).filter(Boolean);
+        const groupResults = await this.executeParallel(configs);
+        results.push(...groupResults);
+      }
+    }
+    return results;
+  }
+  /**
+   * 执行完整流程
+   */
+  async executeFullFlow(ticket, goal, phases, options) {
+    const allResults = /* @__PURE__ */ new Map();
+    for (const phase of phases) {
+      try {
+        options?.onPhaseStart?.(phase);
+        const results = await this.executePhase(ticket, phase, {
+          TICKET: ticket,
+          GOAL: goal,
+          PHASE: phase
+        });
+        allResults.set(phase, results);
+        options?.onPhaseComplete?.(phase, results);
+        const allSuccess = results.every((r) => r.success);
+        if (!allSuccess) {
+          console.log(`
+\u26A0\uFE0F  Phase ${phase} \u90E8\u5206\u4EFB\u52A1\u5931\u8D25`);
+          console.log("\u662F\u5426\u7EE7\u7EED\u4E0B\u4E00\u4E2A\u9636\u6BB5\uFF1F(\u5EFA\u8BAE\u5148\u4FEE\u590D\u5931\u8D25\u7684\u4EFB\u52A1)");
+        }
+      } catch (error) {
+        logger.error(`Phase ${phase} \u6267\u884C\u5931\u8D25: ${error}`);
+        options?.onError?.(error);
+      }
+    }
+    return allResults;
+  }
+  /**
+   * 打印执行汇总
+   */
+  printSummary(results) {
+    console.log("\n" + "\u2550".repeat(60));
+    console.log("\u{1F4CA} \u5E76\u884C\u4EFB\u52A1\u6267\u884C\u7ED3\u679C");
+    console.log("\u2550".repeat(60));
+    let successCount = 0;
+    let failCount = 0;
+    for (const result of results) {
+      const icon = result.success ? "\u2713" : "\u2717";
+      const duration = (result.duration / 1e3).toFixed(1);
+      console.log(`  ${icon} [${result.role.padEnd(12)}] ${result.exitCode} (${duration}s)`);
+      if (result.success) {
+        successCount++;
+      } else {
+        failCount++;
+      }
+    }
+    console.log("\u2500".repeat(60));
+    console.log(`  \u603B\u8BA1: ${successCount} \u6210\u529F, ${failCount} \u5931\u8D25`);
+    console.log("\u2550".repeat(60) + "\n");
+  }
+  /**
+   * 从输出中提取生成的交接物文件
+   */
+  extractArtifacts(output) {
+    const artifacts = [];
+    const filePatterns = [
+      /\.handoff\/[^\s]+\.(md|yaml|json)/gi,
+      /`(?:create|write|update):?\s*([^\s`]+)/gi
+    ];
+    for (const pattern of filePatterns) {
+      const matches = output.matchAll(pattern);
+      for (const match of matches) {
+        const file = match[1] || match[0];
+        if (file && !artifacts.includes(file)) {
+          artifacts.push(file);
+        }
+      }
+    }
+    return artifacts;
+  }
+  /**
+   * 生成任务报告
+   */
+  generateReport(results) {
+    const lines = [];
+    lines.push("# \u5E76\u884C\u6267\u884C\u62A5\u544A");
+    lines.push("");
+    lines.push(`**\u65F6\u95F4**: ${(/* @__PURE__ */ new Date()).toLocaleString("zh-CN")}`);
+    lines.push(`**\u6210\u529F**: ${results.filter((r) => r.success).length}`);
+    lines.push(`**\u5931\u8D25**: ${results.filter((r) => !r.success).length}`);
+    lines.push("");
+    lines.push("## \u8BE6\u7EC6\u7ED3\u679C");
+    lines.push("");
+    for (const result of results) {
+      lines.push(`### ${result.role}`);
+      lines.push("");
+      lines.push(`- **\u72B6\u6001**: ${result.success ? "\u2713 \u6210\u529F" : "\u2717 \u5931\u8D25"}`);
+      lines.push(`- **\u8017\u65F6**: ${(result.duration / 1e3).toFixed(1)}s`);
+      lines.push(`- **\u9000\u51FA\u7801**: ${result.exitCode}`);
+      lines.push(`- **\u5DE5\u4F5C\u76EE\u5F55**: ${result.worktreePath}`);
+      lines.push("");
+      if (result.artifacts.length > 0) {
+        lines.push("**\u751F\u6210\u7684\u4EA4\u63A5\u7269**:");
+        for (const artifact of result.artifacts) {
+          lines.push(`- ${artifact}`);
+        }
+        lines.push("");
+      }
+      if (result.error) {
+        lines.push(`**\u9519\u8BEF**: ${result.error}`);
+        lines.push("");
+      }
+    }
+    return lines.join("\n");
+  }
+  /**
+   * 保存报告
+   */
+  async saveReport(ticket, results) {
+    const reportDir = path23.join(this.repoRoot, ".handoff", ticket, "reports");
+    await fs8.ensureDir(reportDir);
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+    const reportFile = path23.join(reportDir, `execution-${timestamp}.md`);
+    const report = this.generateReport(results);
+    await fs8.writeFile(reportFile, report, "utf-8");
+    logger.success(`\u6267\u884C\u62A5\u544A\u5DF2\u4FDD\u5B58: ${reportFile}`);
+    return reportFile;
+  }
+};
+function createExecutor(repoRoot) {
+  return new ConcurrentExecutor(repoRoot);
+}
+
+// src/commands/dev-worktree.ts
+var devWorktreeCommand = new Command18("dev:wt").alias("dev-worktree").description("Worktree Orchestrator - \u591A\u89D2\u8272\u5E76\u884C\u5F00\u53D1\u7F16\u6392\u5668").option("--new", "\u521B\u5EFA\u65B0\u7684\u5E76\u884C\u5F00\u53D1\u4F1A\u8BDD").option("--ticket <id>", "TICKET ID").option("--goal <text>", "\u4EFB\u52A1\u76EE\u6807").option("--list", "\u5217\u51FA\u6240\u6709 worktree").option("--status", "\u67E5\u770B\u4F1A\u8BDD\u72B6\u6001").option("--run-phase <n>", "\u8FD0\u884C\u6307\u5B9A\u9636\u6BB5").option("--verify", "\u9A8C\u8BC1\u4EA4\u63A5\u7269").action(async (options) => {
+  try {
+    logger.header("Worktree Orchestrator");
+    logger.newLine();
+    const hasTechStack = await FileUtils.exists("TECH_STACK.md");
+    if (!hasTechStack) {
+      logger.error("\u5F53\u524D\u76EE\u5F55\u4E0D\u662F\u4E00\u4E2A\u6709\u6548\u7684 team-cli \u9879\u76EE");
+      logger.info("\u8BF7\u5148\u8FD0\u884C 'team-cli init <project-name>' \u6216\u5207\u6362\u5230\u9879\u76EE\u76EE\u5F55");
+      process.exit(1);
+    }
+    logger.success("\u68C0\u6D4B\u5230\u9879\u76EE\u4E0A\u4E0B\u6587");
+    const repoRoot = process.cwd();
+    const worktreeManager = new WorktreeManager(repoRoot);
+    const handoffManager = createHandoffManager(repoRoot);
+    const executor2 = createExecutor(repoRoot);
+    if (options.new) {
+      await handleNewSession(worktreeManager, handoffManager, options, repoRoot);
+    } else if (options.list) {
+      await handleList(worktreeManager);
+    } else if (options.status) {
+      await handleStatus(worktreeManager, handoffManager, options);
+    } else if (options.runPhase) {
+      await handleRunPhase(worktreeManager, handoffManager, executor2, options);
+    } else if (options.verify) {
+      await handleVerify(worktreeManager, handoffManager, options);
+    } else {
+      await showMainMenu(worktreeManager, handoffManager, executor2, options);
+    }
+    logger.newLine();
+    logger.success("Worktree Orchestrator \u64CD\u4F5C\u5B8C\u6210!");
+  } catch (error) {
+    logger.error(`\u64CD\u4F5C\u5931\u8D25: ${error.message}`);
+    if (process.env.DEBUG) {
+      console.error(error);
+    }
+    process.exit(1);
+  }
+});
+async function showMainMenu(worktreeManager, handoffManager, executor2, options) {
+  const choices = [
+    {
+      name: "\u{1F4CB} \u65B0\u5EFA\u5E76\u884C\u5F00\u53D1\u4F1A\u8BDD",
+      value: "new"
+    },
+    {
+      name: "\u{1F4C2} \u5217\u51FA\u6240\u6709 Worktree",
+      value: "list"
+    },
+    {
+      name: "\u{1F4CA} \u67E5\u770B\u4F1A\u8BDD\u72B6\u6001",
+      value: "status"
+    },
+    {
+      name: "\u25B6\uFE0F \u8FD0\u884C\u9636\u6BB5",
+      value: "run"
+    },
+    {
+      name: "\u2705 \u9A8C\u8BC1\u4EA4\u63A5\u7269",
+      value: "verify"
+    },
+    {
+      name: "\u{1F6AA} \u9000\u51FA",
+      value: "exit"
+    }
+  ];
+  const { action } = await inquirer13.prompt([
+    {
+      type: "list",
+      name: "action",
+      message: "\u9009\u62E9\u64CD\u4F5C:",
+      choices
+    }
+  ]);
+  switch (action) {
+    case "new":
+      await handleNewSession(worktreeManager, handoffManager, options, process.cwd());
+      break;
+    case "list":
+      await handleList(worktreeManager);
+      break;
+    case "status":
+      await handleStatus(worktreeManager, handoffManager, options);
+      break;
+    case "run":
+      await handleRunPhaseSelect(worktreeManager, handoffManager, executor2, options);
+      break;
+    case "verify":
+      await handleVerifySelect(worktreeManager, handoffManager, options);
+      break;
+    case "exit":
+      process.exit(0);
+  }
+}
+async function handleNewSession(worktreeManager, handoffManager, options, repoRoot) {
+  logger.step("\u65B0\u5EFA\u5E76\u884C\u5F00\u53D1\u4F1A\u8BDD");
+  const questions = [
+    {
+      type: "input",
+      name: "ticket",
+      message: "\u8F93\u5165 TICKET ID (\u4F8B\u5982 USER-123):",
+      validate: (input) => {
+        if (!input.trim()) return "\u8BF7\u8F93\u5165 TICKET ID";
+        return true;
+      }
+    },
+    {
+      type: "input",
+      name: "goal",
+      message: "\u8F93\u5165\u4EFB\u52A1\u76EE\u6807:",
+      validate: (input) => {
+        if (!input.trim()) return "\u8BF7\u8F93\u5165\u4EFB\u52A1\u76EE\u6807";
+        return true;
+      }
+    },
+    {
+      type: "checkbox",
+      name: "roles",
+      message: "\u9009\u62E9\u53C2\u4E0E\u89D2\u8272:",
+      choices: [
+        { name: "Planner (\u9700\u6C42\u4E0E BDD)", value: "planner", checked: true },
+        { name: "Architect (\u67B6\u6784)", value: "architect", checked: true },
+        { name: "Backend (\u540E\u7AEF)", value: "backend", checked: true },
+        { name: "Frontend (\u524D\u7AEF)", value: "frontend", checked: true },
+        { name: "QA (BDD \u9A8C\u6536)", value: "qa", checked: true },
+        { name: "Reviewer (\u5BA1\u67E5)", value: "reviewer", checked: true }
+      ]
+    }
+  ];
+  const answers = await inquirer13.prompt(questions);
+  logger.newLine();
+  logger.info(`\u521B\u5EFA\u4F1A\u8BDD: ${answers.ticket}`);
+  logger.info(`\u76EE\u6807: ${answers.goal}`);
+  logger.info(`\u89D2\u8272: ${answers.roles.join(", ")}`);
+  logger.newLine();
+  const { confirm } = await inquirer13.prompt([
+    {
+      type: "confirm",
+      name: "confirm",
+      message: "\u786E\u8BA4\u521B\u5EFA\u4F1A\u8BDD?",
+      default: true
+    }
+  ]);
+  if (!confirm) {
+    logger.info("\u5DF2\u53D6\u6D88");
+    return;
+  }
+  try {
+    const session = await worktreeManager.createSession({
+      ticket: answers.ticket,
+      goal: answers.goal,
+      baseBranch: "main",
+      enabledRoles: answers.roles
+    });
+    await handoffManager.init(answers.ticket, answers.roles);
+    await generateInitialTemplates(handoffManager, answers.ticket, answers.goal);
+    logger.newLine();
+    logger.success("\u4F1A\u8BDD\u521B\u5EFA\u6210\u529F!");
+    logger.info("");
+    logger.info("Worktree \u76EE\u5F55:");
+    for (const wt of session.worktrees) {
+      logger.info(`  - ${wt.name} (${wt.path})`);
+    }
+    logger.info("");
+    logger.info("\u4EA4\u63A5\u7269\u76EE\u5F55:");
+    logger.info(`  .handoff/${answers.ticket}/`);
+    const { runNow } = await inquirer13.prompt([
+      {
+        type: "confirm",
+        name: "runNow",
+        message: "\u662F\u5426\u7ACB\u5373\u5F00\u59CB\u8FD0\u884C Phase 1?",
+        default: false
+      }
+    ]);
+    if (runNow) {
+      await handleRunPhase(worktreeManager, handoffManager, executor, {
+        ticket: answers.ticket,
+        goal: answers.goal,
+        phase: "1"
+      });
+    }
+  } catch (error) {
+    logger.error(`\u521B\u5EFA\u4F1A\u8BDD\u5931\u8D25: ${error}`);
+  }
+}
+async function generateInitialTemplates(handoffManager, ticket, goal) {
+  const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  await handoffManager.generateTemplate(ticket, "planner", "SPEC", {
+    TICKET: ticket,
+    TITLE: goal,
+    OWNER: "\u5F85\u5B9A",
+    DATE: today,
+    CRITERIA_1: "[\u5F85\u586B\u5199]",
+    CRITERIA_2: "[\u5F85\u586B\u5199]",
+    CRITERIA_3: "[\u5F85\u586B\u5199]",
+    DEPENDENCIES: "\u65E0",
+    DEPENDED_BY: "\u5F85\u5B9A",
+    FEATURE: "\u5F85\u5B9A"
+  });
+  await handoffManager.generateTemplate(ticket, "planner", "TASKS", {
+    TICKET: ticket
+  });
+}
+async function handleList(worktreeManager) {
+  logger.step("\u5217\u51FA\u6240\u6709 Worktree");
+  const worktrees = await worktreeManager.list();
+  if (worktrees.length === 0) {
+    logger.info("\u6CA1\u6709\u627E\u5230 Worktree");
+    return;
+  }
+  logger.newLine();
+  console.log("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");
+  console.log("\u2502 Worktree \u5217\u8868                                             \u2502");
+  console.log("\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");
+  for (const wt of worktrees) {
+    const statusIcon = wt.status === "active" ? "\u25CF" : wt.status === "completed" ? "\u2713" : "\u25CB";
+    console.log(`\u2502 ${statusIcon} ${wt.name.padEnd(20)} ${wt.branch.padEnd(25)} \u2502`);
+  }
+  console.log("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");
+}
+async function handleStatus(worktreeManager, handoffManager, options) {
+  logger.step("\u67E5\u770B\u4F1A\u8BDD\u72B6\u6001");
+  const handoffDir = path24.join(process.cwd(), ".handoff");
+  const sessions = await FileUtils.findFiles("session-*.json", handoffDir);
+  if (sessions.length === 0) {
+    logger.info("\u6CA1\u6709\u627E\u5230\u6D3B\u8DC3\u7684\u4F1A\u8BDD");
+    return;
+  }
+  const sessionChoices = sessions.map((s) => {
+    const ticket2 = s.replace("session-", "").replace(".json", "");
+    return { name: ticket2, value: ticket2 };
+  });
+  const { ticket } = await inquirer13.prompt([
+    {
+      type: "list",
+      name: "ticket",
+      message: "\u9009\u62E9\u4F1A\u8BDD:",
+      choices: sessionChoices
+    }
+  ]);
+  const state = await worktreeManager.getSessionState(ticket);
+  if (!state) {
+    logger.error("\u4F1A\u8BDD\u72B6\u6001\u4E0D\u5B58\u5728");
+    return;
+  }
+  logger.newLine();
+  console.log(`\u{1F4CB} \u4F1A\u8BDD: ${ticket}`);
+  console.log(`\u{1F4CA} \u5F53\u524D\u9636\u6BB5: ${state.currentPhase}`);
+  console.log(`\u2705 \u5DF2\u5B8C\u6210\u9636\u6BB5: ${state.completedPhases.length}`);
+  console.log("");
+  console.log(formatPhaseProgress(state.completedPhases));
+}
+async function handleRunPhaseSelect(worktreeManager, handoffManager, executor2, options) {
+  const handoffDir = path24.join(process.cwd(), ".handoff");
+  const sessions = await FileUtils.findFiles("session-*.json", handoffDir);
+  if (sessions.length === 0) {
+    logger.error("\u6CA1\u6709\u627E\u5230\u6D3B\u8DC3\u7684\u4F1A\u8BDD");
+    return;
+  }
+  const ticketChoices = sessions.map((s) => {
+    const ticket2 = s.replace("session-", "").replace(".json", "");
+    return { name: ticket2, value: ticket2 };
+  });
+  const { ticket } = await inquirer13.prompt([
+    {
+      type: "list",
+      name: "ticket",
+      message: "\u9009\u62E9\u4F1A\u8BDD:",
+      choices: ticketChoices
+    }
+  ]);
+  const phaseChoices = PHASE_SEQUENCE.map((p, i) => ({
+    name: `${i + 1}. ${getPhaseDisplayName(p)}`,
+    value: String(i + 1)
+  }));
+  const { phaseNum } = await inquirer13.prompt([
+    {
+      type: "list",
+      name: "phaseNum",
+      message: "\u9009\u62E9\u9636\u6BB5:",
+      choices: phaseChoices
+    }
+  ]);
+  await handleRunPhase(worktreeManager, handoffManager, executor2, {
+    ticket,
+    phase: phaseNum
+  });
+}
+async function checkPhaseGate(ticket, phaseName, completedPhases) {
+  const gateNum = getGateNumber(phaseName);
+  const conditions = GATE_CONDITIONS[gateNum] || [];
+  logger.newLine();
+  console.log("\u2550".repeat(60));
+  console.log(`\u{1F6AA} Gate ${gateNum} \u68C0\u67E5: ${getPhaseDisplayName(phaseName)}`);
+  console.log("\u2550".repeat(60));
+  console.log("");
+  const canEnter = canEnterPhase(phaseName, completedPhases);
+  if (!canEnter) {
+    console.log("\u26A0\uFE0F  \u524D\u7F6E\u9636\u6BB5\u672A\u5B8C\u6210:");
+    const phaseConfig = PHASE_CONFIGS[phaseName];
+    for (const dep of phaseConfig.dependsOn) {
+      const isDone = completedPhases.includes(dep);
+      console.log(`  ${isDone ? "\u2713" : "\u2717"} ${getPhaseDisplayName(dep)}`);
+    }
+    console.log("");
+    logger.warn("\u8BF7\u5148\u5B8C\u6210\u524D\u7F6E\u9636\u6BB5\u540E\u518D\u8FDB\u5165\u6B64\u9636\u6BB5");
+    return false;
+  }
+  console.log("\u2713 \u524D\u7F6E\u9636\u6BB5\u5DF2\u5168\u90E8\u5B8C\u6210");
+  console.log("");
+  console.log("\u{1F4CB} Gate \u68C0\u67E5\u6E05\u5355:");
+  console.log("");
+  if (conditions.length === 0) {
+    console.log("  (\u6B64\u9636\u6BB5\u65E0\u9700\u989D\u5916\u68C0\u67E5)");
+  } else {
+    for (let i = 0; i < conditions.length; i++) {
+      const cond = conditions[i];
+      console.log(`  [ ] ${cond.description}`);
+    }
+  }
+  console.log("");
+  console.log("\u2500".repeat(60));
+  const { passed } = await inquirer13.prompt([
+    {
+      type: "confirm",
+      name: "passed",
+      message: "\u662F\u5426\u786E\u8BA4\u901A\u8FC7\u6B64 Gate? (\u786E\u8BA4\u540E\u9636\u6BB5\u5C06\u88AB\u6807\u8BB0\u4E3A\u5B8C\u6210)",
+      default: false
+    }
+  ]);
+  return passed;
+}
+async function handleRunPhase(worktreeManager, handoffManager, executor2, options) {
+  const { ticket, runPhase: phase, goal } = options;
+  const phaseIndex = parseInt(phase) - 1;
+  const phaseName = PHASE_SEQUENCE[phaseIndex];
+  if (!phaseName) {
+    logger.error(`\u65E0\u6548\u7684\u9636\u6BB5: ${phase}`);
+    return;
+  }
+  logger.step(`\u8FD0\u884C Phase ${phase}: ${getPhaseDisplayName(phaseName)}`);
+  const parallelRoles = getParallelRoles(phaseName);
+  logger.info("\u5C06\u5E76\u884C\u6267\u884C\u7684\u89D2\u8272\u7EC4:");
+  for (const group of parallelRoles) {
+    logger.info(`  - ${group.join(" + ")}`);
+  }
+  const { confirm } = await inquirer13.prompt([
+    {
+      type: "confirm",
+      name: "confirm",
+      message: "\u786E\u8BA4\u5F00\u59CB\u8FD0\u884C?",
+      default: true
+    }
+  ]);
+  if (!confirm) {
+    logger.info("\u5DF2\u53D6\u6D88");
+    return;
+  }
+  const state = await worktreeManager.getSessionState(ticket);
+  if (!state) {
+    logger.error("\u4F1A\u8BDD\u4E0D\u5B58\u5728");
+    return;
+  }
+  const gatePassed = await checkPhaseGate(ticket, phaseName, state.completedPhases);
+  if (!gatePassed) {
+    logger.info("\u95E8\u7981\u68C0\u67E5\u672A\u901A\u8FC7\uFF0C\u8BF7\u5B8C\u6210\u524D\u7F6E\u6761\u4EF6\u540E\u91CD\u8BD5");
+    return;
+  }
+  try {
+    const results = await executor2.executePhase(ticket, phaseName, {
+      TICKET: ticket,
+      GOAL: goal || state.ticket || "",
+      PHASE: phaseName
+    });
+    await executor2.saveReport(ticket, results);
+    await worktreeManager.updateSessionState(ticket, {
+      currentPhase: phaseName
+    });
+    const allSuccess = results.every((r) => r.success);
+    if (allSuccess) {
+      logger.success("\u9636\u6BB5\u6267\u884C\u6210\u529F!");
+    } else {
+      logger.warn("\u90E8\u5206\u4EFB\u52A1\u5931\u8D25\uFF0C\u8BF7\u68C0\u67E5\u8F93\u51FA");
+    }
+  } catch (error) {
+    logger.error(`\u9636\u6BB5\u6267\u884C\u5931\u8D25: ${error}`);
+  }
+}
+async function handleVerifySelect(worktreeManager, handoffManager, options) {
+  const handoffDir = path24.join(process.cwd(), ".handoff");
+  const sessions = await FileUtils.findFiles("session-*.json", handoffDir);
+  if (sessions.length === 0) {
+    logger.error("\u6CA1\u6709\u627E\u5230\u6D3B\u8DC3\u7684\u4F1A\u8BDD");
+    return;
+  }
+  const ticketChoices = sessions.map((s) => {
+    const ticket2 = s.replace("session-", "").replace(".json", "");
+    return { name: ticket2, value: ticket2 };
+  });
+  const { ticket } = await inquirer13.prompt([
+    {
+      type: "list",
+      name: "ticket",
+      message: "\u9009\u62E9\u4F1A\u8BDD:",
+      choices: ticketChoices
+    }
+  ]);
+  await handleVerify(worktreeManager, handoffManager, { ticket });
+}
+async function handleVerify(worktreeManager, handoffManager, options) {
+  const { ticket } = options;
+  logger.step(`\u9A8C\u8BC1\u4EA4\u63A5\u7269: ${ticket}`);
+  const result = await handoffManager.verify(ticket);
+  if (result.complete) {
+    logger.success("\u2705 \u6240\u6709\u4EA4\u63A5\u7269\u5DF2\u5C31\u7EEA!");
+  } else {
+    logger.warn(`\u26A0\uFE0F  \u7F3A\u5C11 ${result.missing.length} \u4E2A\u4EA4\u63A5\u7269:`);
+    for (const item of result.missing) {
+      logger.info(`  - ${item}`);
+    }
+  }
+}
+
 // src/index.ts
-var __dirname2 = path21.dirname(fileURLToPath2(import.meta.url));
-var pkg = fs6.readJsonSync(path21.join(__dirname2, "../package.json"));
-var program = new Command18();
+var __dirname2 = path25.dirname(fileURLToPath2(import.meta.url));
+var pkg = fs9.readJsonSync(path25.join(__dirname2, "../package.json"));
+var program = new Command19();
 program.name("team-cli").description("AI-Native \u56E2\u961F\u7814\u53D1\u811A\u624B\u67B6").version(pkg.version);
 program.option("-v, --verbose", "\u8BE6\u7EC6\u8F93\u51FA\u6A21\u5F0F").option("--debug", "\u8C03\u8BD5\u6A21\u5F0F");
 program.addCommand(initCommand);
@@ -8752,6 +10746,7 @@ program.addCommand(logsCommand);
 program.addCommand(updateCommand);
 program.addCommand(configCommand);
 program.addCommand(diffCommand);
+program.addCommand(devWorktreeCommand);
 program.action(() => {
   showHelp();
 });
@@ -8778,6 +10773,7 @@ function showHelp() {
   console.log("  team-cli update                    \u68C0\u67E5\u5E76\u66F4\u65B0\u6A21\u677F\u7248\u672C");
   console.log("  team-cli config                    \u7BA1\u7406 GitLab \u914D\u7F6E");
   console.log("  team-cli diff                      \u5BF9\u6BD4\u672C\u5730\u4E0E\u8FDC\u7A0B\u6A21\u677F\u5DEE\u5F02");
+  console.log("  team-cli dev:wt [options]         Worktree Orchestrator - \u591A\u89D2\u8272\u5E76\u884C\u5F00\u53D1");
   console.log("  team-cli --help                    \u663E\u793A\u5E2E\u52A9\u4FE1\u606F");
   console.log("");
   console.log(chalk4.bold("\u793A\u4F8B:"));