yg-team-cli 2.5.2 → 2.5.4

package/README.md

@@ -46,6 +46,14 @@
 **v2.5.2** - init 命令新增 prd-docs 目录
 - **新增**: `team-cli init` 现在默认创建 `docs/prd-docs/` 目录供存放 PRD 需求文档
 
+**v2.5.3** - 优化 breakdown 命令合并逻辑
+- **改进**: `breakdown` 现在仅请求生成里程碑部分，并精确合并到原 Spec 文件
+- **修复**: 解决了 `breakdown` 命令可能会覆盖原文件技术设计内容的问题 (防止 Claude 的内容截断)
+
+**v2.5.4** - 修复 dev 模式交互卡死问题
+- **修复**: `dev` 命令现在真正进入交互式 Claude Code 会话，解决之前因非交互模式导致的长时间无反馈和卡死问题
+- **改进**: `ClaudeAI` 类新增 `runTerminal` 方法支持 `stdio: 'inherit'` 交互模式
+
 **v2.4.10** - 修复 Claude 返回权限确认而非实际内容问题
 - **修复**: 添加 `--dangerously-skip-permissions` 参数跳过权限确认
 - **问题**: v2.4.9 中 Claude CLI 在新目录首次运行时返回权限确认提示而非 spec 内容

package/dist/cli.js

@@ -544,6 +544,33 @@ ${promptText}`;
         }
         return await this.prompt(promptText, options);
       }
+      /**
+       * 启动交互式会话
+       */
+      async runTerminal(promptText, _options) {
+        logger.info("\u6B63\u5728\u542F\u52A8\u4EA4\u4E92\u5F0F Claude \u4F1A\u8BDD...");
+        const args = ["--dangerously-skip-permissions"];
+        args.push("--add-dir", process.cwd());
+        try {
+          logger.newLine();
+          logger.info("\u590D\u5236\u4EE5\u4E0B\u6307\u4EE4\u53D1\u9001\u7ED9 Claude:");
+          logger.separator("-", 20);
+          console.log(promptText);
+          logger.separator("-", 20);
+          logger.newLine();
+          await execa("claude", args, {
+            stdio: "inherit",
+            env: { ...process.env, FORCE_COLOR: "1" }
+          });
+        } catch (error) {
+          if (error.signal !== "SIGINT") {
+            throw error;
+          }
+        }
+      }
+      /**
+       * 发送对话（支持上下文）
+       */
       /**
        * 发送对话（支持上下文）
        */
@@ -2517,6 +2544,58 @@ import { Command as Command2 } from "commander";
 import inquirer2 from "inquirer";
 import path8 from "path";
 import { Listr as Listr2 } from "listr2";
+function mergeMilestones(original, milestones) {
+  const milestoneHeader = "## \u91CC\u7A0B\u7891 (Milestones)";
+  const lines = original.split("\n");
+  const headerIndex = lines.findIndex((l) => l.trim().startsWith(milestoneHeader));
+  let cleanedMilestones = milestones.trim();
+  if (!cleanedMilestones.startsWith("## ")) {
+    const firstHeaderIndex = cleanedMilestones.indexOf("## ");
+    if (firstHeaderIndex !== -1) {
+      cleanedMilestones = cleanedMilestones.substring(firstHeaderIndex);
+    } else {
+      cleanedMilestones = `${milestoneHeader}
+
+${cleanedMilestones}`;
+    }
+  }
+  if (headerIndex !== -1) {
+    const beforePart = lines.slice(0, headerIndex).join("\n");
+    const afterPart = lines.slice(headerIndex + 1);
+    const nextHeaderIndex = afterPart.findIndex((l) => l.trim().startsWith("## "));
+    if (nextHeaderIndex !== -1) {
+      const remaining = afterPart.slice(nextHeaderIndex).join("\n");
+      return `${beforePart.trim()}
+
+${cleanedMilestones}
+
+${remaining.trim()}`;
+    } else {
+      return `${beforePart.trim()}
+
+${cleanedMilestones}`;
+    }
+  }
+  const techDesignHeader = "## \u6280\u672F\u8BBE\u8BA1";
+  const techIndex = lines.findIndex((l) => l.trim().startsWith(techDesignHeader));
+  if (techIndex !== -1) {
+    const afterTech = lines.slice(techIndex + 1);
+    const nextHeaderIndex = afterTech.findIndex((l) => l.trim().startsWith("## "));
+    if (nextHeaderIndex !== -1) {
+      const splitPoint = techIndex + 1 + nextHeaderIndex;
+      const before = lines.slice(0, splitPoint).join("\n");
+      const after = lines.slice(splitPoint).join("\n");
+      return `${before.trim()}
+
+${cleanedMilestones}
+
+${after.trim()}`;
+    }
+  }
+  return `${original.trim()}
+
+${cleanedMilestones}`;
+}
 function buildBreakdownPrompt(specContent) {
   return `Role: Senior Technical Lead and Agile Coach
 
@@ -2534,18 +2613,21 @@ ${specContent}
 \`\`\`
 
 Output Requirements:
-1. Parse the existing spec content
-2. Break it down into 2-5 milestones
+1. Parse the existing spec content and identify technical requirements.
+2. Break it down into 2-5 milestones.
 3. Each milestone should have:
    - Clear name and objective
    - Estimated days (1-3 days per milestone)
    - Todo list with 3-8 actionable items
 4. Todo items should be:
-   - Concrete and specific
-   - Testable
-   - Independent as much as possible
+   - Concrete, specific, and testable.
+   - Independent as much as possible.
 
-Format the milestones section as:
+IMPORTANT:
+- Output ONLY the "## \u91CC\u7A0B\u7891 (Milestones)" section.
+- Do NOT output the entire spec file.
+- Do NOT output any preamble or postamble text.
+- Follow this exact format:
 
 \`\`\`markdown
 ## \u91CC\u7A0B\u7891 (Milestones)
@@ -2559,24 +2641,9 @@ Format the milestones section as:
 - [ ] Todo 3 - \u5177\u4F53\u53EF\u6267\u884C\u7684\u4EFB\u52A1
 
 ### Milestone 2: [\u91CC\u7A0B\u7891\u540D\u79F0]
-**\u76EE\u6807**: [\u7B80\u77ED\u63CF\u8FF0\u8FD9\u4E2A\u91CC\u7A0B\u7891\u7684\u76EE\u6807]
-**\u9884\u4F30**: 3 \u5929
-
-- [ ] Todo 1
-- [ ] Todo 2
-- [ ] Todo 3
-- [ ] Todo 4
+...
 \`\`\`
-
-Important Instructions:
-1. Update the spec file directly with the milestone breakdown
-2. Keep all existing content, just add/update the milestones section
-3. If milestones section exists, replace it with new breakdown
-4. If milestones section doesn't exist, add it after "\u6280\u672F\u8BBE\u8BA1" section
-5. After updating the file, exit immediately
-6. Do not ask any questions
-7. Make sure todos are actionable and can be completed independently
-8. Consider dependencies when ordering todos within a milestone`;
+`;
 }
 var breakdownCommand;
 var init_breakdown = __esm({
@@ -2669,7 +2736,8 @@ var init_breakdown = __esm({
           {
             title: "\u66F4\u65B0 spec \u6587\u4EF6",
             task: async (ctx) => {
-              await FileUtils.write(ctx.selectedFile, ctx.breakdownResult);
+              const mergedContent = mergeMilestones(ctx.specContent, ctx.breakdownResult);
+              await FileUtils.write(ctx.selectedFile, mergedContent);
             }
           }
         ]);
@@ -2736,7 +2804,6 @@ async function selectSpec() {
   logger.newLine();
   const choices = sortedSpecs.map((spec, idx) => {
     const statusIcon = getStatusIcon(spec.status);
-    const statusColor = getStatusColor(spec.status);
     const recommendInfo = idx === 0 ? "[\u63A8\u8350\u4ECE\u8FD9\u5F00\u59CB] " : "";
     const depInfo = spec.dependencies.length > 0 ? `[\u4F9D\u8D56: ${spec.dependencies.join(", ")}] ` : "";
     return {
@@ -2871,13 +2938,13 @@ async function executeDevelopment(specFile, milestone, todo) {
   logger.info('   2. \u6309 "a" \u63A5\u53D7\u6240\u6709\u7F16\u8F91\u5EFA\u8BAE\uFF0C\u6216\u9010\u4E2A\u9009\u62E9');
   logger.info("   3. \u5B8C\u6210\u540E\u4F7F\u7528 Ctrl+D \u6216\u8F93\u5165 :exit \u9000\u51FA Claude");
   logger.newLine();
-  const result = await claudeAI.prompt(prompt, {
+  await claudeAI.runTerminal(prompt, {
     contextFiles: ["TECH_STACK.md", "CONVENTIONS.md", "AI_MEMORY.md", specFile]
   });
   logger.newLine();
   logger.separator("\u2500", 60);
   logger.newLine();
-  await generateSessionLog(specFile, milestone, todo, taskDescription, result);
+  await generateSessionLog(specFile, milestone, todo, taskDescription, "\u4EA4\u4E92\u5F0F\u4F1A\u8BDD\u5DF2\u5B8C\u6210");
   await askAndUpdateSpecStatus(specFile, milestone, todo);
   logger.header("\u5F00\u53D1\u4EFB\u52A1\u5B8C\u6210!");
   logger.success("\u4F1A\u8BDD\u65E5\u5FD7\u5DF2\u4FDD\u5B58");
@@ -3003,9 +3070,6 @@ function getStatusIcon(status) {
       return "\u25CB";
   }
 }
-function getStatusColor(status) {
-  return status;
-}
 function buildDevPrompt(specFile, milestone, todo, taskDescription) {
   return `Role: Senior Fullstack Developer