speccore 6.6.0 → 6.11.0

package/dist/commands/iteration/split.js

@@ -45,6 +45,7 @@ const next_steps_1 = require("../../core/next-steps");
 const readline_1 = require("readline");
 const prompt_builder_1 = require("../../core/prompt-builder");
 const platform_registry_1 = require("../../core/platform-registry");
+const index_guard_1 = require("../../core/index-guard");
 /** 将名称转为目录安全的短 slug（2-4 词） */
 function slugify(name) {
     const cleaned = name
@@ -252,6 +253,12 @@ async function iterationSplitCommand(options) {
                         section._reqContent = task.reqContent;
                     if (task.techContent)
                         section._techContent = task.techContent;
+                    if (task.sourceFile)
+                        section._sourceFile = task.sourceFile;
+                    if (task.functionalUnit)
+                        section.functionalUnit = task.functionalUnit;
+                    if (task.reason)
+                        section._reason = task.reason;
                     if (taskScopePlatforms.length > 0)
                         section._scopePlatforms = taskScopePlatforms;
                     sections.push(section);
@@ -416,7 +423,7 @@ async function iterationSplitCommand(options) {
                     const taskTopic = sec._topic || slugify(sec.name);
                     const { id: taskId } = await (0, global_counters_1.nextTaskId)(sec.name, taskTopic);
                     sec._taskId = taskId;
-                    await createTaskFromSection(iterDirFull, taskId, sec, allPlatforms, taskType);
+                    await createTaskFromSection(iterDirFull, taskId, sec, allPlatforms, taskType, sections);
                     createdSections.push(sec);
                     logger_1.logger.info(`   ✅ 创建: ${taskId} - [${taskType}] ${sec.name}`);
                 }
@@ -465,6 +472,8 @@ async function iterationSplitCommand(options) {
         }
         return;
     }
+    // 命令前索引新鲜度检查（非阻塞）
+    await (0, index_guard_1.warnIfIndexStale)(process.cwd(), 'split', options.iteration);
     const spinner = new logger_1.Spinner('Splitting requirements into tasks');
     spinner.start();
     try {
@@ -542,6 +551,36 @@ async function iterationSplitCommand(options) {
                     }
                 }
             }
+            // 读取功能模块分析（020-specs/features/）
+            const iterFeaturesDir = (0, path_1.join)(specDir2, 'features');
+            if (await (0, fs_extra_1.pathExists)(iterFeaturesDir)) {
+                const featureEntries = await (0, fs_extra_1.readdir)(iterFeaturesDir, { withFileTypes: true });
+                for (const fe of featureEntries) {
+                    if (!fe.name.startsWith('.') && fe.name.endsWith('.md')) {
+                        const fp = (0, path_1.join)(iterFeaturesDir, fe.name);
+                        const content = await (0, fs_extra_1.readFile)(fp, 'utf-8');
+                        if (content.trim().length > 50 && !content.trim().match(/^#+\s*\u5f85\u586b\u5145|^<!--\s*AI-FILL/m)) {
+                            specContents.push({ name: `features/${fe.name}`, content });
+                        }
+                    }
+                }
+            }
+            // 读取类型文档分析（020-specs/{bugs,refactors,research}/）
+            for (const typeDir of ['bugs', 'refactors', 'research']) {
+                const typeDirPath = (0, path_1.join)(specDir2, typeDir);
+                if (!(await (0, fs_extra_1.pathExists)(typeDirPath)))
+                    continue;
+                const typeEntries = await (0, fs_extra_1.readdir)(typeDirPath, { withFileTypes: true });
+                for (const te of typeEntries) {
+                    if (!te.isFile() || !te.name.endsWith('.md'))
+                        continue;
+                    const fp = (0, path_1.join)(typeDirPath, te.name);
+                    const content = await (0, fs_extra_1.readFile)(fp, 'utf-8');
+                    if (content.trim().length > 50 && !content.trim().match(/^#+\s*\u5f85\u586b\u5145|^<!--\s*AI-FILL/m)) {
+                        specContents.push({ name: `${typeDir}/${te.name}`, content });
+                    }
+                }
+            }
             // 粒度推荐（基于 STAFFING 人数）
             const staffing = readStaffing(iterationDir);
             const teamSize = staffing ? staffing.length : 0;
@@ -620,7 +659,7 @@ async function iterationSplitCommand(options) {
             }
             for (const section of approved) {
                 const taskId = section._taskId;
-                await createTaskFromSection(iterationDir, taskId, section, platforms, section._taskType);
+                await createTaskFromSection(iterationDir, taskId, section, platforms, section._taskType, approved);
             }
             spinner.stop(`✅ 创建了 ${approved.length} 个任务`);
             return;
@@ -680,7 +719,7 @@ async function iterationSplitCommand(options) {
                         break;
                     }
                     if (resp?.toLowerCase() === 'y' || resp === '') {
-                        await createTaskFromSection(iterationDir, taskId, sections[i], platforms, sections[i]._taskType);
+                        await createTaskFromSection(iterationDir, taskId, sections[i], platforms, sections[i]._taskType, sections);
                         created++;
                         logger_1.logger.info(`    ✅ ${taskId}`);
                     }
@@ -698,7 +737,7 @@ async function iterationSplitCommand(options) {
             // Default: create all
             for (let i = 0; i < sections.length; i++) {
                 const taskId = sections[i]._taskId;
-                await createTaskFromSection(iterationDir, taskId, sections[i], platforms, sections[i]._taskType);
+                await createTaskFromSection(iterationDir, taskId, sections[i], platforms, sections[i]._taskType, sections);
             }
             await generateImpactGraph(iterationDir, sections, platforms);
             await generateEnvExample(iterationDir, sections);
@@ -710,7 +749,7 @@ async function iterationSplitCommand(options) {
         // Create tasks（使用预分配的 ID）
         for (let i = 0; i < sections.length; i++) {
             const taskId = sections[i]._taskId;
-            await createTaskFromSection(iterationDir, taskId, sections[i], platforms, sections[i]._taskType);
+            await createTaskFromSection(iterationDir, taskId, sections[i], platforms, sections[i]._taskType, sections);
         }
         // ── Generate impact graph + risk scores ──
         await generateImpactGraph(iterationDir, sections, platforms);
@@ -837,13 +876,15 @@ function filterTemplateNoise(sections) {
         return true;
     });
 }
-async function createTaskFromSection(iterationDir, taskId, section, allPlatforms, taskType = 'feature') {
+async function createTaskFromSection(iterationDir, taskId, section, allPlatforms, taskType = 'feature', allSections) {
     // taskId 已含 slug（nextTaskId 返回 Task-NNN-slug），直接用
     const taskDir = (0, path_1.join)(iterationDir, '030-tasks', taskType, taskId);
     const taskPlatforms = section._scopePlatforms || (section.platform ? [section.platform] : allPlatforms);
     const complexity = section._complexity || { estimatedHours: 2, priority: 'medium', complexity: 'medium', apiCount: 0, dbCount: 0, pageCount: 0, wordCount: 0 };
     const owner = section._owner || '未分配';
     const today = new Date().toISOString().split('T')[0];
+    // 加载迭代级 analyze 产出（020-specs/），用于填充任务级文件
+    const specContents = await loadSpecContents(iterationDir);
     // 预生成所有端的子任务 ID（保证同一端在所有文件中 ID 一致）
     const taskNum = taskId.replace(/^Task-/, '');
     const subtaskIdMap = new Map();
@@ -868,6 +909,7 @@ ${taskId}/
 ├── README.md              <-- 本文件
 ├── .meta/                 <-- 任务元信息（type/status/owner/created-at）
 ├── _shared/               <-- 共享规格（所有端共用）
+│   ├── CONTEXT.md         <-- 任务上下文（来源追溯 + 原始描述 + 关联任务）
 │   ├── REQ.md             <-- 需求描述（API + 数据模型 + 业务规则）
 │   ├── TECH.md            <-- 技术方案（架构/接口设计/核心逻辑）
 │   ├── SCHEMA.md          <-- 数据库设计（如有）
@@ -898,6 +940,7 @@ ${taskPlatforms.map((p) => `| ${subtaskIdMap.get(p)} | ${p} | ${owner} | 🔲
 运行 \`speccore execute -t ${taskId} --platform {端}\` 时:
 
 ### 必读（自动嵌入）
+- \`_shared/CONTEXT.md\` — 任务上下文（来源 + 关联）
 - \`_shared/REQ.md\` — 共享需求
 - \`_shared/TECH.md\` — 共享技术方案
 - \`{端}/TASK.md\` — 该端子任务详情
@@ -930,10 +973,15 @@ ${taskPlatforms.map((p) => `| ${subtaskIdMap.get(p)} | ${p} | ${owner} | 🔲
     const apiLines = section.content.split('\n').filter(l => l.includes('| GET') || l.includes('| POST') || l.includes('| PUT') || l.includes('| DELETE') || l.includes('| PATCH'));
     const apiDesc = apiLines.length > 0 ? apiLines.map(l => `- ${l.trim()}`).join('\n') : '- 待补充（从 REQ.md 提取接口列表）';
     const aiTechContent = section._techContent;
-    // TECH.md: 优先用 AI 生成的实际内容，回退到模板
+    // 从 analyze TECH.md 提取本任务相关内容
+    const specTechContent = extractTaskTechContent(specContents, section);
+    // TECH.md: 优先 AI 生成 → 回退 analyze 提取 → 回退模板
     if (aiTechContent && aiTechContent.length > 50) {
         await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '_shared', 'TECH.md'), `# ${section.name} - 技术方案\n\n${aiTechContent}\n`);
     }
+    else if (specTechContent && specTechContent.length > 30) {
+        await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '_shared', 'TECH.md'), `# ${section.name} - 技术方案\n\n> 来源: analyze → TECH.md（自动提取）\n\n${specTechContent}\n`);
+    }
     else {
         await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '_shared', 'TECH.md'), `# ${section.name} - 技术方案
 
@@ -964,7 +1012,8 @@ ${apiDesc}
 `);
     }
     if (section.content.match(/数据库|数据表|表结构|DDL|ALTER|建表|索引/)) {
-        await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '_shared', 'SCHEMA.md'), generateSchemaTemplate(section));
+        const schemaMaterial = extractRelevantSection(specContents['TECH.md'] || '', section.name, 'DDL 建表 表结构 索引 CREATE TABLE');
+        await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '_shared', 'SCHEMA.md'), generateSchemaTemplate(section, schemaMaterial));
     }
     await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '_shared', 'CHANGELOG.md'), `# ${section.name} - 变更记录
 
@@ -1027,14 +1076,22 @@ ${apiDesc}
 | :--- | :--- | :--- |
 | ${today} | 创建子任务 | CLI |
 `);
-        // 后端端额外生成组件/路由等前端文档
+        // 非 backend 端额外生成前端设计文档（从 analyze TECH.md 提取）
         if (!isBackend) {
-            await (0, fs_extra_1.writeFile)((0, path_1.join)(platformDir, 'COMPONENT_TREE.md'), generateComponentTree(section, platform));
-            await (0, fs_extra_1.writeFile)((0, path_1.join)(platformDir, 'ROUTES.md'), generateRoutesDoc(section, platform));
-            await (0, fs_extra_1.writeFile)((0, path_1.join)(platformDir, 'STATE.md'), generateStateDoc(section, platform));
-            await (0, fs_extra_1.writeFile)((0, path_1.join)(platformDir, 'STYLE_GUIDE.md'), generateStyleGuide(section, platform));
+            const feContent = extractTaskTechContent(specContents, section, platform);
+            await (0, fs_extra_1.writeFile)((0, path_1.join)(platformDir, 'COMPONENT_TREE.md'), generateComponentTree(section, platform, feContent));
+            await (0, fs_extra_1.writeFile)((0, path_1.join)(platformDir, 'ROUTES.md'), generateRoutesDoc(section, platform, feContent));
+            await (0, fs_extra_1.writeFile)((0, path_1.join)(platformDir, 'STATE.md'), generateStateDoc(section, platform, feContent));
+            await (0, fs_extra_1.writeFile)((0, path_1.join)(platformDir, 'STYLE_GUIDE.md'), generateStyleGuide(section, platform, feContent));
         }
     }
+    // 确保至少有 backend 目录（AI 未输出 backend 时自动补充）
+    if (!taskPlatforms.some((p) => p === 'backend' || p.startsWith('后台'))) {
+        await (0, fs_extra_1.ensureDir)((0, path_1.join)(taskDir, 'backend', 'src'));
+        await (0, fs_extra_1.ensureDir)((0, path_1.join)(taskDir, 'backend', 'tests'));
+        taskPlatforms.push('backend');
+        subtaskIdMap.set('backend', `${taskId}-backend-auto`);
+    }
     // ── 生成端注册表 _shared/PLATFORMS.md ──
     const platformEntries = taskPlatforms.map((p) => ({
         name: p,
@@ -1042,25 +1099,84 @@ ${apiDesc}
         owner,
     }));
     await (0, platform_registry_1.generatePlatformsRegistry)(taskDir, taskId, platformEntries);
-    // 确保至少有 backend 目录
-    if (!taskPlatforms.some((p) => p === 'backend' || p.startsWith('后台'))) {
-        await (0, fs_extra_1.ensureDir)((0, path_1.join)(taskDir, 'backend', 'src'));
-        await (0, fs_extra_1.ensureDir)((0, path_1.join)(taskDir, 'backend', 'tests'));
-    }
     // ── 5. 执行产出 99-artifacts/ ──
     await (0, fs_extra_1.ensureDir)((0, path_1.join)(taskDir, '99-artifacts'));
-    await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '99-artifacts', 'TEST.md'), generateTestOutline(section));
+    const testMaterial = extractRelevantSection(specContents['TEST.md'] || '', section.name);
+    const riskMaterial = extractRelevantSection(specContents['RISK.md'] || '', section.name);
+    const depsMaterial = extractRelevantSection(specContents['DEPS.md'] || '', section.name);
+    const monitorMaterial = extractRelevantSection(specContents['MONITOR.md'] || '', section.name);
+    await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '99-artifacts', 'TEST.md'), generateTestOutline(section, testMaterial));
     await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '99-artifacts', 'REVIEW.md'), generateReviewChecklist(section));
     await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '99-artifacts', 'DEPLOY.md'), generateDeployChecklist(section));
     await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '99-artifacts', 'ERROR_CODES.md'), generateErrorCodes(section));
-    await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '99-artifacts', 'RISK.md'), generateRiskTemplate(section));
-    await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '99-artifacts', 'DEPS.md'), generateDepsTemplate(section));
-    await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '99-artifacts', 'MONITOR.md'), generateMonitorTemplate(section));
+    await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '99-artifacts', 'RISK.md'), generateRiskTemplate(section, riskMaterial));
+    await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '99-artifacts', 'DEPS.md'), generateDepsTemplate(section, depsMaterial));
+    await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '99-artifacts', 'MONITOR.md'), generateMonitorTemplate(section, monitorMaterial));
     const adr = generateAdr(section);
     if (adr) {
         await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '99-artifacts', 'ADR.md'), adr);
     }
-    // ── 6. 问题追踪 ──
+    // ── 6. 任务上下文 CONTEXT.md ──
+    const sourceFile = section._sourceFile || '';
+    const topic = section._topic || slugify(section.name);
+    // 推导 010-requirements 源路径
+    const reqSourcePath = sourceFile
+        ? `010-requirements/${sourceFile}`
+        : `010-requirements/${taskType === 'feature' ? 'features' : taskType === 'bugfix' ? 'bugs' : taskType === 'refactor' ? 'refactors' : 'research'}/${topic}.md`;
+    // 推导 020-specs 分析文档路径
+    const specSourcePath = sourceFile
+        ? `020-specs/${sourceFile}`
+        : `020-specs/${taskType === 'feature' ? 'features' : taskType === 'bugfix' ? 'bugs' : taskType === 'refactor' ? 'refactors' : 'research'}/${topic}.md`;
+    // 任务类型中文标签
+    const typeLabels = { feature: '功能开发', bugfix: '缺陷修复', refactor: '重构优化', research: '技术调研' };
+    const typeLabel = typeLabels[taskType] || taskType;
+    // 收集同迭代的其它任务（用于关联关系）
+    const relatedTasks = allSections
+        ? allSections
+            .filter((s) => s !== section)
+            .slice(0, 5)
+            .map((s, idx) => {
+            const sId = s._taskId || `Task-${String(allSections.indexOf(s) + 1).padStart(3, '0')}`;
+            const sType = s._taskType || 'feature';
+            return `- \`${sId}\` (${s.name}) — ${typeLabels[sType] || sType}`;
+        })
+        : [];
+    // 提取原始描述摘要（从 REQ.md 内容截取前 500 字）
+    const reqMdPath = (0, path_1.join)(taskDir, '_shared', 'REQ.md');
+    let originalDesc = '';
+    if (await (0, fs_extra_1.pathExists)(reqMdPath)) {
+        const reqContent = await (0, fs_extra_1.readFile)(reqMdPath, 'utf-8');
+        // 跳过标题行，取正文前 500 字
+        const body = reqContent.replace(/^#[^\n]*\n/, '').trim();
+        originalDesc = body.length > 500 ? body.slice(0, 500) + '...' : body;
+    }
+    await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '_shared', 'CONTEXT.md'), `# 任务上下文
+
+## 来源追溯
+
+| 属性 | 值 |
+|:---|:---|
+| 任务类型 | ${typeLabel}（\`${taskType}\`） |
+| 需求文档 | \`${reqSourcePath}\` |
+| 分析文档 | \`${specSourcePath}\` |
+| 功能单元 | ${section.functionalUnit || section.name} |
+| 拆分原因 | ${section._reason || '—'} |
+
+## 原始描述
+
+${originalDesc || '> 待补充（执行 analyze 后自动生成）'}
+
+## 关联任务
+
+${relatedTasks.length > 0 ? relatedTasks.join('\n') : '> 暂无关联任务（split 时自动填充）'}
+
+## 影响范围
+
+| 端 | 影响说明 |
+|:---|:---|
+${taskPlatforms.map((p) => `| ${p} | 待补充 |`).join('\n')}
+`);
+    // ── 7. 问题追踪 ──
     await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '.issues.md'), `# ${section.name} - 问题追踪\n\n> 执行过程中发现的问题记录于此。\n\n`);
 }
 async function updateProjectGraph(iterationDir, sections) {
@@ -1084,7 +1200,10 @@ async function updateProjectGraph(iterationDir, sections) {
 /**
  * 根据需求内容自动生成测试用例框架
  */
-function generateTestOutline(section) {
+function generateTestOutline(section, material) {
+    if (material && material.trim().length > 30) {
+        return `# ${section.name} — 测试用例\n\n> 来源: analyze → TEST.md（自动提取）\n\n${material.trim()}\n`;
+    }
     const name = section.name;
     const content = section.content || '';
     const isBackend = section.platform?.startsWith('后台') || false;
@@ -1324,8 +1443,11 @@ async function generateImpactGraph(iterationDir, sections, platforms) {
     await (0, fs_extra_1.writeFile)((0, path_1.join)(iterationDir, 'IMPACT.md'), impact);
     logger_1.logger.info(`\nImpact analysis: ${iterationDir}/IMPACT.md`);
 }
-function generateSchemaTemplate(section) {
+function generateSchemaTemplate(section, material) {
     const name = section.name;
+    if (material && material.trim().length > 30) {
+        return `# ${name} — Database Schema\n\n> 来源: analyze → TECH.md（自动提取）\n\n${material.trim()}\n`;
+    }
     return `# ${name} — Database Schema
 
 > Auto-generated. Fill in DDL before development.
@@ -1563,30 +1685,157 @@ function generateAcceptanceCriteria(section) {
     return acs;
 }
 // 风险评估
-function generateRiskTemplate(section) {
+function generateRiskTemplate(section, material) {
+    if (material && material.trim().length > 30) {
+        return `# ${section.name} — 风险评估\n\n> 来源: analyze → RISK.md（自动提取）\n\n${material.trim()}\n`;
+    }
     return `# ${section.name} — 风险评估\n\n> split | ${new Date().toISOString().split('T')[0]}\n\n## 风险矩阵\n\n| 风险 | 可能 | 影响 | 缓解 |\n| :--- | :--- | :--- | :--- |\n| 兼容性 | 中 | 高 | 版本号+测试 |\n| 性能 | 低 | 中 | 压测+索引 |\n| 依赖故障 | 低 | 高 | 降级方案 |\n\n## 回滚\n\n1. 触发: 线上错误率 > 1%\n2. 步骤: git revert → 重部署\n3. 验证: 冒烟测试 + 监控\n`;
 }
 // 依赖清单
-function generateDepsTemplate(section) {
+function generateDepsTemplate(section, material) {
+    if (material && material.trim().length > 30) {
+        return `# ${section.name} — 依赖清单\n\n> 来源: analyze → DEPS.md（自动提取）\n\n${material.trim()}\n`;
+    }
     return `# ${section.name} — 依赖清单\n\n## 上游依赖\n\n| 服务 | 版本 | 用途 | SLA |\n| :--- | :--- | :--- | :--- |\n| _待补充_ | — | — | — |\n\n## 下游影响\n\n| 服务 | 影响 | 通知 |\n| :--- | :--- | :--- |\n| _待补充_ | — | — |\n`;
 }
 // 监控指标
-function generateMonitorTemplate(section) {
+function generateMonitorTemplate(section, material) {
+    if (material && material.trim().length > 30) {
+        return `# ${section.name} — 监控\n\n> 来源: analyze → MONITOR.md（自动提取）\n\n${material.trim()}\n`;
+    }
     return `# ${section.name} — 监控\n\n## 关键指标\n\n| 指标 | 阈值 | 级别 |\n| :--- | :--- | :--- |\n| 成功率 | <99.9% | P1 |\n| P99延迟 | >1000ms | P2 |\n| 错误率 | >0.1% | P0 |\n\n## 关键日志\n\n- 请求入口 (traceId)\n- 业务异常 (上下文)\n- 外部调用 (耗时)\n`;
 }
+// ═══════════════════════════════════════════════
+// 从 analyze 产出中提取任务相关内容
+// ═══════════════════════════════════════════════
+/** 加载迭代级 020-specs/ 文档内容 */
+async function loadSpecContents(iterationDir) {
+    const specs = {};
+    const specDir = (0, path_1.join)(iterationDir, '020-specs');
+    if (!(await (0, fs_extra_1.pathExists)(specDir)))
+        return specs;
+    for (const f of ['TECH.md', 'TEST.md', 'RISK.md', 'DEPS.md', 'MONITOR.md', 'ANALYSIS.md', 'REQUIREMENT.md']) {
+        const fp = (0, path_1.join)(specDir, f);
+        if (await (0, fs_extra_1.pathExists)(fp)) {
+            const content = await (0, fs_extra_1.readFile)(fp, 'utf-8');
+            if (content.trim().length > 50 && !content.trim().match(/^#+\s*待填充|^<!--\s*AI-FILL/m)) {
+                specs[f] = content;
+            }
+        }
+    }
+    return specs;
+}
+/** 从完整文档中提取与任务名相关的段落 */
+function extractRelevantSection(fullContent, taskName, sectionHint) {
+    if (!fullContent || !taskName)
+        return '';
+    const lines = fullContent.split('\n');
+    const nameKeywords = new Set();
+    for (const m of taskName.matchAll(/[a-zA-Z]+/g)) {
+        if (m[0].length > 1)
+            nameKeywords.add(m[0].toLowerCase());
+    }
+    for (const m of taskName.matchAll(/[\u4e00-\u9fff]+/g)) {
+        if (m[0].length >= 2)
+            nameKeywords.add(m[0]);
+    }
+    if (sectionHint) {
+        for (const m of sectionHint.matchAll(/[a-zA-Z]+/g)) {
+            if (m[0].length > 1)
+                nameKeywords.add(m[0].toLowerCase());
+        }
+        for (const m of sectionHint.matchAll(/[\u4e00-\u9fff]+/g)) {
+            if (m[0].length >= 2)
+                nameKeywords.add(m[0]);
+        }
+    }
+    if (nameKeywords.size === 0)
+        return '';
+    const kwArray = [...nameKeywords];
+    // 按 Markdown 标题拆分，查找包含关键词的完整段落
+    const sections = [];
+    let cur = { heading: '', level: 0, content: [], headingLine: '' };
+    for (const line of lines) {
+        const hm = line.match(/^(#{1,4})\s+(.+)/);
+        if (hm) {
+            if (cur.heading || cur.content.length > 0)
+                sections.push({ heading: cur.heading, level: cur.level, content: cur.content.join('\n'), headingLine: cur.headingLine });
+            cur = { heading: hm[2].trim(), level: hm[1].length, content: [], headingLine: line };
+        }
+        else {
+            cur.content.push(line);
+        }
+    }
+    if (cur.heading || cur.content.length > 0)
+        sections.push({ heading: cur.heading, level: cur.level, content: cur.content.join('\n'), headingLine: cur.headingLine });
+    // 匹配：标题或内容包含关键词
+    const matched = [];
+    for (const sec of sections) {
+        const text = (sec.heading + ' ' + sec.content).toLowerCase();
+        const hit = kwArray.some(kw => text.includes(kw));
+        if (hit && (sec.heading || sec.content.trim())) {
+            const prefix = '#'.repeat(Math.max(sec.level + 1, 2));
+            matched.push(`${prefix} ${sec.heading}\n${sec.content.trim()}`);
+        }
+    }
+    if (matched.length > 0)
+        return matched.join('\n\n');
+    // 回退：提取包含关键词的连续行
+    const fallback = [];
+    for (const line of lines) {
+        const lower = line.toLowerCase();
+        if (kwArray.some(kw => lower.includes(kw)))
+            fallback.push(line);
+    }
+    return fallback.length > 0 ? fallback.join('\n') : '';
+}
+/** 从 TECH.md 提取前端平台相关内容 */
+function extractFrontendContent(techContent, taskName, platform) {
+    if (!techContent)
+        return '';
+    // 先提取该前端平台相关的顶层段落（如 "H5移动端"、"后台管理端"）
+    const platformLabels = {
+        'h5': ['H5', 'h5', '移动端', 'mobile'],
+        'admin': ['admin', '后台', '管理端', 'Admin'],
+        'web': ['Web', 'web', '前端', '桌面'],
+        'app': ['App', 'app', '客户端'],
+        'miniapp': ['小程序', 'miniapp'],
+    };
+    const platformKws = platformLabels[platform] || [platform];
+    const platformSection = extractRelevantSection(techContent, taskName, platformKws.join(' '));
+    if (platformSection)
+        return platformSection;
+    // 回退：用任务名匹配
+    return extractRelevantSection(techContent, taskName);
+}
+/** 从 specContents 提取任务级 TECH 内容 */
+function extractTaskTechContent(specContents, section, platform) {
+    const techMd = specContents['TECH.md'];
+    if (!techMd)
+        return '';
+    if (platform && platform !== 'backend') {
+        return extractFrontendContent(techMd, section.name, platform);
+    }
+    // 后端/共享：提取技术方案、架构、接口设计、数据模型等
+    const techSection = extractRelevantSection(techMd, section.name, '技术方案 架构 接口设计 数据模型 模块设计');
+    return techSection;
+}
 // 前端专属：组件树
-function generateComponentTree(section, platform) {
+function generateComponentTree(section, platform, material) {
+    if (material && material.trim().length > 30) {
+        return `# ${section.name} — 组件树 (${platform})\n\n> 来源: analyze → TECH.md（自动提取）\n\n${material.trim()}\n`;
+    }
     return `# ${section.name} — 组件树 (${platform})
 
 > split | ${new Date().toISOString().split('T')[0]}
 
 ## 页面结构
-<!-- AI-FILL: 根据需求描述页面的组件层级 -->
+<!-- 从 analyze TECH.md 自动提取，若无内容则待补充 -->
 
 ## 组件清单
 | 组件 | 路径 | 类型 | 状态 |
 | :--- | :--- | :--- | :--- |
-| _待AI分析_ | — | — | — |
+| _待补充_ | — | — | — |
 
 ## 共享组件
 | 组件 | 来源 | 用途 |
@@ -1595,7 +1844,10 @@ function generateComponentTree(section, platform) {
 `;
 }
 // 前端专属：路由
-function generateRoutesDoc(section, platform) {
+function generateRoutesDoc(section, platform, material) {
+    if (material && material.trim().length > 30) {
+        return `# ${section.name} — 路由设计 (${platform})\n\n> 来源: analyze → TECH.md（自动提取）\n\n${material.trim()}\n`;
+    }
     return `# ${section.name} — 路由设计 (${platform})
 
 > split | ${new Date().toISOString().split('T')[0]}
@@ -1610,7 +1862,10 @@ function generateRoutesDoc(section, platform) {
 `;
 }
 // 前端专属：状态管理
-function generateStateDoc(section, platform) {
+function generateStateDoc(section, platform, material) {
+    if (material && material.trim().length > 30) {
+        return `# ${section.name} — 状态管理 (${platform})\n\n> 来源: analyze → TECH.md（自动提取）\n\n${material.trim()}\n`;
+    }
     return `# ${section.name} — 状态管理 (${platform})
 
 > split | ${new Date().toISOString().split('T')[0]}
@@ -1630,7 +1885,10 @@ function generateStateDoc(section, platform) {
 `;
 }
 // 前端专属：样式规范
-function generateStyleGuide(section, platform) {
+function generateStyleGuide(section, platform, material) {
+    if (material && material.trim().length > 30) {
+        return `# ${section.name} — 样式规范 (${platform})\n\n> 来源: analyze → TECH.md（自动提取）\n\n${material.trim()}\n`;
+    }
     const isH5 = platform.includes('h5') || platform.includes('mobile');
     const isMiniapp = platform.includes('miniapp') || platform.includes('小程序');
     const styleCtx = isH5 ? '移动端 H5，注意触控交互和移动适配' :
@@ -1721,6 +1979,14 @@ function buildSplitPrompt(iteration, constitutionContent, reqContent, specConten
     p += `- 低于当前粒度工时下限 → 合并到关联任务\n`;
     p += `- 跨端功能 → 按端拆（后端 1 个 + 每个前端各 1 个）\n`;
     p += `- 独立第三方集成（支付/短信/OSS）→ 独立任务\n\n`;
+    // 类型文档 1:1 映射规则
+    p += `### 类型文档拆分规则（bugs/refactors/research）\n`;
+    p += `与 feature 不同，类型文档采用 **1:1 映射**——每个文档直接对应一个任务，不拆分不合并：\n`;
+    p += `- \`bugs/xxx.md\` → 1 个 bugfix 任务（一个 bug 就是一个任务，不要把多个 bug 合并）\n`;
+    p += `- \`refactors/xxx.md\` → 1 个 refactor 任务\n`;
+    p += `- \`research/xxx.md\` → 1 个 research 任务\n`;
+    p += `- \`features/xxx.md\` → 按功能单元拆分规则处理（可能 1~3 个 feature 任务）\n`;
+    p += `- **sourceFile 必须填写**：类型文档任务的 sourceFile 就是该文档的相对路径（如 \`bugs/login-timeout.md\`）\n\n`;
     p += `### 依赖关系\n`;
     p += `- 基础模块（认证/数据库/配置）优先拆出，作为第一批任务\n`;
     p += `- 依赖链深度 ≤ 3\n`;
@@ -1738,7 +2004,7 @@ function buildSplitPrompt(iteration, constitutionContent, reqContent, specConten
     p += '```json\n';
     p += `[\n  {\n`;
     p += `    "id": "Task-001",\n`;
-    p += `    "functionalUnit": "所属功能单元（必填！如：用户管理、订单系统、支付模块）",\n`;
+    p += `    "functionalUnit": "所属功能单元/影响域（必填！见下方类型规则）",\n`;
     p += `    "name": "任务名称（中文）",\n`;
     p += `    "topic": "english-slug-for-directory",\n`;
     p += `    "type": "feature|bugfix|refactor|research",\n`;
@@ -1753,12 +2019,19 @@ function buildSplitPrompt(iteration, constitutionContent, reqContent, specConten
     p += `    "acceptanceCriteria": ["AC1: ..."],\n`;
     p += `    "risk": "low|medium|high",\n`;
     p += `    "owner": "建议负责人",\n`;
+    p += `    "sourceFile": "来源文档路径（如 bugs/login-timeout.md、features/user-auth.md）",\n`;
     p += `    "reqContent": "需求描述内容（Markdown 格式，写入 REQ.md）",\n`;
     p += `    "techContent": "技术方案内容（Markdown 格式，写入 TECH.md）"\n`;
     p += `  }\n]\n`;
     p += '```\n\n';
-    p += `> **functionalUnit 必须填写**：功能单元名称，不是章节名。同一功能模块的任务填相同的值。\n`;
+    p += `> **functionalUnit 必须填写**：根据任务类型语义不同：\n`;
+    p += `>   - feature → 功能模块名（如：用户管理、订单系统、支付模块）\n`;
+    p += `>   - bugfix → 受影响组件/流程（如：登录流程、支付回调、数据同步）\n`;
+    p += `>   - refactor → 重构目标范围（如：数据库层、API网关、状态管理）\n`;
+    p += `>   - research → 研究主题（如：WebSocket方案、缓存策略）\n`;
+    p += `> 同一模块/领域的任务填相同的值，用于粒度校验和任务分组\n`;
     p += `> **topic** 必须是英文短横线格式（如 \`user-authentication\`、\`product-crud\`），用于生成任务目录名 Task-NNN-{topic}\n`;
+    p += `> **sourceFile** 必须填写：该任务对应的 020-specs 源文档路径（如 \`bugs/login-timeout.md\`、\`features/user-auth.md\`、\`refactors/db-pool.md\`），用于在 CONTEXT.md 中生成来源追溯\n`;
     p += `> **reqContent** 必须填写：该任务的需求描述（含业务规则、数据模型、接口定义），直接写入 REQ.md\n`;
     p += `> **techContent** 必须填写：该任务的技术方案（含架构设计、核心逻辑、测试策略），直接写入 TECH.md\n`;
     p += `> reqContent/techContent 是该任务的**子切面**，只包含该任务负责的部分，不是整个功能单元的内容\n\n`;