speccore 7.5.0 → 8.0.0

package/dist/commands/iteration/split.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"split.d.ts","sourceRoot":"","sources":["../../../src/commands/iteration/split.ts"],"names":[],"mappings":"AAmIA,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAuBD,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+xBzF"}
+{"version":3,"file":"split.d.ts","sourceRoot":"","sources":["../../../src/commands/iteration/split.ts"],"names":[],"mappings":"AAoIA,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAuBD,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+xBzF"}

package/dist/commands/iteration/split.js

@@ -46,6 +46,7 @@ const readline_1 = require("readline");
 const prompt_builder_1 = require("../../core/prompt-builder");
 const index_guard_1 = require("../../core/index-guard");
 const spec_paths_1 = require("../../core/spec-paths");
+const spec_skeleton_1 = require("../../core/spec-skeleton");
 const questions_1 = require("../../core/questions");
 const pipeline_engine_1 = require("../../core/pipeline-engine");
 /**
@@ -1464,6 +1465,10 @@ ${isBk ? apiList : pageList}
             await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'RISK.md'), generateRiskTemplate(section, riskMaterial));
             await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'DEPS.md'), generateDepsTemplate(section, depsMaterial));
             await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'MONITOR.md'), generateMonitorTemplate(section, monitorMaterial));
+            // v8.0.0+: 预创建 REQ.md 和 TECH.md 骨架文件
+            // AI 用 Write 覆盖这些文件，不再自行创建路径（消除路径错误）
+            await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'REQ.md'), `${spec_skeleton_1.SKELETON_MARKER}\n# ${section.name} — ${platformLabel}\n\n> 本文件由 CLI 预创建，请用 Write 工具覆盖为专业需求规格。\n\n## 功能描述\n<!-- AI-FILL: 本端的需求描述 -->\n\n## 验收标准\n<!-- AI-FILL: Given/When/Then 格式 -->\n\n## 业务规则\n<!-- AI-FILL -->\n\n## 边界条件\n<!-- AI-FILL -->\n\n## 异常场景\n<!-- AI-FILL -->\n`);
+            await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'TECH.md'), `${spec_skeleton_1.SKELETON_MARKER}\n# ${section.name} — ${platformLabel} 技术方案\n\n> 本文件由 CLI 预创建，请用 Write 工具覆盖为专业技术方案。\n\n## 接口定义\n<!-- AI-FILL: 请求/响应结构体 -->\n\n## 数据模型\n<!-- AI-FILL: 字段/类型/约束 -->\n\n## 核心逻辑\n<!-- AI-FILL -->\n\n## 依赖说明\n<!-- AI-FILL -->\n`);
             const adr = generateAdr(section);
             if (adr) {
                 await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'ADR.md'), adr);
@@ -3212,17 +3217,20 @@ function parseFunctionMapTree(content, allPlatforms) {
 }
 /**
  * v7.5.0+: 从 ANALYSIS.md 提取功能单元清单
- * 解析按端分节的 F-xx 编号表格，提取每个功能单元及其涉及端
- * 格式: ### X.X 端名（platform-name）— N 个页面 + | F-01 | 功能名 | ...
+ * 支持两种格式：
+ *   A) 按端分节: ### X.X 端名（platform-name）— N 个页面 + | F-01 | 功能名 | ...
+ *   B) 按优先级分节: ### P0 — 必修 + 表格含「涉及端」列（v7.5.1+ 新增）
  */
 function parseAnalysisFunctionalUnits(content, allPlatforms) {
     const units = [];
     const lines = content.split('\n');
     let currentPlatforms = [];
+    let platformColIdx = -1; // 「涉及端」列索引，-1 表示未检测到
     for (let i = 0; i < lines.length; i++) {
         const line = lines[i];
         // 检测 ### 标题行，提取当前端名
         if (line.startsWith('### ')) {
+            const prevPlatforms = [...currentPlatforms]; // 保留上一轮端信息
             currentPlatforms = [];
             // 匹配括号内的端名: ### 1.1 后台管理端（admin-web）
             const parenMatch = line.match(/[（(]([a-zA-Z][\w-]*)[）)]/);
@@ -3241,18 +3249,35 @@ function parseAnalysisFunctionalUnits(content, allPlatforms) {
                 }
             }
             // 后端服务检测
-            if (/后端|服务|backend|service/i.test(line) && currentPlatforms.length === 0) {
+            if (currentPlatforms.length === 0 && /后端|服务|backend|service/i.test(line)) {
                 currentPlatforms.push(...allPlatforms.filter(p => /service|server|api|backend/i.test(p)));
             }
+            // v7.5.1: 标题未匹配到端时，保留上一轮的 currentPlatforms（优先级分节场景）
+            if (currentPlatforms.length === 0) {
+                currentPlatforms = prevPlatforms;
+            }
+            // 遇到新章节，重置列索引（下一张表可能结构不同）
+            platformColIdx = -1;
             continue;
         }
         // 解析表格行
-        if (!line.startsWith('|') || line.includes(':---'))
+        if (!line.startsWith('|'))
             continue;
         const cells = line.split('|').map(c => c.trim()).filter(Boolean);
         if (cells.length < 2)
             continue;
-        // 检测 F-xx 编号行
+        // 分隔行跳过
+        if (line.match(/^\|\s*[-:]/))
+            continue;
+        // 检测表头行：查找「涉及端」/「端」列
+        if (platformColIdx === -1) {
+            const idx = cells.findIndex(c => c === '涉及端' || c === '端' || c.includes('涉及端') || c.includes('涉及工程'));
+            if (idx >= 0) {
+                platformColIdx = idx;
+                continue; // 表头行本身不是数据
+            }
+        }
+        // 检测 F-xx 编号行（支持 | F-01 | 或 | # | 格式）
         const idMatch = cells[0]?.match(/^F-(\d+)$/i);
         if (!idMatch)
             continue;
@@ -3262,8 +3287,35 @@ function parseAnalysisFunctionalUnits(content, allPlatforms) {
             continue;
         // 提取描述（核心功能列，通常是第3或第4列）
         const desc = cells.length >= 4 ? cells[3]?.trim() || '' : '';
-        // 匹配端
-        const platforms = currentPlatforms.length > 0 ? [...currentPlatforms] : [...allPlatforms];
+        // v7.5.1+: 优先从「涉及端」列提取平台（格式 B）
+        let rowPlatforms = [];
+        if (platformColIdx >= 0 && cells[platformColIdx]) {
+            const rawPlatform = cells[platformColIdx];
+            // 按逗号、+、顿号、空格分割
+            const parts = rawPlatform.split(/[,+、;\s]+/).map(s => s.trim()).filter(Boolean);
+            for (const part of parts) {
+                // 精确匹配
+                const exact = allPlatforms.find(p => p === part);
+                if (exact) {
+                    rowPlatforms.push(exact);
+                    continue;
+                }
+                // 模糊匹配（部分名包含）
+                const fuzzy = allPlatforms.filter(p => p.includes(part) || part.includes(p));
+                if (fuzzy.length > 0) {
+                    rowPlatforms.push(...fuzzy);
+                    continue;
+                }
+                // 中文端名映射（如 "后台管理端" → admin-web）
+                // 尝试从 CONSTITUTION 的「对应需求端」列匹配（此处简化：跳过中文值）
+            }
+            // 去重
+            rowPlatforms = [...new Set(rowPlatforms)];
+        }
+        // 回退优先级：涉及端列 → 章节标题 → 全部端
+        const platforms = rowPlatforms.length > 0
+            ? rowPlatforms
+            : (currentPlatforms.length > 0 ? [...currentPlatforms] : [...allPlatforms]);
         units.push({ name, platforms, description: desc, id });
     }
     // 去重（按名称）
@@ -3681,9 +3733,9 @@ async function buildContentFillingPrompt(iteration, iterationDir, sections, allP
     }
     p += `## 填充规则\n\n`;
     p += `1. 先 Read 子任务目录下的 TASK.md（已有基本信息）和 .meta/feature（功能单元名）\n`;
-    p += `2. REQ.md: 基于上方提供的「功能单元相关上下文」，撰写本子任务的需求规格（验收标准、业务规则、边界条件）\n`;
-    p += `3. TECH.md: 基于上下文中的接口定义和数据模型，细化本子任务的技术方案\n`;
-    p += `4. 用 Write 工具直接写入对应路径\n`;
+    p += `2. REQ.md 和 TECH.md 已由 CLI 预创建（含骨架标记），请用 Write 工具直接覆盖为专业内容\n`;
+    p += `3. REQ.md: 基于上方提供的「功能单元相关上下文」，撰写本子任务的需求规格（验收标准、业务规则、边界条件）\n`;
+    p += `4. TECH.md: 基于上下文中的接口定义和数据模型，细化本子任务的技术方案\n`;
     p += `5. 同一功能模块的各端子任务要保持 API 契约一致（前后端接口签名必须匹配）\n`;
     p += `6. 禁止产出垃圾内容——每个文件必须有实质性专业内容\n`;
     p += `7. REQ.md 必须包含：功能描述、验收标准（Given/When/Then）、业务规则、边界条件、异常场景\n`;
@@ -3692,7 +3744,7 @@ async function buildContentFillingPrompt(iteration, iterationDir, sections, allP
     p += `- 不要创建新目录 — 目录已由 CLI 创建\n`;
     p += `- 不要修改 .meta/ 下的文件\n`;
     p += `- 不要修改 TASK.md（已由 CLI 生成）\n`;
-    p += `- 只写 REQ.md 和 TECH.md\n`;
+    p += `- 只覆盖已存在的 REQ.md 和 TECH.md，不要创建新文件\n`;
     p += '\n' + (0, questions_1.buildAutoModeInstruction)('split', iteration) + '\n';
     return p;
 }