speccore 5.87.2 → 5.88.0

package/dist/commands/iteration/split.js

@@ -11,6 +11,45 @@ const task_utils_1 = require("../../utils/task-utils");
 const next_steps_1 = require("../../core/next-steps");
 const readline_1 = require("readline");
 const prompt_builder_1 = require("../../core/prompt-builder");
+/** 将名称转为目录安全的短 slug（2-4 词） */
+function slugify(name) {
+    return name
+        .replace(/[\u4e00-\u9fff]/g, '') // 去掉中文
+        .replace(/[^a-zA-Z0-9\s-]/g, '') // 去特殊字符
+        .split(/\s+/)
+        .filter(Boolean)
+        .slice(0, 3) // 最多 3 词
+        .join('-')
+        .toLowerCase() || 'task';
+}
+/** 粒度约束常量 */
+const GRANULARITY_RULES = {
+    macro: { label: '粗粒度 (macro)', minHours: 20, maxHours: 80, maxApis: 15, maxTables: 5, maxPages: 5, desc: '每个任务 1-2 周，按业务方向合并' },
+    module: { label: '中粒度 (module)', minHours: 12, maxHours: 40, maxApis: 8, maxTables: 3, maxPages: 3, desc: '每个任务 3-5 天，按功能/端拆分' },
+    atomic: { label: '细粒度 (atomic)', minHours: 4, maxHours: 24, maxApis: 3, maxTables: 2, maxPages: 1, desc: '每个任务 1-3 天，按接口/表拆分' },
+};
+/** 校验任务工时是否在粒度范围内 */
+function validateGranularity(gran, hours, apiCount, tableCount) {
+    const rule = GRANULARITY_RULES[gran];
+    const warnings = [];
+    if (hours > rule.maxHours)
+        warnings.push(`⚠️  工时 ${hours}h 超出上限 ${rule.maxHours}h → 建议再拆`);
+    else if (hours < rule.minHours)
+        warnings.push(`⚠️  工时 ${hours}h 低于下限 ${rule.minHours}h → 建议合并到关联任务`);
+    if (apiCount > rule.maxApis)
+        warnings.push(`⚠️  接口 ${apiCount} 个超出上限 ${rule.maxApis} → 建议按业务领域拆分`);
+    if (tableCount > rule.maxTables)
+        warnings.push(`⚠️  数据表 ${tableCount} 张超出上限 ${rule.maxTables} → 建议按数据层拆分`);
+    return warnings;
+}
+/** 根据团队规模推荐粒度 */
+function recommendGranularity(teamSize) {
+    if (teamSize <= 3)
+        return 'macro';
+    if (teamSize <= 8)
+        return 'module';
+    return 'atomic';
+}
 function promptUser(question) {
     const rl = (0, readline_1.createInterface)({ input: process.stdin, output: process.stdout });
     return new Promise(resolve => {
@@ -20,7 +59,42 @@ function promptUser(question) {
 async function detectPlatforms(iterationDir, specified) {
     if (specified)
         return specified.split(',').map(p => p.trim()).filter(Boolean);
-    // Detect from 020-specs/ subdirectories (populated by analyze)
+    // 1. 优先从 CONSTITUTION.md 读取「对应需求端」配置
+    const constitutionPath = (0, path_1.join)('.speccore', 'CONSTITUTION.md');
+    if (await (0, fs_extra_1.pathExists)(constitutionPath)) {
+        const content = await (0, fs_extra_1.readFile)(constitutionPath, 'utf-8');
+        const lines = content.split('\n');
+        let headerIdx = -1;
+        for (let i = 0; i < lines.length; i++) {
+            if (lines[i].includes('对应需求端')) {
+                headerIdx = i;
+                break;
+            }
+        }
+        if (headerIdx >= 0) {
+            const headers = lines[headerIdx].split('|').map(h => h.trim()).filter(Boolean);
+            const platformColIdx = headers.findIndex(h => h.includes('对应需求端'));
+            if (platformColIdx >= 0) {
+                const platforms = new Set();
+                for (let i = headerIdx + 1; i < lines.length; i++) {
+                    const line = lines[i].trim();
+                    if (!line.startsWith('|') || line.match(/^\|\s*[-:]/))
+                        continue;
+                    const cells = line.split('|').map(c => c.trim()).filter(Boolean);
+                    if (cells[platformColIdx]) {
+                        cells[platformColIdx].split(',').forEach((p) => {
+                            const trimmed = p.trim();
+                            if (trimmed && !trimmed.startsWith('>'))
+                                platforms.add(trimmed);
+                        });
+                    }
+                }
+                if (platforms.size > 0)
+                    return [...platforms];
+            }
+        }
+    }
+    // 2. 回退：扫描 020-specs/ 子目录
     const specsDir = (0, path_1.join)(iterationDir, '020-specs');
     if (await (0, fs_extra_1.pathExists)(specsDir)) {
         const entries = await (0, fs_extra_1.readdir)(specsDir, { withFileTypes: true });
@@ -30,7 +104,7 @@ async function detectPlatforms(iterationDir, specified) {
         if (platforms.length > 0)
             return platforms;
     }
-    return ['web']; // default
+    return ['web']; // 默认
 }
 async function iterationSplitCommand(options) {
     // ── Prompt 模式 ──
@@ -63,7 +137,8 @@ async function iterationSplitCommand(options) {
                     const task = tasks[i];
                     // 将 AI JSON 转换为 Section，复用 createTaskFromSection 创建完整目录
                     const desc = task.description || task.name || '';
-                    const scope = Array.isArray(task.scope) ? task.scope.join(', ') : (task.scope || '');
+                    const scopeArr = Array.isArray(task.scope) ? task.scope : [];
+                    const scope = scopeArr.join(', ');
                     const apis = Array.isArray(task.apis) ? task.apis.join('\n') : '';
                     const acs = Array.isArray(task.acceptanceCriteria) ? task.acceptanceCriteria.join('\n') : '';
                     let content = desc;
@@ -73,11 +148,18 @@ async function iterationSplitCommand(options) {
                         content += `\n\n接口:\n${apis}`;
                     if (acs)
                         content += `\n\n验收标准:\n${acs}`;
+                    // 从 scope 提取平台列表（后端 + 前端各端）
+                    const taskScopePlatforms = [];
+                    const isBackend = scopeArr.some((s) => /后端|backend/i.test(s));
+                    const fePlatforms = scopeArr.filter((s) => !/后端|backend/i.test(s)).map((s) => s.trim()).filter(Boolean);
+                    if (isBackend)
+                        taskScopePlatforms.push('backend');
+                    taskScopePlatforms.push(...fePlatforms);
                     const section = {
                         name: task.name || `Task ${i + 1}`,
                         content,
                         level: 2,
-                        platform: scope?.match(/后台|backend/) ? 'backend' : undefined,
+                        platform: isBackend ? 'backend' : (fePlatforms[0] || undefined),
                     };
                     section._complexity = {
                         estimatedHours: task.estimatedHours || 8,
@@ -89,6 +171,9 @@ async function iterationSplitCommand(options) {
                         wordCount: content.length,
                     };
                     section._owner = task.owner || '未分配';
+                    section._taskType = (task.type && ['feature', 'bugfix', 'refactor', 'research'].includes(task.type)) ? task.type : 'feature';
+                    if (taskScopePlatforms.length > 0)
+                        section._scopePlatforms = taskScopePlatforms;
                     sections.push(section);
                 }
                 // 检测已有任务 + 冲突处理
@@ -98,17 +183,77 @@ async function iterationSplitCommand(options) {
                     logger_1.logger.info('   使用 --force 强制覆盖');
                     return;
                 }
-                // 创建完整任务目录（复用本地拆分的完整流程）
-                // 注意：始终走计数器，不使用 AI 提供的 ID，避免编号重复
+                // --force 清理旧任务（避免新旧叠加编号暴增）
+                if (options.force) {
+                    const tasksRoot = (0, path_1.join)(iterDirFull, '030-tasks');
+                    if (await (0, fs_extra_1.pathExists)(tasksRoot)) {
+                        const entries = await (0, fs_extra_1.readdir)(tasksRoot, { withFileTypes: true });
+                        for (const entry of entries) {
+                            if (entry.isDirectory()) {
+                                await (0, fs_extra_1.remove)((0, path_1.join)(tasksRoot, entry.name));
+                            }
+                        }
+                        logger_1.logger.info(`   🗑  已清理旧任务目录`);
+                    }
+                }
+                // 确定粒度
+                const staffing2 = readStaffing(iterDirFull);
+                const teamSize2 = staffing2 ? staffing2.length : 0;
+                const granularity = options.granularity || recommendGranularity(teamSize2);
+                const granRule = GRANULARITY_RULES[granularity];
+                const isInteractive = process.stdin.isTTY; // 非 TTY（管道调用）时自动确认
+                logger_1.logger.info(`   📏 粒度: ${granRule.label}${options.granularity ? ' (用户指定)' : ` (${teamSize2} 人团队自动推荐)`}`);
+                if (!isInteractive)
+                    logger_1.logger.info('   ℹ️  非交互终端，自动确认所有任务');
+                // 逐任务交互确认
+                const createdSections = [];
                 for (let i = 0; i < sections.length; i++) {
-                    const { id: taskId } = await (0, global_counters_1.nextTaskId)(sections[i].name);
-                    sections[i]._taskId = taskId;
-                    await createTaskFromSection(iterDirFull, taskId, sections[i], allPlatforms);
-                    logger_1.logger.info(`   ✅ 创建: ${taskId} - ${sections[i].name}`);
+                    const sec = sections[i];
+                    const complexity = sec._complexity || {};
+                    const taskType = sec._taskType || 'feature';
+                    const deps = (tasks[i].dependencies || []);
+                    const acs = (tasks[i].acceptanceCriteria || []);
+                    // 展示任务摘要
+                    logger_1.logger.info(`\n   ━━━━ 任务 ${i + 1}/${sections.length} ━━━━`);
+                    logger_1.logger.info(`   📌 ${sec.name}`);
+                    logger_1.logger.info(`   🏷  类型: ${taskType} | ⏱ 预估: ${complexity.estimatedHours}h | 🎯 优先级: ${complexity.priority || 'medium'}`);
+                    if (complexity.apiCount)
+                        logger_1.logger.info(`   🔌 接口: ${complexity.apiCount} 个 | 🗄 数据表: ${complexity.dbCount || 0} 张`);
+                    if (deps.length > 0)
+                        logger_1.logger.info(`   🔗 依赖: ${deps.join(', ')}`);
+                    if (acs.length > 0) {
+                        logger_1.logger.info(`   ✅ 验收标准:`);
+                        for (const ac of acs.slice(0, 5))
+                            logger_1.logger.info(`      ${ac}`);
+                    }
+                    // 粒度校验
+                    const warnings = validateGranularity(granularity, complexity.estimatedHours || 8, complexity.apiCount || 0, complexity.dbCount || 0);
+                    if (warnings.length > 0) {
+                        for (const w of warnings)
+                            logger_1.logger.warn(`   ${w}`);
+                    }
+                    // 交互确认（仅确认，调整应回到 AI 对话重新生成方案）
+                    if (isInteractive) {
+                        const answer = await promptUser(`   确认创建？(y/回车确认，n 调整方案):`);
+                        if (answer.toLowerCase() === 'n' || answer.toLowerCase() === 'no') {
+                            logger_1.logger.info(`   💡 如需调整，请告诉 AI：`);
+                            logger_1.logger.info(`      "把 XX 和 YY 合为一个任务" / "ZZ 任务太大，拆成两个" / "修改工时为 Xh"`);
+                            logger_1.logger.info(`      AI 会参考 .speccore/prompts/split-suggestion-${iter}.md 中的规则重新生成`);
+                            logger_1.logger.info(`      调整后再次执行本命令即可`);
+                            return;
+                        }
+                    }
+                    const { id: taskId } = await (0, global_counters_1.nextTaskId)(sec.name);
+                    sec._taskId = taskId;
+                    await createTaskFromSection(iterDirFull, taskId, sec, allPlatforms, taskType);
+                    createdSections.push(sec);
+                    logger_1.logger.info(`   ✅ 创建: ${taskId} - [${taskType}] ${sec.name}`);
+                }
+                if (createdSections.length > 0) {
+                    await generateImpactGraph(iterDirFull, createdSections, allPlatforms);
+                    await updateProjectGraph(iterDirFull, createdSections);
                 }
-                await generateImpactGraph(iterDirFull, sections, allPlatforms);
-                await updateProjectGraph(iterDirFull, sections);
-                logger_1.logger.success(`✅ 创建了 ${sections.length} 个任务（完整目录结构）`);
+                logger_1.logger.success(`✅ 创建了 ${createdSections.length}/${sections.length} 个任务（${sections.length - createdSections.length} 个跳过）`);
             }
             else {
                 logger_1.logger.warn('AI 返回格式非数组，将作为 Markdown 写入 REQUIREMENT.md');
@@ -204,12 +349,9 @@ async function iterationSplitCommand(options) {
             // 粒度推荐（基于 STAFFING 人数）
             const staffing = readStaffing(iterationDir);
             const teamSize = staffing ? staffing.length : 0;
-            const recommendedGranularity = options.granularity ||
-                (teamSize <= 3 ? 'macro' : teamSize <= 8 ? 'module' : 'atomic');
-            const granularityLabel = recommendedGranularity === 'macro' ? '\u7c97\u7c92\u5ea6 (macro)' :
-                recommendedGranularity === 'module' ? '\u4e2d\u7c92\u5ea6 (module)' : '\u7ec6\u7c92\u5ea6 (atomic)';
-            const granularityHint = recommendedGranularity === 'macro' ? '\u6bcf\u4e2a\u4efb\u52a1 1-2 \u5468\uff0c\u6309\u4e1a\u52a1\u65b9\u5411\u5408\u5e76' :
-                recommendedGranularity === 'module' ? '\u6bcf\u4e2a\u4efb\u52a1 3-5 \u5929\uff0c\u6309\u529f\u80fd/\u7aef\u62c6\u5206' : '\u6bcf\u4e2a\u4efb\u52a1 1-3 \u5929\uff0c\u6309\u63a5\u53e3/\u8868\u62c6\u5206';
+            const recommendedGranularity = options.granularity || recommendGranularity(teamSize);
+            const granularityLabel = GRANULARITY_RULES[recommendedGranularity].label;
+            const granularityHint = GRANULARITY_RULES[recommendedGranularity].desc;
             // 构建完整 prompt
             let splitPrompt = buildSplitPrompt(iteration, constitutionContent, reqContent2, specContents, staffing, teamSize, granularityLabel, granularityHint);
             await (0, fs_extra_1.writeFile)((0, path_1.join)(promptsDir, `split-suggestion-${iteration}.md`), splitPrompt);
@@ -275,7 +417,7 @@ async function iterationSplitCommand(options) {
             }
             for (const section of approved) {
                 const taskId = section._taskId;
-                await createTaskFromSection(iterationDir, taskId, section, platforms);
+                await createTaskFromSection(iterationDir, taskId, section, platforms, section._taskType);
             }
             spinner.stop(`✅ 创建了 ${approved.length} 个任务`);
             return;
@@ -335,7 +477,7 @@ async function iterationSplitCommand(options) {
                         break;
                     }
                     if (resp?.toLowerCase() === 'y' || resp === '') {
-                        await createTaskFromSection(iterationDir, taskId, sections[i], platforms);
+                        await createTaskFromSection(iterationDir, taskId, sections[i], platforms, sections[i]._taskType);
                         created++;
                         logger_1.logger.info(`    ✅ ${taskId}`);
                     }
@@ -353,7 +495,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);
+                await createTaskFromSection(iterationDir, taskId, sections[i], platforms, sections[i]._taskType);
             }
             await generateImpactGraph(iterationDir, sections, platforms);
             await generateEnvExample(iterationDir, sections);
@@ -365,7 +507,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);
+            await createTaskFromSection(iterationDir, taskId, sections[i], platforms, sections[i]._taskType);
         }
         // ── Generate impact graph + risk scores ──
         await generateImpactGraph(iterationDir, sections, platforms);
@@ -465,15 +607,16 @@ function filterTemplateNoise(sections) {
         return true;
     });
 }
-async function createTaskFromSection(iterationDir, taskId, section, allPlatforms) {
-    const taskDir = (0, path_1.join)(iterationDir, '030-tasks', taskId);
-    const taskPlatforms = section.platform ? [section.platform] : allPlatforms;
+async function createTaskFromSection(iterationDir, taskId, section, allPlatforms, taskType = 'feature') {
+    // 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];
     // ── 1. 元信息目录 ──
     await (0, fs_extra_1.ensureDir)((0, path_1.join)(taskDir, '.meta'));
-    await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '.meta', 'type'), 'feature');
+    await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '.meta', 'type'), taskType);
     await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '.meta', 'status'), 'todo');
     await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '.meta', 'owner'), owner);
     await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '.meta', 'created-at'), today);
@@ -605,7 +748,7 @@ ${apiDesc}
     await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '00-specs', 'TASK.md'), `# ${section.name}
 
 ## 任务信息
-- 类型: feature
+- 类型: ${taskType}
 - 状态: 🔲 待开发
 - 优先级: ${complexity.priority}
 - 负责人: ${owner}
@@ -665,19 +808,26 @@ ${apiDesc}
     if (adr) {
         await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '99-artifacts', 'ADR.md'), adr);
     }
-    // ── 5. 实现目录 10-backend/ 20-20-frontend/ ──
+    // ── 5. 实现目录 10-backend/ 20-frontend/ ──
     for (const platform of taskPlatforms) {
-        if (platform.startsWith('后台') || platform === 'backend') {
+        if (platform === 'backend') {
+            // 纯后端任务：直接创建 10-backend/src/ 和 10-backend/tests/
+            await (0, fs_extra_1.ensureDir)((0, path_1.join)(taskDir, '10-backend', 'src'));
+            await (0, fs_extra_1.ensureDir)((0, path_1.join)(taskDir, '10-backend', 'tests'));
+        }
+        else if (platform.startsWith('后台')) {
+            // 后台服务任务：创建 10-backend/{service}/src/ 和 tests/
             const service = platform.replace(/^后台/, '').trim() || 'default';
-            await (0, fs_extra_1.ensureDir)((0, path_1.join)(taskDir, '10-backend', service || platform, 'src'));
-            await (0, fs_extra_1.ensureDir)((0, path_1.join)(taskDir, '10-backend', service || platform, 'tests'));
+            await (0, fs_extra_1.ensureDir)((0, path_1.join)(taskDir, '10-backend', service, 'src'));
+            await (0, fs_extra_1.ensureDir)((0, path_1.join)(taskDir, '10-backend', service, 'tests'));
         }
         else {
+            // 前端任务：创建 20-frontend/{platform}/src/ 和 tests/
             await (0, fs_extra_1.ensureDir)((0, path_1.join)(taskDir, '20-frontend', platform, 'src'));
             await (0, fs_extra_1.ensureDir)((0, path_1.join)(taskDir, '20-frontend', platform, 'tests'));
         }
     }
-    if (!taskPlatforms.some(p => p.startsWith('后台'))) {
+    if (!taskPlatforms.some((p) => p === 'backend' || p.startsWith('后台'))) {
         await (0, fs_extra_1.ensureDir)((0, path_1.join)(taskDir, '10-backend', 'src'));
         await (0, fs_extra_1.ensureDir)((0, path_1.join)(taskDir, '10-backend', 'tests'));
     }
@@ -688,7 +838,16 @@ ${apiDesc}
     const testContent = await (0, fs_extra_1.readFile)((0, path_1.join)(taskDir, '99-artifacts', 'TEST.md'), 'utf-8');
     const reviewContent = await (0, fs_extra_1.readFile)((0, path_1.join)(taskDir, '99-artifacts', 'REVIEW.md'), 'utf-8');
     for (const platform of taskPlatforms) {
-        if (platform.startsWith('后台') || platform === 'backend') {
+        if (platform === 'backend') {
+            // 纯后端任务：规格写入 10-backend/ 根目录
+            await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '10-backend', 'REQ.md'), reqContent);
+            await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '10-backend', 'TECH.md'), techContent);
+            await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '10-backend', 'TASK.md'), taskContent);
+            await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '10-backend', 'TEST.md'), testContent);
+            await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '10-backend', 'REVIEW.md'), reviewContent);
+        }
+        else if (platform.startsWith('后台')) {
+            // 后台服务任务：规格写入 10-backend/{service}/
             const service = platform.replace(/^后台/, '').trim() || platform;
             const svcDir = (0, path_1.join)(taskDir, '10-backend', service);
             await (0, fs_extra_1.ensureDir)(svcDir);
@@ -699,6 +858,7 @@ ${apiDesc}
             await (0, fs_extra_1.writeFile)((0, path_1.join)(svcDir, 'REVIEW.md'), reviewContent);
         }
         else {
+            // 前端任务：规格写入 20-frontend/{platform}/
             const feDir = (0, path_1.join)(taskDir, '20-frontend', platform);
             await (0, fs_extra_1.ensureDir)(feDir);
             await (0, fs_extra_1.writeFile)((0, path_1.join)(feDir, 'REQ.md'), reqContent);
@@ -727,7 +887,7 @@ async function updateProjectGraph(iterationDir, sections) {
         while (/端端/.test(taskName))
             taskName = taskName.replace('端端', '端');
         if (!content.includes(taskId)) {
-            const taskEntry = `| ${taskId} | ${taskName} | feature | 0% | 🔲 待开发 | |\n`;
+            const taskEntry = `| ${taskId} | ${taskName} | ${sections[i]._taskType || 'feature'} | 0% | 🔲 待开发 | |\n`;
             content = content.replace('| 任务编号 | 任务名称 | 类型 | 进度 | 状态 | 负责人 |\n| :--- | :--- | :--- | :--- | :--- | :--- |\n', `| 任务编号 | 任务名称 | 类型 | 进度 | 状态 | 负责人 |\n| :--- | :--- | :--- | :--- | :--- | :--- |\n${taskEntry}`);
         }
     }
@@ -938,7 +1098,8 @@ async function generateImpactGraph(iterationDir, sections, platforms) {
         const taskId = s._taskId || `Task-${String(i + 1).padStart(3, '0')}`;
         const risk = await (0, risk_scorer_1.scoreRisk)(s.content + s.name, s.name, iterationDir);
         impact += `| ${taskId}: ${s.name} | ${risk.level} | ${risk.score} | ${risk.tags.join(' ')} | ${risk.reasons.join('; ')} |\n`;
-        const taskDir = (0, path_1.join)(iterationDir, '030-tasks', taskId);
+        const taskType = s._taskType || 'feature';
+        const taskDir = (0, path_1.join)(iterationDir, '030-tasks', taskType, taskId);
         if (await (0, fs_extra_1.pathExists)(taskDir)) {
             // 生成风险报告并嵌入 TASK.md（去重：只写一次）
             const taskMdPath = (0, path_1.join)(taskDir, '00-specs', 'TASK.md');
@@ -1331,9 +1492,20 @@ function buildSplitPrompt(iteration, constitutionContent, reqContent, specConten
         }
         p += `\n检测到 ${teamSize} 人团队，推荐粒度: ${granularityLabel}\n\n---\n\n`;
     }
-    // 粒度说明
+    // 粒度说明（含硬约束）
     p += `## 🎯 拆分粒度: ${granularityLabel}\n\n`;
     p += `${granularityHint}\n\n`;
+    p += `### 当前粒度硬约束（必须严格遵守）\n`;
+    if (granularityLabel.includes('粗')) {
+        p += `- 每任务工时: 20-80h（1-2 周）\n- 接口上限: 15 个/任务\n- 数据表上限: 5 张/任务\n- 页面上限: 5 个/任务\n`;
+    }
+    else if (granularityLabel.includes('中')) {
+        p += `- 每任务工时: 12-40h（3-5 天）\n- 接口上限: 8 个/任务\n- 数据表上限: 3 张/任务\n- 页面上限: 3 个/任务\n`;
+    }
+    else {
+        p += `- 每任务工时: 4-24h（1-3 天）\n- 接口上限: 3 个/任务\n- 数据表上限: 2 张/任务\n- 页面上限: 1 个/任务\n`;
+    }
+    p += `\n**超出上限必须再拆，低于下限必须合并。**\n\n`;
     p += `用户可通过 --granularity macro|module|atomic 调整全局粒度。\n\n`;
     // SpecCore 拆分原则
     p += `## ⚙️ SpecCore 拆分原则\n\n`;
@@ -1346,21 +1518,28 @@ function buildSplitPrompt(iteration, constitutionContent, reqContent, specConten
     p += `- execute 时不强依赖其他 Task 的运行时状态\n`;
     p += `- 有明确的验收标准（AC 可枚举）\n`;
     p += `- 可独立提 PR、独立 review\n\n`;
-    p += `### 合并规则\n`;
+    p += `### 合并规则（优先合并，减少任务数）\n`;
     p += `- 同一数据实体的 CRUD → 共享数据模型，合并为 1 个任务\n`;
     p += `- 页面 + 对应后端接口 < 5 个 → 前后端强耦合，一人做效率最高\n`;
     p += `- 纯配置/文案/样式微调 → 不构成独立工作单元\n`;
-    p += `- 关联紧密的小功能（如列表页 + 详情页）→ 共享路由和状态\n\n`;
+    p += `- 关联紧密的小功能（如列表页 + 详情页）→ 共享路由和状态\n`;
+    p += `- **复杂度判断**：如果一个需求章节接口 ≤ 3、数据表 ≤ 1、预估工时 < 粒度下限 → 必须合并到最相关的任务，不单独拆\n`;
+    p += `- **宁少勿多**：任务数越少越好，每个任务应该是真正独立的工作单元。如果两个功能共享数据模型或路由，一人就能做完，不要拆\n\n`;
     p += `### 拆分规则\n`;
-    p += `- 接口 > 8 个 → 按业务领域拆\n`;
-    p += `- 涉及 > 3 张新表 → 按数据层拆\n`;
-    p += `- 超出粒度时间上限 → 必须再拆\n`;
+    p += `- 超出当前粒度接口上限 → 按业务领域拆\n`;
+    p += `- 超出当前粒度数据表上限 → 按数据层拆\n`;
+    p += `- 超出当前粒度工时上限 → 必须再拆\n`;
+    p += `- 低于当前粒度工时下限 → 合并到关联任务\n`;
     p += `- 跨端功能 → 按端拆（后端 1 个 + 每个前端各 1 个）\n`;
     p += `- 独立第三方集成（支付/短信/OSS）→ 独立任务\n\n`;
     p += `### 依赖关系\n`;
     p += `- 基础模块（认证/数据库/配置）优先拆出，作为第一批任务\n`;
     p += `- 依赖链深度 ≤ 3\n`;
     p += `- 同层级无循环依赖\n\n`;
+    p += `### 总量约束\n`;
+    p += `- 单次迭代总任务数: 3-15 个（超出说明粒度不合适）\n`;
+    p += `- 每个任务必须有明确的 owner（对应 STAFFING 中的成员）\n`;
+    p += `- 高优先级任务排在前面\n\n`;
     // 输出格式
     p += `## 📤 输出格式\n\n`;
     p += `请输出 JSON 数组，每个 Task 包含:\n`;
@@ -1382,14 +1561,15 @@ function buildSplitPrompt(iteration, constitutionContent, reqContent, specConten
     p += `  }\n]\n`;
     p += '```\n\n';
     // 质量自检
-    p += `## ✅ 质量自检\n\n`;
-    p += `拆分完成后自查:\n`;
+    p += `## ✅ 质量自检（必须全部通过）\n\n`;
     p += `□ 每个任务都满足原子任务定义？\n`;
-    p += `□ 没有超出粒度时间上限的任务？\n`;
+    p += `□ 每个任务的 estimatedHours 在当前粒度范围内？（不满足 → 合并或再拆）\n`;
     p += `□ 没有循环依赖？\n`;
     p += `□ 基础模块排在前面？\n`;
-    p += `□ 同领域功能没被过度拆分？\n`;
-    p += `□ 总任务数合理（3-15 个/迭代）？\n`;
+    p += `□ 同领域功能没被过度拆分？（同一数据实体的 CRUD 必须合并）\n`;
+    p += `□ 总任务数在 3-15 个范围内？\n`;
+    p += `□ 每个任务都有明确的 owner 和 acceptanceCriteria？\n`;
+    p += `□ 每个任务都能独立提 PR、独立 review？\n`;
     // 自动模式指令
     p += `## 🤖 自动模式指令\n\n`;
     p += `本拆分在自动模式下执行，请遵循以下原则:\n`;
@@ -1404,6 +1584,13 @@ function buildSplitPrompt(iteration, constitutionContent, reqContent, specConten
 `;
     p += `3. **遇阻断就跳过** — 如果某个功能模块信息不足无法拆分，跳过它并在疑问清单中记录\n`;
     p += `4. **输出 JSON** — 直接输出拆分结果的 JSON 数组，不要输出其他内容\n`;
+    // 持久指令（用户调整时 AI 可回读此文件）
+    p += `\n## 🔄 调整指令（持久有效）\n\n`;
+    p += `当用户要求调整拆分方案时（如“合并”“拆分”“改工时”“改优先级”）：\n`;
+    p += `1. **先重读本文件** — 本文件包含完整的拆分规则、粒度约束、端配置、Spec 上下文\n`;
+    p += `2. **在同一套规则下调整** — 合并/拆分/修改都必须遵守粒度硬约束\n`;
+    p += `3. **重新输出完整 JSON** — 不要只输出修改的部分，输出调整后的完整数组\n`;
+    p += `4. **文件路径**: \`.speccore/prompts/split-suggestion-${iteration}.md\`\n\n`;
     return p;
 }
 /**
@@ -1533,15 +1720,24 @@ async function detectExistingTasks(iterDir) {
     // 优先从 030-tasks/ 扫描，兼容旧布局（迭代根目录）
     const scanDir = (0, path_1.join)(iterDir, '030-tasks');
     const targetDir = (await (0, fs_extra_1.pathExists)(scanDir)) ? scanDir : iterDir;
-    try {
-        const entries = require('fs').readdirSync(targetDir, { withFileTypes: true });
-        for (const e of entries) {
-            if (e.isDirectory() && e.name.startsWith('Task-')) {
-                tasks.push(e.name);
+    const scanRecursive = async (dir) => {
+        try {
+            const entries = await (0, fs_extra_1.readdir)(dir, { withFileTypes: true });
+            for (const e of entries) {
+                if (e.isDirectory()) {
+                    if (e.name.startsWith('Task-')) {
+                        tasks.push(e.name);
+                    }
+                    else if (!e.name.startsWith('.')) {
+                        // 递归扫描类型子目录（feature/bugfix/refactor/research）
+                        await scanRecursive((0, path_1.join)(dir, e.name));
+                    }
+                }
             }
         }
-    }
-    catch { }
+        catch { }
+    };
+    await scanRecursive(targetDir);
     return tasks;
 }
 //# sourceMappingURL=split.js.map