yg-team-cli 2.7.1 → 2.8.0

package/dist/cli.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);
       }
     };
@@ -4647,8 +4647,8 @@ var init_bugfix = __esm({
           {
             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" });
             }
           },
           {
@@ -4672,9 +4672,9 @@ var init_bugfix = __esm({
           {
             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",
@@ -5754,11 +5754,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)"],
@@ -7205,15 +7205,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;
 }
 var syncMemoryCommand;
 var init_sync_memory = __esm({
@@ -7505,10 +7505,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;
 }
@@ -8090,22 +8090,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 请求
@@ -8604,9 +8604,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];
@@ -8850,12 +8850,2050 @@ var init_diff = __esm({
   }
 });
 
+// src/types/worktree.ts
+var DEFAULT_WORKTREE_CONFIG, DEFAULT_ROLES;
+var init_worktree = __esm({
+  "src/types/worktree.ts"() {
+    "use strict";
+    init_esm_shims();
+    DEFAULT_WORKTREE_CONFIG = {
+      baseDir: "../wt/",
+      handoffDir: ".handoff/",
+      templateDir: ".handoff/templates/"
+    };
+    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
+import { execa as execa5 } from "execa";
+import path21 from "path";
+import fs6 from "fs-extra";
+var WorktreeManager;
+var init_worktree_manager = __esm({
+  "src/lib/worktree-manager.ts"() {
+    "use strict";
+    init_esm_shims();
+    init_worktree();
+    init_logger();
+    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
+import fs7 from "fs-extra";
+import path22 from "path";
+function createHandoffManager(repoRoot) {
+  return new HandoffManager(repoRoot);
+}
+var HandoffManager;
+var init_handoff_manager = __esm({
+  "src/lib/handoff-manager.ts"() {
+    "use strict";
+    init_esm_shims();
+    init_worktree();
+    init_logger();
+    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;
+      }
+    };
+  }
+});
+
+// src/lib/role-prompts.ts
+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;
+}
+var PLANNER_PROMPT, ARCHITECT_PROMPT, BACKEND_PROMPT, FRONTEND_PROMPT, QA_PROMPT, REVIEWER_PROMPT, ROLE_PROMPTS;
+var init_role_prompts = __esm({
+  "src/lib/role-prompts.ts"() {
+    "use strict";
+    init_esm_shims();
+    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`
+    };
+    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`
+    };
+    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`
+    };
+    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`
+    };
+    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`
+    };
+    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`
+    };
+    ROLE_PROMPTS = {
+      planner: PLANNER_PROMPT,
+      architect: ARCHITECT_PROMPT,
+      backend: BACKEND_PROMPT,
+      frontend: FRONTEND_PROMPT,
+      qa: QA_PROMPT,
+      reviewer: REVIEWER_PROMPT
+    };
+  }
+});
+
+// src/lib/phase-config.ts
+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`;
+}
+var PHASE_CONFIGS, PHASE_SEQUENCE, GATE_CONDITIONS;
+var init_phase_config = __esm({
+  "src/lib/phase-config.ts"() {
+    "use strict";
+    init_esm_shims();
+    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
+      }
+    };
+    PHASE_SEQUENCE = [
+      "planning",
+      "architecture",
+      "openapi",
+      "implementation",
+      "bdd",
+      "integration"
+    ];
+    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"
+        }
+      ]
+    };
+  }
+});
+
+// src/lib/concurrent-executor.ts
+import { spawn } from "child_process";
+import path23 from "path";
+import fs8 from "fs-extra";
+function createExecutor(repoRoot) {
+  return new ConcurrentExecutor(repoRoot);
+}
+var ConcurrentExecutor;
+var init_concurrent_executor = __esm({
+  "src/lib/concurrent-executor.ts"() {
+    "use strict";
+    init_esm_shims();
+    init_role_prompts();
+    init_phase_config();
+    init_logger();
+    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;
+      }
+    };
+  }
+});
+
+// src/commands/dev-worktree.ts
+import { Command as Command18 } from "commander";
+import inquirer13 from "inquirer";
+import path24 from "path";
+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}`);
+    }
+  }
+}
+var devWorktreeCommand;
+var init_dev_worktree = __esm({
+  "src/commands/dev-worktree.ts"() {
+    "use strict";
+    init_esm_shims();
+    init_utils();
+    init_logger();
+    init_worktree_manager();
+    init_handoff_manager();
+    init_concurrent_executor();
+    init_phase_config();
+    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);
+      }
+    });
+  }
+});
+
 // src/index.ts
 var index_exports = {};
-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";
 function showHelp() {
   console.log("");
@@ -8880,6 +10918,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:"));
@@ -8938,9 +10977,10 @@ var init_index = __esm({
     init_update();
     init_config();
     init_diff();
-    __dirname2 = path21.dirname(fileURLToPath2(import.meta.url));
-    pkg = fs6.readJsonSync(path21.join(__dirname2, "../package.json"));
-    program = new Command18();
+    init_dev_worktree();
+    __dirname2 = path25.dirname(fileURLToPath2(import.meta.url));
+    pkg = fs9.readJsonSync(path25.join(__dirname2, "../package.json"));
+    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);
@@ -8961,6 +11001,7 @@ var init_index = __esm({
     program.addCommand(updateCommand);
     program.addCommand(configCommand);
     program.addCommand(diffCommand);
+    program.addCommand(devWorktreeCommand);
     program.action(() => {
       showHelp();
     });