yg-team-cli 2.5.1 → 2.5.3

package/README.md

@@ -43,6 +43,13 @@
 **v2.5.1** - 修复目录创建 bug
 - **修复**: `FileUtils.write` 现在自动创建父目录，解决 `docs/prd-docs/` 不存在时的写入失败问题
 
+**v2.5.2** - init 命令新增 prd-docs 目录
+- **新增**: `team-cli init` 现在默认创建 `docs/prd-docs/` 目录供存放 PRD 需求文档
+
+**v2.5.3** - 优化 breakdown 命令合并逻辑
+- **改进**: `breakdown` 现在仅请求生成里程碑部分，并精确合并到原 Spec 文件
+- **修复**: 解决了 `breakdown` 命令可能会覆盖原文件技术设计内容的问题 (防止 Claude 的内容截断)
+
 **v2.4.10** - 修复 Claude 返回权限确认而非实际内容问题
 - **修复**: 添加 `--dangerously-skip-permissions` 参数跳过权限确认
 - **问题**: v2.4.9 中 Claude CLI 在新目录首次运行时返回权限确认提示而非 spec 内容

package/dist/cli.js

@@ -1702,6 +1702,7 @@ frontend/
 \u2514\u2500\u2500 public/              # \u9759\u6001\u8D44\u6E90
 
 docs/
+\u251C\u2500\u2500 prd-docs/            # PRD \u9700\u6C42\u6587\u6863
 \u251C\u2500\u2500 specs/               # \u529F\u80FD\u89C4\u683C\u6587\u6863
 \u251C\u2500\u2500 api/                 # API \u6587\u6863
 \u2514\u2500\u2500 sessions/            # \u5F00\u53D1\u4F1A\u8BDD\u8BB0\u5F55
@@ -2367,6 +2368,7 @@ var init_init = __esm({
               task: async () => {
                 await FileUtils.ensureDir(projectPath);
                 await FileUtils.ensureDir(path7.join(projectPath, "docs/specs"));
+                await FileUtils.ensureDir(path7.join(projectPath, "docs/prd-docs"));
                 await FileUtils.ensureDir(path7.join(projectPath, "docs/api"));
                 await FileUtils.ensureDir(path7.join(projectPath, "docs/sessions"));
               }
@@ -2515,6 +2517,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
 
@@ -2532,18 +2586,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)
@@ -2557,24 +2614,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({
@@ -2667,7 +2709,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);
             }
           }
         ]);