speccore 8.3.158 → 8.3.160

package/README.md

@@ -337,7 +337,7 @@ speccore status                                       # 查看分析进度和过
 
 ```bash
 npm install -g speccore
-speccore --version   # v8.3.158
+speccore --version   # v8.3.95
 ```
 
 ## 命令列表

package/dist/commands/analyze.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/commands/analyze.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/commands/analyze.ts"],"names":[],"mappings":"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"}

package/dist/commands/analyze.js

@@ -850,8 +850,8 @@ async function analyzeCommand(options) {
             engine = result.engine;
             steps = result.steps;
             pipelineKey = iter;
-            // v6.80.0+: 默认从 clarify 开始，skipClarify 时从 phase1 开始
-            initStep = options.skipClarify ? 'phase1-prompt' : 'clarify-prompt';
+            // v8.3.160+: clarify 拆分为 product → interaction → security 三个子步骤
+            initStep = options.skipClarify ? 'phase1-prompt' : 'clarify-product';
         }
         // 检查是否有活跃的 Pipeline（恢复模式）
         const hasActive = await pipeline_engine_1.PipelineEngine.hasActivePipeline(_projectRoot, pipelineKey);
@@ -896,8 +896,8 @@ async function analyzeCommand(options) {
                 }, options);
             }
         }
-        else if (currentStep === 'clarify-prompt') {
-            // v6.80.0+: Phase 0 需求澄清
+        else if (currentStep === 'clarify-product' || currentStep === 'clarify-interaction' || currentStep === 'clarify-security') {
+            // v8.3.160+: Phase 0 需求澄清（拆分为 product / interaction / security 三个子步骤）
             prompt = await buildClarifyPhasePrompt(iter);
         }
         else if (currentStep === 'confirm-check') {
@@ -941,22 +941,27 @@ async function analyzeCommand(options) {
                                 : '全局 Pipeline';
         }
         else {
-            progressLabel = currentStep === 'clarify-prompt'
-                ? 'Phase 0/3: 需求澄清'
-                : currentStep === 'confirm-check'
-                    ? 'Phase 0/3: 需求确认'
-                    : currentStep === 'phase1-prompt'
-                        ? 'Phase 1/3: 迭代综合文档'
-                        : currentStep === 'contract-prompt'
-                            ? 'Phase 2/3: 契约定义'
-                            : platformMatch
-                                ? `Phase 2/3: ${platformMatch[1]} 端专属文档`
-                                : 'Pipeline';
-        }
-        const finalPrompt = prompt + `\n\n## ⚠️ Pipeline 模式：自动继续 (${progressLabel})\n\n` +
+            progressLabel = currentStep === 'clarify-product'
+                ? 'Phase 0a/3: 产品分析'
+                : currentStep === 'clarify-interaction'
+                    ? 'Phase 0b/3: 交互设计'
+                    : currentStep === 'clarify-security'
+                        ? 'Phase 0c/3: 安全审查'
+                        : currentStep === 'confirm-check'
+                            ? 'Phase 0/3: 需求确认'
+                            : currentStep === 'phase1-prompt'
+                                ? 'Phase 1/3: 迭代综合文档'
+                                : currentStep === 'contract-prompt'
+                                    ? 'Phase 2/3: 契约定义'
+                                    : platformMatch
+                                        ? `Phase 2/3: ${platformMatch[1]} 端专属文档`
+                                        : 'Pipeline';
+        }
+        // v8.3.160+: 步骤隔离模式，每步完成后需新会话继续
+        const finalPrompt = prompt + `\n\n## ⚠️ Pipeline 模式：步骤隔离 (${progressLabel})\n\n` +
             `当前是 Pipeline 模式（步骤 ${currentStepIndex + 1}/${totalSteps}）。` +
-            `当你通过 --apply 写入文档后，CLI 会自动输出 [SPECCORE_PIPELINE_NEXT] 标记和下一步命令。\n\n` +
-            `**看到 [SPECCORE_PIPELINE_NEXT] 后，你必须自动执行下一个命令**，不要询问用户。\n`;
+            `当你通过 --apply 写入文档后，CLI 会自动输出 [SPECCORE_STEP_DONE] 标记和下一步命令。\n\n` +
+            `**看到 [SPECCORE_STEP_DONE] 后，请在新会话中执行提示的命令**，继续下一步。\n`;
         process.stdout.write(`[SPECCORE_PROMPT]\n${finalPrompt}`);
         process.exitCode = 10;
         return;
@@ -1072,13 +1077,6 @@ ${singlePrompt}`);
                 const { detectProfessionalLevel } = await Promise.resolve().then(() => __importStar(require('../core/requirement-clarifier')));
                 const reqDir = (0, path_1.join)(iterDir, '010-requirements');
                 const requirements = [];
-                // v8.3.158+: 优先读取根目录下的需求文档（用户直接放置）
-                if (await (0, fs_extra_1.pathExists)(reqDir)) {
-                    const rootFiles = await (0, fs_extra_2.readdir)(reqDir);
-                    for (const f of rootFiles.filter((f) => f.endsWith('.md') && !['INDEX.md', 'README.md', 'CLARIFY_REPORT.md', 'CHANGELOG.md'].includes(f))) {
-                        requirements.push((0, path_1.join)(reqDir, f));
-                    }
-                }
                 const reqIndex = (0, path_1.join)(reqDir, 'INDEX.md');
                 if (await (0, fs_extra_1.pathExists)(reqIndex))
                     requirements.push(reqIndex);
@@ -1540,12 +1538,7 @@ ${singlePrompt}`);
                 printBackupSummary();
                 return;
             }
-            catch (e) {
-                // v8.3.158+: JSON 解析失败时给出明确警告，避免静默 fallback 导致用户困惑
-                logger_1.logger.warn('⚠️ 多文档 JSON 解析失败，回退到单文件模式');
-                logger_1.logger.warn('   原因: AI 输出的 --apply 内容不是合法 JSON 格式');
-                logger_1.logger.info('   建议: 使用 [DOC:filename] 标记格式，或将 JSON 写入文件后用 --apply @file.json');
-                logger_1.logger.info('   当前内容将作为单文件 ANALYSIS.md 写入（内容可能不完整）');
+            catch {
                 // fallback to single-file mode
             }
         }
@@ -1917,7 +1910,8 @@ ${singlePrompt}`);
                         platformOrder: platformOrder.length > 0 ? platformOrder : undefined,
                     })).engine;
                 }
-                await engine.advance();
+                // v8.3.160+: 默认步骤隔离模式
+                const stepResult = await engine.advance();
                 const state = await engine.getState();
                 if (state?.currentStep === 'done') {
                     logger_1.logger.success('🎉 Pipeline 完成!');
@@ -1954,9 +1948,9 @@ ${singlePrompt}`);
                                 iteration: options.iteration || 'GLOBAL', scope: 'global', withCode: options.withCode,
                             });
                         }
-                        // v6.80.0+: clarify 阶段推进
+                        // v8.3.160+: clarify 阶段推进（拆分为 product / interaction / security）
                     }
-                    else if (state.currentStep === 'clarify-prompt') {
+                    else if (state.currentStep === 'clarify-product' || state.currentStep === 'clarify-interaction' || state.currentStep === 'clarify-security') {
                         nextPrompt = await buildClarifyPhasePrompt(options.iteration);
                     }
                     else if (state.currentStep === 'confirm-check') {
@@ -1985,7 +1979,31 @@ ${singlePrompt}`);
                             iteration: options.iteration,
                         });
                     }
-                    process.stdout.write(`[SPECCORE_PIPELINE_NEXT]\n${nextPrompt}`);
+                    // v8.3.160+: 步骤隔离模式输出标记 + 子 Agent 激活
+                    const scopeFlag = isGlobalScope ? '--scope global' : `-I ${options.iteration}`;
+                    const nextCmd = `speccore analyze ${scopeFlag} --resume`;
+                    const output = [
+                        `[SPECCORE_STEP_DONE]`,
+                        `步骤 "${state.currentStep}" 已完成。`,
+                        ``,
+                        `[SPECCORE_NEXT_STEP]`,
+                        `下一步: ${state.currentStep}`,
+                        `请在新的对话中执行: ${nextCmd}`,
+                        ``,
+                        `[SPECCORE_CONTEXT_SNAPSHOT]`,
+                        JSON.stringify(stepResult.contextSnapshot || {}),
+                        ``,
+                        // v8.3.160+: 子 Agent 激活标记
+                        ...(stepResult.subagent ? [
+                            `[SPECCORE_SUBAGENT: ${stepResult.subagent}]`,
+                            `[SPECCORE_CONTEXT_BUDGET: ${stepResult.contextBudget || 12000}]`,
+                            `[SPECCORE_CONTEXT_TYPE: ${stepResult.contextType || 'full'}]`,
+                            ``,
+                        ] : []),
+                        `--- 下一步 Prompt ---`,
+                        nextPrompt,
+                    ].join('\n');
+                    process.stdout.write(output);
                     process.exitCode = 10;
                 }
                 return;
@@ -4238,12 +4256,7 @@ sequenceDiagram
             if (iterDir) {
                 const specDir = (0, path_1.join)(iterDir, '020-specs');
                 const platforms = await (0, spec_paths_1.parsePlatformList)();
-                // v8.3.158+: 骨架进度检测必须使用与骨架生成一致的 manifest（功能模块结构）
-                const features = await (0, spec_paths_1.parseFeatureList)(iterDir);
-                const useFeatureMode = features.length > 0;
-                const manifest = useFeatureMode
-                    ? (0, spec_skeleton_1.computeFeatureBasedAnalyzeManifest)(features, platforms, undefined, ctx.iteration)
-                    : (0, spec_skeleton_1.computeAnalyzeManifest)(platforms, undefined, ctx.iteration);
+                const manifest = (0, spec_skeleton_1.computeAnalyzeManifest)(platforms, undefined, ctx.iteration);
                 perDocStatus = await (0, spec_skeleton_1.detectSkeletonProgress)(specDir, manifest);
                 if (perDocStatus.nextUnfilled) {
                     const nextDocName = perDocStatus.nextUnfilled.docName;
@@ -4299,47 +4312,41 @@ sequenceDiagram
                     if (missingDocs.length > 0) {
                         logger_1.logger.warn(`⚠️ DOC_MATRIX 交叉校验发现 ${missingDocs.length} 个全局文档缺失（不在骨架清单中但应该存在）: ${missingDocs.join(', ')}`);
                         logger_1.logger.info(`🔧 自动补建骨架文件...`);
-                        // 为缺失文档补建骨架（使用与当前模式一致的 manifest）
-                        const missingEntries = (useFeatureMode
-                            ? (0, spec_skeleton_1.computeFeatureBasedAnalyzeManifest)(features, platforms, '1', ctx.iteration)
-                            : (0, spec_skeleton_1.computeAnalyzeManifest)(platforms, '1', ctx.iteration)).filter(e => missingDocs.includes(e.docName));
+                        // 为缺失文档补建骨架
+                        const missingEntries = (0, spec_skeleton_1.computeAnalyzeManifest)(platforms, '1', ctx.iteration)
+                            .filter(e => missingDocs.includes(e.docName));
                         if (missingEntries.length > 0) {
                             await (0, spec_skeleton_1.generateSkeleton)(specDir, missingEntries);
                             logger_1.logger.info(`✅ 已补建 ${missingEntries.length} 个骨架文件，请继续填充`);
                             // 重新检测进度（现在有了新骨架）
-                            const newManifest = useFeatureMode
-                                ? (0, spec_skeleton_1.computeFeatureBasedAnalyzeManifest)(features, platforms, undefined, ctx.iteration)
-                                : (0, spec_skeleton_1.computeAnalyzeManifest)(platforms, undefined, ctx.iteration);
+                            const newManifest = (0, spec_skeleton_1.computeAnalyzeManifest)(platforms, undefined, ctx.iteration);
                             perDocStatus = await (0, spec_skeleton_1.detectSkeletonProgress)(specDir, newManifest);
                         }
                     }
                     // v8.1.1+: Phase 2 平台文档交叉校验
-                    // v8.3.158+: 功能模块模式下跳过旧结构交叉校验（平台文档按功能模块组织，不在 020-specs/{端}/ 下）
-                    if (!useFeatureMode) {
-                        const expectedPlatformDocs = PLATFORM_DOCS.filter(d => includeDocs.includes(d));
-                        const missingPlatformDocs = [];
-                        for (const platform of platforms) {
-                            for (const doc of expectedPlatformDocs) {
-                                const docPath = (0, path_1.join)(specDir, platform, doc);
-                                if (!await (0, fs_extra_1.pathExists)(docPath)) {
-                                    missingPlatformDocs.push(`${platform}/${doc}`);
-                                }
+                    const expectedPlatformDocs = PLATFORM_DOCS.filter(d => includeDocs.includes(d));
+                    const missingPlatformDocs = [];
+                    for (const platform of platforms) {
+                        for (const doc of expectedPlatformDocs) {
+                            const docPath = (0, path_1.join)(specDir, platform, doc);
+                            if (!await (0, fs_extra_1.pathExists)(docPath)) {
+                                missingPlatformDocs.push(`${platform}/${doc}`);
                             }
                         }
-                        if (missingPlatformDocs.length > 0) {
-                            logger_1.logger.warn(`⚠️ DOC_MATRIX 交叉校验发现 ${missingPlatformDocs.length} 个平台文档缺失: ${missingPlatformDocs.slice(0, 5).join(', ')}${missingPlatformDocs.length > 5 ? '...' : ''}`);
-                            logger_1.logger.info(`🔧 自动补建平台骨架文件...`);
-                            const missingPlatformEntries = (0, spec_skeleton_1.computeAnalyzeManifest)(platforms, '2', ctx.iteration)
-                                .filter(e => {
-                                const relName = e.relPath;
-                                return missingPlatformDocs.some(mp => relName.endsWith(mp) || mp.endsWith(relName));
-                            });
-                            if (missingPlatformEntries.length > 0) {
-                                await (0, spec_skeleton_1.generateSkeleton)(specDir, missingPlatformEntries);
-                                logger_1.logger.info(`✅ 已补建 ${missingPlatformEntries.length} 个平台骨架文件，请继续填充`);
-                                const newManifest = (0, spec_skeleton_1.computeAnalyzeManifest)(platforms, undefined, ctx.iteration);
-                                perDocStatus = await (0, spec_skeleton_1.detectSkeletonProgress)(specDir, newManifest);
-                            }
+                    }
+                    if (missingPlatformDocs.length > 0) {
+                        logger_1.logger.warn(`⚠️ DOC_MATRIX 交叉校验发现 ${missingPlatformDocs.length} 个平台文档缺失: ${missingPlatformDocs.slice(0, 5).join(', ')}${missingPlatformDocs.length > 5 ? '...' : ''}`);
+                        logger_1.logger.info(`🔧 自动补建平台骨架文件...`);
+                        const missingPlatformEntries = (0, spec_skeleton_1.computeAnalyzeManifest)(platforms, '2', ctx.iteration)
+                            .filter(e => {
+                            const relName = e.relPath; // e.g. "overview/TECH.md" relative to specDir
+                            return missingPlatformDocs.some(mp => relName.endsWith(mp) || mp.endsWith(relName));
+                        });
+                        if (missingPlatformEntries.length > 0) {
+                            await (0, spec_skeleton_1.generateSkeleton)(specDir, missingPlatformEntries);
+                            logger_1.logger.info(`✅ 已补建 ${missingPlatformEntries.length} 个平台骨架文件，请继续填充`);
+                            const newManifest = (0, spec_skeleton_1.computeAnalyzeManifest)(platforms, undefined, ctx.iteration);
+                            perDocStatus = await (0, spec_skeleton_1.detectSkeletonProgress)(specDir, newManifest);
                         }
                     }
                 }
@@ -4615,19 +4622,6 @@ status: "clarified"
                 else {
                     // 回退：从 010-requirements/ 读取原始需求
                     const reqDir = (0, path_1.join)(iterDirForCtx, '010-requirements');
-                    // v8.3.158+: 优先读取根目录下的 .md 文件（用户直接放置的需求文档）
-                    const rootFiles = (await Promise.resolve().then(() => __importStar(require('fs-extra')))).readdirSync(reqDir).filter((f) => f.endsWith('.md') && !['INDEX.md', 'README.md', 'CLARIFY_REPORT.md', 'CHANGELOG.md'].includes(f));
-                    if (rootFiles.length > 0) {
-                        for (const f of rootFiles.slice(0, 10)) {
-                            const filePath = (0, path_1.join)(reqDir, f);
-                            let content = await (await Promise.resolve().then(() => __importStar(require('fs-extra')))).readFile(filePath, 'utf-8');
-                            content = await (0, prompt_builder_1.processMarkdownContent)(content, filePath, seenPaths, undefined, {
-                                maxLinkDepth: 2, maxLinkChars: 1200, maxSvgChars: 1500,
-                            });
-                            prdContent += `\n### ${f}\n${content.slice(0, 3000)}\n`;
-                        }
-                    }
-                    // 再读取子目录中的需求文档（兼容旧结构）
                     const prdSources = (0, path_1.join)(reqDir, 'sources');
                     const prdConverted = (0, path_1.join)(reqDir, 'converted');
                     const prdFeatures = (0, path_1.join)(reqDir, 'features');
@@ -4822,13 +4816,12 @@ status: "clarified"
             prompt += `   ⚠️ 如果全局层产物不存在，跳过该项，继续后续分析\n\n`;
             prompt += `3. 读取迭代需求文档（按优先级顺序）：\n`;
             prompt += `   a. 先读 010-requirements/INDEX.md — 了解需求全貌和文件清单\n`;
-            prompt += `   b. 再读 010-requirements/根目录下的 *.md 文件 — 用户直接放置的核心需求文档（最高优先级）\n`;
-            prompt += `   c. 再读 010-requirements/converted/*.md — doc2spec 转换后的核心规格\n`;
-            prompt += `   d. 再读 010-requirements/features/*/README.md — 功能级补充需求\n`;
-            prompt += `   e. 读取 010-requirements/prototypes/ — 原型文件（HTML/图片/链接均读取）\n`;
+            prompt += `   b. 再读 010-requirements/converted/*.md — doc2spec 转换后的核心规格（主要依据）\n`;
+            prompt += `   c. 再读 010-requirements/features/*/README.md — 功能级补充需求\n`;
+            prompt += `   d. 读取 010-requirements/prototypes/ — 原型文件（HTML/图片/链接均读取）\n`;
             prompt += `      ⚠️ 需求文档中链接到原型的（如 \`![原型](../prototypes/xxx.png)\` 或 \`详见 prototypes/xxx.html\`），必须主动 Read 该原型文件\n`;
-            prompt += `   f. 如用户指定了特定文档，优先读取指定文件；如要求全部，再读 sources/ 原始文档\n`;
-            prompt += `   g. **文档长度自适应**：如果单个需求文档超过 5000 字，先快速扫描目录和章节标题，标记关键章节，再深入阅读。不要在非关键章节上花费过多 tokens\n`;
+            prompt += `   e. 如用户指定了特定文档，优先读取指定文件；如要求全部，再读 sources/ 原始文档\n`;
+            prompt += `   f. **文档长度自适应**：如果单个需求文档超过 5000 字，先快速扫描目录和章节标题，标记关键章节，再深入阅读。不要在非关键章节上花费过多 tokens\n`;
             prompt += `4. 读懂需求文档后，按专业模板标准自由撰写每个文档（不是填空表）\n`;
             prompt += `5. **文档忠实度约束（最高优先级）**：\n`;
             prompt += `   - **严禁臆造**：只能写需求文档中明确提及的功能、接口、页面、字段、业务规则\n`;
@@ -5464,11 +5457,10 @@ async function buildClarifyPhasePrompt(iteration) {
     prompt += `\n## 读取需求文档\n\n`;
     prompt += `依次读取以下文档（按优先级）：\n`;
     prompt += `1. \`010-requirements/INDEX.md\` — 需求全貌\n`;
-    prompt += `2. \`010-requirements/根目录下的 *.md 文件\` — 用户直接放置的核心需求文档（最高优先级）\n`;
+    prompt += `2. \`010-requirements/sources/*.md\` — 原始需求（主要依据）\n`;
     prompt += `3. \`010-requirements/converted/*.md\` — 已转换文档\n`;
     prompt += `4. \`010-requirements/features/*/README.md\` — 功能级补充\n`;
-    prompt += `5. \`010-requirements/prototypes/\` — 原型文件\n`;
-    prompt += `6. \`010-requirements/sources/*.md\` — 原始需求（补充参考）\n\n`;
+    prompt += `5. \`010-requirements/prototypes/\` — 原型文件\n\n`;
     // v8.2.0+: 如果检测到多个功能单元，启用单元化澄清模式
     if (hasMultipleUnits) {
         prompt += `## ⚠️ 功能单元拆分澄清模式（v8.2.0+）\n\n`;
@@ -5641,7 +5633,7 @@ async function buildConfirmCheckPrompt(iteration) {
     prompt += `\`\`\`bash\n`;
     prompt += `speccore analyze --prompt -I ${iteration} --pipeline --skip-clarify=false\n`;
     prompt += `\`\`\`\n`;
-    prompt += `> 重新进入 clarify-prompt 阶段，AI 会基于已有 draft 继续迭代。\n\n`;
+    prompt += `> 重新进入 clarify-product 阶段，AI 会基于已有 draft 继续迭代。\n\n`;
     prompt += `**选项 C：跳过确认，直接进入分析（风险自负）**\n`;
     prompt += `\`\`\`bash\n`;
     prompt += `speccore analyze --prompt -I ${iteration} --pipeline --skip-clarify\n`;