speccore 7.4.1 → 7.4.3

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":"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"}
+{"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"}

package/dist/commands/iteration/split.js

@@ -68,7 +68,7 @@ function normalizeScopePlatforms(scopeArr, standardPlatforms) {
             continue;
         }
         // 2. 后端类简写 → 匹配第一个后端端名
-        if (/后端|backend|服务端|server/i.test(s)) {
+        if (/后端|backend|服务端|server|api/i.test(s)) {
             const backendPlatform = standardPlatforms.find(p => /-(service|api|server|backend)$/i.test(p) || p.startsWith('后台'));
             if (backendPlatform && !used.has(backendPlatform)) {
                 result.push(backendPlatform);
@@ -95,6 +95,7 @@ function normalizeScopePlatforms(scopeArr, standardPlatforms) {
             '小程序': ['miniapp', 'mini-app', '小程序'],
             'admin': ['admin-web', 'admin', '后台管理'],
             'web': ['admin-web', 'web', 'h5-mobile'],
+            'frontend': ['admin-web', 'h5-mobile', 'frontend'],
             'app': ['app', 'android', 'ios'],
             '安卓': ['android'],
             'ios': ['ios'],
@@ -108,11 +109,9 @@ function normalizeScopePlatforms(scopeArr, standardPlatforms) {
                 continue;
             }
         }
-        // 5. 无法匹配时保留原始值（后续可能创建非法目录，但至少不丢失信息）
-        if (!used.has(s)) {
-            result.push(s);
-            used.add(s);
-        }
+        // 5. v7.4.2+: 无法匹配时警告并跳过，不保留非标准端名
+        logger_1.logger.warn(`   ⚠️  非标准端名 "${s}"，无法映射到 CONSTITUTION.md 标准端名 ${standardPlatforms.join('/')}`);
+        logger_1.logger.warn(`      已跳过该端，请检查 AI 输出的 scope 字段`);
     }
     return result.length > 0 ? result : standardPlatforms;
 }
@@ -703,7 +702,7 @@ async function iterationSplitCommand(options) {
             // v6.76.0+: 传入过滤条件，限制拆分范围；传入已有 Task 结构，支持增量拆分
             const modulesFilter = options.modules ? options.modules.split(',').map(m => m.trim()).filter(Boolean) : undefined;
             const platformsFilter = options.platforms ? options.platforms.split(',').map(p => p.trim()).filter(Boolean) : undefined;
-            let splitPrompt = buildSplitPrompt(iteration, constitutionContent, reqContent2, specContents, allPlatforms, modulesFilter, platformsFilter, existingTaskStructure);
+            let splitPrompt = await buildSplitPrompt(iteration, constitutionContent, reqContent2, specContents, allPlatforms, modulesFilter, platformsFilter, existingTaskStructure, iterationDir);
             // 注入全局上下文（INDEX + TOC 目录，AI 自主读取）
             const { loadGlobalContext, formatGlobalContext } = await Promise.resolve().then(() => __importStar(require('../../core/prompt-builder')));
             const globalCtx = await loadGlobalContext(process.cwd(), 'split');
@@ -2446,7 +2445,7 @@ ${isH5 ? '移动端优先，适配 375/414/768' :
 /**
  * 构建完整的 AI 智能拆分 Prompt（含 SpecCore 理念 + 粒度规则 + 完整上下文）
  */
-function buildSplitPrompt(iteration, constitutionContent, reqContent, specContents, standardPlatforms, modulesFilter, platformsFilter, existingTasks) {
+async function buildSplitPrompt(iteration, constitutionContent, reqContent, specContents, standardPlatforms, modulesFilter, platformsFilter, existingTasks, iterationDir) {
     let p = `# SpecCore AI 智能拆分\n\n`;
     p += `> 迭代: ${iteration} | 生成: ${new Date().toISOString().split('T')[0]}\n\n`;
     // v6.76.0+: 拆分范围限制
@@ -2490,21 +2489,40 @@ function buildSplitPrompt(iteration, constitutionContent, reqContent, specConten
     }
     // v6.69.3+: 注入标准端名列表
     if (standardPlatforms.length > 0) {
-        p += `## 🖥️ 项目端列表（标准端名）\n\n`;
+        p += `## 🖥️ 项目端列表（标准端名 — 权威来源）\n\n`;
         p += `本项目已配置以下端，所有 scope 必须使用这些**标准端名**，禁止使用简写或中文：\n\n`;
         p += `\`${standardPlatforms.join('`, `')}\`\n\n`;
-        p += `- 后端端名示例: \`booking-service\`, \`room-service\`（不是 "后端"、"backend"）\n`;
-        p += `- 前端端名示例: \`admin-web\`, \`h5-mobile\`（不是 "web"、"admin"、"h5"）\n`;
-        p += `- **scope 数组必须使用上述标准端名**，否则会导致目录结构错误\n\n`;
+        p += `- ⛔ **禁止使用以下非标准端名**: \`api\`、\`web\`、\`backend\`、\`frontend\`、\`admin\`、\`h5\`、\"后端\"、\"前端\"\n`;
+        p += `- ✅ **必须使用 CONSTITUTION.md 中的标准端名**作为子任务目录名\n`;
+        p += `- scope 数组和子任务目录名必须完全匹配上述标准端名\n\n`;
     }
-    // v6.69.3+: 注入标准端名列表
-    if (standardPlatforms.length > 0) {
-        p += `## 🖥️ 项目端列表（标准端名）\n\n`;
-        p += `本项目已配置以下端，所有 scope 必须使用这些**标准端名**，禁止使用简写或中文：\n\n`;
-        p += `\`${standardPlatforms.join('`, `')}\`\n\n`;
-        p += `- 后端端名示例: \`booking-service\`, \`room-service\`（不是 "后端"、"backend"）\n`;
-        p += `- 前端端名示例: \`admin-web\`, \`h5-mobile\`（不是 "web"、"admin"、"h5"）\n`;
-        p += `- **scope 数组必须使用上述标准端名**，否则会导致目录结构错误\n\n`;
+    // v7.4.2+: 功能单元精准上下文（CLI 提取，AI 拆分）
+    if (iterationDir) {
+        try {
+            const funcMapPath = (0, path_1.join)(iterationDir, '020-specs', spec_paths_1.GLOBAL_SPECS_DIR, 'FUNCTION_MAP.md');
+            if (await (0, fs_extra_1.pathExists)(funcMapPath)) {
+                const funcMapContent = await (0, fs_extra_1.readFile)(funcMapPath, 'utf-8');
+                const funcUnits = parseFunctionMap(funcMapContent, standardPlatforms);
+                if (funcUnits.length > 0) {
+                    p += `## 🧩 功能单元上下文（CLI 从分析文档精准提取）\n\n`;
+                    p += `> 以下是从 FUNCTION_MAP.md / REQUIREMENT.md / _INDEX.md / _MODULES.md 中为每个功能单元提取的相关上下文。\n`;
+                    p += `> 拆分时必须基于这些功能单元，每个功能单元对应 1~3 个任务。\n\n`;
+                    for (const unit of funcUnits) {
+                        const unitCtx = await assembleUnitContext(iterationDir, unit.name, unit.platforms);
+                        p += `### 📌 功能单元: ${unit.name}\n`;
+                        p += `- 涉及端: ${unit.platforms.join(', ')}\n`;
+                        if (unit.sharedCapability && unit.sharedCapability !== '无')
+                            p += `- 共享能力: ${unit.sharedCapability}\n`;
+                        if (unit.dependsOn && unit.dependsOn.length > 0)
+                            p += `- 依赖: ${unit.dependsOn.join(', ')}\n`;
+                        if (unit.description)
+                            p += `- 说明: ${unit.description}\n`;
+                        p += `\n${unitCtx}\n\n---\n\n`;
+                    }
+                }
+            }
+        }
+        catch { }
     }
     // SpecCore 拆分原则
     p += `## ⚙️ SpecCore 拆分原则\n\n`;
@@ -2618,14 +2636,19 @@ function buildSplitPrompt(iteration, constitutionContent, reqContent, specConten
     p += `>   - 直接写入 00-specs/TECH.md，执行时 AI 据此直接开发\n`;
     p += `> **质量红线**：如果 reqContent/techContent 只有标题和占位符（如 "<!-- AI-FILL -->"），视为不合格，必须重新生成\n\n`;
     p += `### ⚠️ 拆分规则（重要）\n\n`;
+    p += `- **按功能单元拆分，不按技术层拆分**：每个任务必须对应一个业务功能（如「预订管理」「签到」「审批」），不要按技术层分组（如「后端改进」「前端修复」）\n`;
+    p += `- ❌ 错误示例：Task-129-backend-improve、Task-130-admin-fix（按技术层分组）\n`;
+    p += `- ✅ 正确示例：Task-129-booking-crud、Task-130-checkin-flow、Task-131-approval-management（按功能单元分组）\n`;
+    p += `- **topic 必须反映功能单元**：每个任务的 topic（目录名后缀）必须唯一且反映业务功能，禁止所有任务都用同一个后缀（如 -impl）\n`;
+    p += `- **scope 必须使用标准端名**：禁止使用 api/web/backend/frontend 等非标准名称\n`;
     p += `- **一个功能单元默认 1 个任务**，最多拆成 3 个\n`;
-    p += `- **按 scope 涉及的端创建子任务**：每个端 1 个子任务目录\n`;
-    p += `- **不要按端拆分任务**：同一功能的前后端各端工作在一个任务里，按端拆分子任务\n`;
-    p += `- **用户不满意时可手动拆分**：CLI 提供简单的默认拆分，复杂拆分由用户手动调整\n\n`;
+    p += `- **按 scope 涉及的端创建子任务**：每个端 1 个子任务目录\n\n`;
     // 质量自检
     p += `## ✅ 质量自检（必须全部通过）\n\n`;
     p += `□ 每个任务都满足原子任务定义？\n`;
-    p += `□ 每个任务的 scope 只包含必要的端？\n`;
+    p += `□ **每个任务按功能单元命名，不是按技术层**？（禁止 backend-improve/admin-fix 这类名称）\n`;
+    p += `□ **每个 topic 唯一且反映业务功能**？（禁止全部用 -impl）\n`;
+    p += `□ **scope 只包含 CONSTITUTION.md 标准端名**？（禁止 api/web/backend/frontend）\n`;
     p += `□ 没有循环依赖？\n`;
     p += `□ 基础模块排在前面？\n`;
     p += `□ 同功能单元内的任务没被过度拆分？（每个功能单元 ≤ 3 个任务）\n`;
@@ -2912,38 +2935,46 @@ speccore analyze --task ${taskId}${iterFlag}
 // ── v6.49.14+: 模块驱动拆分 — 从 overview/REQUIREMENT.md 读取涉及端 ──
 /**
  * 从 overview/REQUIREMENT.md 解析功能模块清单的「涉及端」列
+ * 支持两种格式：
+ *   1. 单表格含「涉及端」列（功能模块 | 涉及端 | ...）
+ *   2. 按端分节（### X.X ... — {platform} 后跟表格）
  * 返回模块列表及其涉及的标准端名
  */
 function parseModulePlatforms(content, allPlatforms) {
+    // v7.4.2+: 先尝试原始格式（单表格含「涉及端」列）
+    const tableResult = parseModulePlatformsTable(content, allPlatforms);
+    if (tableResult.length > 0)
+        return tableResult;
+    // v7.4.2+: 回退到按端分节格式
+    return parseModulePlatformsBySection(content, allPlatforms);
+}
+/**
+ * v7.4.2+: 解析单表格含「涉及端」列的格式
+ */
+function parseModulePlatformsTable(content, allPlatforms) {
     const modules = [];
     const lines = content.split('\n');
     let inFeatureTable = false;
     let platformColIdx = -1;
     for (const line of lines) {
-        // 检测功能模块清单表格开始
         if (line.includes('功能模块清单')) {
             inFeatureTable = true;
             continue;
         }
         if (!inFeatureTable)
             continue;
-        // 检测下一个 ## 标题 → 表格结束
-        if (line.startsWith('## ') && !line.includes('功能模块清单')) {
+        if (line.startsWith('## ') && !line.includes('功能模块清单'))
             break;
-        }
         const cells = line.split('|').map(c => c.trim()).filter(Boolean);
         if (cells.length < 2)
             continue;
-        // 表头行 → 找到「涉及端」列索引
         if (cells.some(c => c.includes('涉及端'))) {
             platformColIdx = cells.findIndex(c => c.includes('涉及端'));
             continue;
         }
-        // 分隔行跳过
         if (cells.every(c => /^[-:]+$/.test(c)))
             continue;
-        // 数据行
-        const moduleName = cells[1]; // 第2列通常是模块名
+        const moduleName = cells[1];
         if (!moduleName || moduleName === '#' || moduleName === '模块')
             continue;
         if (platformColIdx >= 0 && platformColIdx < cells.length) {
@@ -2958,16 +2989,93 @@ function parseModulePlatforms(content, allPlatforms) {
                 }
             }
         }
-        // 涉及端为空或无法解析 → 回退全端
         modules.push({ name: moduleName, platforms: [...allPlatforms] });
     }
     return modules;
 }
+/**
+ * v7.4.2+: 解析按端分节的 REQUIREMENT.md 格式
+ * 匹配: ### 2.1 后端 — booking-service 或 ### 2.1 前端 — admin-web
+ * 从标题提取端名，从后续表格提取模块名，建立模块→端的映射
+ */
+function parseModulePlatformsBySection(content, allPlatforms) {
+    const lines = content.split('\n');
+    // 模块名 → 涉及端列表 的映射
+    const modulePlatformMap = new Map();
+    let currentPlatform = '';
+    let inTable = false;
+    for (const line of lines) {
+        // 检测按端分节标题: ### 2.1 后端 — booking-service
+        const sectionMatch = line.match(/^###\s+[\d.]+\s+.*[—\-–]\s*(.+)$/);
+        if (sectionMatch) {
+            const rawPlatform = sectionMatch[1].trim();
+            // 匹配标准端名
+            currentPlatform = allPlatforms.find(p => rawPlatform.includes(p)) || '';
+            inTable = false;
+            continue;
+        }
+        // 非当前端标题下的 ## 标题 → 重置
+        if (line.startsWith('## ') && !line.startsWith('### ')) {
+            currentPlatform = '';
+            inTable = false;
+            continue;
+        }
+        if (!currentPlatform)
+            continue;
+        // 检测表格开始（表头行含「功能模块」）
+        const cells = line.split('|').map(c => c.trim()).filter(Boolean);
+        if (cells.length >= 2 && cells.some(c => c.includes('功能模块'))) {
+            inTable = true;
+            continue;
+        }
+        if (!inTable)
+            continue;
+        // 分隔行跳过
+        if (cells.every(c => /^[-:]+$/.test(c)))
+            continue;
+        // 表头行跳过
+        if (cells.some(c => c === '功能模块' || c === '模块'))
+            continue;
+        // 数据行：第1列或第2列是模块名
+        const moduleName = cells[0] && cells[0] !== '功能模块' ? cells[0] : (cells[1] || '');
+        if (!moduleName || moduleName.length < 2)
+            continue;
+        // 跳过状态标记行
+        if (moduleName.startsWith('#'))
+            continue;
+        // 添加到映射
+        const existing = modulePlatformMap.get(moduleName) || [];
+        if (!existing.includes(currentPlatform)) {
+            existing.push(currentPlatform);
+        }
+        modulePlatformMap.set(moduleName, existing);
+    }
+    // 转换为结果数组
+    const modules = [];
+    for (const [name, platforms] of modulePlatformMap) {
+        modules.push({ name, platforms: platforms.length > 0 ? platforms : [...allPlatforms] });
+    }
+    return modules;
+}
 /**
  * v6.70.0+: 解析 FUNCTION_MAP.md 跨端功能映射表
+ * 支持两种格式：
+ *   1. Markdown 表格（功能单元 | 涉及端 | ...）
+ *   2. 树形格式（├── 模块名 ... platform1 ✅ | platform2 ✅）
  * 返回功能单元列表，含涉及端、共享能力、依赖关系
  */
 function parseFunctionMap(content, allPlatforms) {
+    // v7.4.2+: 先尝试表格格式
+    const tableResult = parseFunctionMapTable(content, allPlatforms);
+    if (tableResult.length > 0)
+        return tableResult;
+    // v7.4.2+: 回退到树形格式解析
+    return parseFunctionMapTree(content, allPlatforms);
+}
+/**
+ * v7.4.2+: 解析 FUNCTION_MAP.md 表格格式
+ */
+function parseFunctionMapTable(content, allPlatforms) {
     const units = [];
     const lines = content.split('\n');
     let inTable = false;
@@ -2976,10 +3084,8 @@ function parseFunctionMap(content, allPlatforms) {
     let dependsOnColIdx = -1;
     let descColIdx = -1;
     for (const line of lines) {
-        // 检测映射表开始（通过表头特征）
         if (line.includes('功能单元') && line.includes('涉及端')) {
             inTable = true;
-            // 解析表头，找到各列索引
             const headerCells = line.split('|').map(c => c.trim()).filter(Boolean);
             platformColIdx = headerCells.findIndex(c => c.includes('涉及端'));
             sharedCapColIdx = headerCells.findIndex(c => c.includes('共享能力'));
@@ -2989,47 +3095,33 @@ function parseFunctionMap(content, allPlatforms) {
         }
         if (!inTable)
             continue;
-        // 检测下一个 ## 标题 → 表格结束
-        if (line.startsWith('## ') && !line.includes('功能映射')) {
+        if (line.startsWith('## ') && !line.includes('功能映射'))
             break;
-        }
         const cells = line.split('|').map(c => c.trim()).filter(Boolean);
         if (cells.length < 3)
             continue;
-        // 分隔行跳过
         if (cells.every(c => /^[-:]+$/.test(c)))
             continue;
-        // 表头行（已经处理过，跳过）
-        if (cells.some(c => c.includes('功能单元')) || cells.some(c => c.includes('涉及端'))) {
+        if (cells.some(c => c.includes('功能单元')) || cells.some(c => c.includes('涉及端')))
             continue;
-        }
-        // 数据行：第2列是功能单元名
         const unitName = cells[1];
         if (!unitName || unitName === '#' || unitName === '功能单元')
             continue;
-        // 解析涉及端
         let platforms = [];
         if (platformColIdx >= 0 && platformColIdx < cells.length) {
             const raw = cells[platformColIdx];
             if (raw && raw !== '无' && raw !== '—' && raw !== '-') {
-                platforms = raw.split(/[,，]/)
-                    .map(p => p.trim())
-                    .filter(p => p && allPlatforms.includes(p));
+                platforms = raw.split(/[,，]/).map(p => p.trim()).filter(p => p && allPlatforms.includes(p));
             }
         }
-        // 涉及端为空 → 回退全端（但保留空列表表示纯文档/无开发）
-        if (platforms.length === 0) {
+        if (platforms.length === 0)
             platforms = [...allPlatforms];
-        }
-        // 解析共享能力
         let sharedCapability = '无';
         if (sharedCapColIdx >= 0 && sharedCapColIdx < cells.length) {
             const raw = cells[sharedCapColIdx];
-            if (raw && raw !== '无' && raw !== '—' && raw !== '-') {
+            if (raw && raw !== '无' && raw !== '—' && raw !== '-')
                 sharedCapability = raw;
-            }
         }
-        // 解析依赖任务
         let dependsOn = [];
         if (dependsOnColIdx >= 0 && dependsOnColIdx < cells.length) {
             const raw = cells[dependsOnColIdx];
@@ -3037,15 +3129,62 @@ function parseFunctionMap(content, allPlatforms) {
                 dependsOn = raw.split(/[,，]/).map(p => p.trim()).filter(Boolean);
             }
         }
-        // 解析说明
         let description = '';
-        if (descColIdx >= 0 && descColIdx < cells.length) {
+        if (descColIdx >= 0 && descColIdx < cells.length)
             description = cells[descColIdx];
-        }
         units.push({ name: unitName, platforms, sharedCapability, dependsOn, description });
     }
     return units;
 }
+/**
+ * v7.4.2+: 解析 FUNCTION_MAP.md 树形格式
+ * 匹配: ├── 会议室 CRUD .............. room-service ✅ | admin-web ✅
+ * 提取: 模块名="会议室 CRUD", 涉及端=[room-service, admin-web]
+ */
+function parseFunctionMapTree(content, allPlatforms) {
+    const units = [];
+    const lines = content.split('\n');
+    // 树形节点正则：匹配 ├── 或 └── 开头的行
+    const treeNodeRe = /[├└]──\s*/;
+    // 分隔点正则：匹配连续 .... 或 ———
+    const separatorRe = /\s*[.·]{3,}\s*/;
+    for (const line of lines) {
+        if (!treeNodeRe.test(line))
+            continue;
+        // 提取树节点后的文本
+        const afterTree = line.replace(/.*[├└]──\s*/, '').trim();
+        if (!afterTree)
+            continue;
+        // 跳过分类型节点（如 ├── 🏢 会议室管理），这些是父级分类
+        // 父级节点通常没有 ... 分隔符和平台标记
+        if (!separatorRe.test(afterTree) && !afterTree.includes('✅') && !afterTree.includes('❌') && !afterTree.includes('⚠️')) {
+            continue; // 这是分类父节点，跳过
+        }
+        // 分割模块名和平台部分
+        const parts = afterTree.split(separatorRe);
+        if (parts.length < 2)
+            continue;
+        // 模块名：去除 emoji 和空格
+        let unitName = parts[0].replace(/[🏢📅✅💰🔔👥📊⚙️🔑🛡️]/g, '').trim();
+        if (!unitName || unitName.length < 2)
+            continue;
+        // 平台部分：提取所有标准端名
+        const platformPart = parts.slice(1).join(' ');
+        const platforms = [];
+        for (const p of allPlatforms) {
+            if (platformPart.includes(p)) {
+                platforms.push(p);
+            }
+        }
+        // 如果没匹配到标准端名，尝试匹配常见缩写
+        if (platforms.length === 0) {
+            // 回退全端
+            platforms.push(...allPlatforms);
+        }
+        units.push({ name: unitName, platforms, sharedCapability: '无', dependsOn: [], description: '' });
+    }
+    return units;
+}
 /**
  * 尝试模块驱动拆分：从功能模块创建任务目录结构
  * 成功返回 true，无功能模块时返回 false（回退到传统流程）
@@ -3242,7 +3381,7 @@ async function tryModuleDrivenSplit(iteration, iterationDir, options) {
         await generateImpactGraph(iterationDir, createdSections, allPlatforms);
         logger_1.logger.info(`\n   📊 创建了 ${createdSections.length} 个任务（每端一个子任务）`);
         // 生成内容填充提示
-        const fillPrompt = buildContentFillingPrompt(iteration, iterationDir, createdSections, allPlatforms);
+        const fillPrompt = await buildContentFillingPrompt(iteration, iterationDir, createdSections, allPlatforms);
         const promptsDir = (0, path_1.join)('.speccore', 'prompts');
         await (0, fs_extra_1.ensureDir)(promptsDir);
         await (0, fs_extra_1.writeFile)((0, path_1.join)(promptsDir, `split-content-${iteration}.md`), fillPrompt);
@@ -3258,22 +3397,152 @@ async function tryModuleDrivenSplit(iteration, iterationDir, options) {
     catch { }
     return true;
 }
+/**
+ * v7.4.2+: 按功能单元从各分析文档中精准提取相关上下文
+ * CLI 做计算（提取），AI 做内容（填充）
+ */
+async function assembleUnitContext(iterationDir, unitName, platforms) {
+    const specsBase = (0, path_1.join)(iterationDir, '020-specs');
+    const overviewDir = (0, path_1.join)(specsBase, spec_paths_1.GLOBAL_SPECS_DIR);
+    const ctx = [];
+    // 关键词拆分：将功能单元名拆成多个搜索词（如「预订管理」→「预订」「管理」）
+    const keywords = unitName.split(/(?<=[\u4e00-\u9fff])(?=[\u4e00-\u9fff])/).filter(k => k.length >= 1);
+    // 也加入英文关键词（如 booking、checkin）
+    const slugKeywords = slugify(unitName).split('-').filter(k => k.length >= 3);
+    const allKeywords = [...keywords, ...slugKeywords];
+    const matchLine = (line) => allKeywords.some(k => line.includes(k));
+    // 1. 从 overview/REQUIREMENT.md 提取相关章节
+    const reqPath = (0, path_1.join)(overviewDir, 'REQUIREMENT.md');
+    if (await (0, fs_extra_1.pathExists)(reqPath)) {
+        try {
+            const content = await (0, fs_extra_1.readFile)(reqPath, 'utf-8');
+            const lines = content.split('\n');
+            const relevant = [];
+            let inRelevantSection = false;
+            for (const line of lines) {
+                if (line.startsWith('## ') || line.startsWith('### ')) {
+                    inRelevantSection = matchLine(line);
+                }
+                if (inRelevantSection || (line.startsWith('|') && matchLine(line))) {
+                    relevant.push(line);
+                }
+            }
+            if (relevant.length > 0) {
+                ctx.push(`### 📋 需求规格（REQUIREMENT.md 相关片段）\n\`\`\`\n${relevant.slice(0, 60).join('\n')}\n\`\`\``);
+            }
+        }
+        catch { }
+    }
+    // 2. 从 platforms/_shared/_MODULES.md 提取相关模块
+    const modulesPath = (0, path_1.join)(specsBase, 'platforms', '_shared', '_MODULES.md');
+    if (await (0, fs_extra_1.pathExists)(modulesPath)) {
+        try {
+            const content = await (0, fs_extra_1.readFile)(modulesPath, 'utf-8');
+            const lines = content.split('\n');
+            const relevant = [];
+            let inRelevantBlock = false;
+            let blockLines = [];
+            for (const line of lines) {
+                if (line.startsWith('## ')) {
+                    // 保存上一个块
+                    if (inRelevantBlock && blockLines.length > 0) {
+                        relevant.push(...blockLines);
+                    }
+                    inRelevantBlock = matchLine(line);
+                    blockLines = [line];
+                }
+                else if (inRelevantBlock) {
+                    blockLines.push(line);
+                }
+                else if (line.startsWith('|') && matchLine(line)) {
+                    relevant.push(line);
+                }
+            }
+            if (inRelevantBlock && blockLines.length > 0)
+                relevant.push(...blockLines);
+            if (relevant.length > 0) {
+                ctx.push(`### 🧩 功能模块（_MODULES.md 相关片段）\n\`\`\`\n${relevant.slice(0, 50).join('\n')}\n\`\`\``);
+            }
+        }
+        catch { }
+    }
+    // 3. 从各端 _INDEX.md 提取相关接口/页面
+    for (const platform of platforms) {
+        const indexPath = (0, path_1.join)(specsBase, 'platforms', platform, '_INDEX.md');
+        if (await (0, fs_extra_1.pathExists)(indexPath)) {
+            try {
+                const content = await (0, fs_extra_1.readFile)(indexPath, 'utf-8');
+                const lines = content.split('\n');
+                const relevant = [];
+                let inRelevantSection = false;
+                for (const line of lines) {
+                    if (line.startsWith('## ') || line.startsWith('### ')) {
+                        inRelevantSection = matchLine(line);
+                    }
+                    if (inRelevantSection || (line.startsWith('|') && matchLine(line))) {
+                        relevant.push(line);
+                    }
+                }
+                if (relevant.length > 0) {
+                    ctx.push(`### 🖥️ ${platform} 端相关（_INDEX.md 片段）\n\`\`\`\n${relevant.slice(0, 40).join('\n')}\n\`\`\``);
+                }
+            }
+            catch { }
+        }
+    }
+    // 4. 从 overview/FUNCTION_MAP.md 提取本单元行 + 依赖单元
+    const funcMapPath = (0, path_1.join)(overviewDir, 'FUNCTION_MAP.md');
+    if (await (0, fs_extra_1.pathExists)(funcMapPath)) {
+        try {
+            const content = await (0, fs_extra_1.readFile)(funcMapPath, 'utf-8');
+            const lines = content.split('\n');
+            const matchedRows = lines.filter(l => l.startsWith('|') && matchLine(l));
+            if (matchedRows.length > 0) {
+                ctx.push(`### 🗺️ 功能映射（FUNCTION_MAP.md）\n\`\`\`\n${matchedRows.join('\n')}\n\`\`\``);
+            }
+        }
+        catch { }
+    }
+    // 5. 从 overview/TECH.md 提取相关架构信息
+    const techPath = (0, path_1.join)(overviewDir, 'TECH.md');
+    if (await (0, fs_extra_1.pathExists)(techPath)) {
+        try {
+            const content = await (0, fs_extra_1.readFile)(techPath, 'utf-8');
+            const lines = content.split('\n');
+            const relevant = [];
+            let inRelevantSection = false;
+            for (const line of lines) {
+                if (line.startsWith('## ') || line.startsWith('### ')) {
+                    inRelevantSection = matchLine(line);
+                }
+                if (inRelevantSection)
+                    relevant.push(line);
+            }
+            if (relevant.length > 0) {
+                ctx.push(`### 🏗️ 技术架构相关（TECH.md 片段）\n\`\`\`\n${relevant.slice(0, 40).join('\n')}\n\`\`\``);
+            }
+        }
+        catch { }
+    }
+    if (ctx.length === 0) {
+        return `> 功能单元「${unitName}」未在分析文档中找到直接相关内容，请根据全局文档推断。`;
+    }
+    return ctx.join('\n\n');
+}
 /**
  * 生成内容填充 Prompt — AI 为预创建的任务填充 REQ.md/TECH.md
+ * v7.4.2+: 每个功能单元注入精准上下文，而非让 AI 自己从全量文档中查找
  */
-function buildContentFillingPrompt(iteration, iterationDir, sections, allPlatforms) {
+async function buildContentFillingPrompt(iteration, iterationDir, sections, allPlatforms) {
     let p = `# 任务内容填充（模块驱动拆分）\n\n`;
     p += `> 迭代: ${iteration} | 任务数: ${sections.length} | 端: ${allPlatforms.join(', ')}\n\n`;
     p += `## 说明\n\n`;
-    p += `CLI 已按功能模块×端创建了任务目录结构。每个任务目录下已有子任务目录（含 .meta/、TASK.md 等）。\n`;
+    p += `CLI 已按功能单元×端创建了任务目录结构，并为每个功能单元从分析文档中提取了相关上下文。\n`;
     p += `你的任务是为每个子任务填充 REQ.md 和 TECH.md。\n\n`;
-    p += `## 上下文\n\n`;
+    p += `## 全局上下文\n\n`;
     p += `1. Read .speccore/CONSTITUTION.md — 项目配置\n`;
-    p += `2. Read 020-specs/overview/REQUIREMENT.md — 迭代综合需求规格\n`;
-    p += `3. Read 020-specs/overview/ANALYSIS.md — 迭代综合分析报告\n`;
-    p += `4. Read 020-specs/overview/TECH.md — 迭代综合技术架构\n`;
-    p += `5. Read 020-specs/{端}/TECH.md — 各端专属技术方案\n\n`;
-    p += `## 任务清单\n\n`;
+    p += `2. Read 020-specs/overview/ANALYSIS.md — 迭代综合分析报告\n\n`;
+    p += `## 任务清单（含精准上下文）\n\n`;
     for (const sec of sections) {
         const taskId = sec._taskId || sec.name;
         const sourceFile = sec._sourceFile || '';
@@ -3290,15 +3559,20 @@ function buildContentFillingPrompt(iteration, iterationDir, sections, allPlatfor
             p += `  - ${platform}/*/REQ.md — 子任务需求规格\n`;
             p += `  - ${platform}/*/TECH.md — 子任务技术方案\n`;
         }
+        // v7.4.2+: 注入该功能单元的精准上下文
+        const unitCtx = await assembleUnitContext(iterationDir, featureName, modPlatforms);
+        p += `\n#### 📎 功能单元「${featureName}」相关上下文\n\n${unitCtx}\n\n`;
         p += `\n`;
     }
     p += `## 填充规则\n\n`;
     p += `1. 先 Read 子任务目录下的 TASK.md（已有基本信息）和 .meta/feature（功能单元名）\n`;
-    p += `2. REQ.md: 根据全局需求文档，撰写本子任务的需求规格（验收标准、业务规则、边界条件）\n`;
-    p += `3. TECH.md: 根据全局 TECH.md，细化本子任务的技术方案（接口定义、数据模型、核心逻辑）\n`;
+    p += `2. REQ.md: 基于上方提供的「功能单元相关上下文」，撰写本子任务的需求规格（验收标准、业务规则、边界条件）\n`;
+    p += `3. TECH.md: 基于上下文中的接口定义和数据模型，细化本子任务的技术方案\n`;
     p += `4. 用 Write 工具直接写入对应路径\n`;
-    p += `5. 同一功能模块的各端子任务要保持 API 契约一致\n`;
-    p += `6. 禁止产出垃圾内容——每个文件必须有实质性专业内容\n\n`;
+    p += `5. 同一功能模块的各端子任务要保持 API 契约一致（前后端接口签名必须匹配）\n`;
+    p += `6. 禁止产出垃圾内容——每个文件必须有实质性专业内容\n`;
+    p += `7. REQ.md 必须包含：功能描述、验收标准（Given/When/Then）、业务规则、边界条件、异常场景\n`;
+    p += `8. TECH.md 必须包含：接口定义（请求/响应结构体）、数据模型（字段/类型/约束）、核心算法/逻辑、依赖说明\n\n`;
     p += `## ⚠️ 绝对禁止\n\n`;
     p += `- 不要创建新目录 — 目录已由 CLI 创建\n`;
     p += `- 不要修改 .meta/ 下的文件\n`;