@zhuan-ai/zhuanspec 2.17.14 → 2.19.1

package/dist/cli/index.js

@@ -1,4 +1,4 @@
-import { Command } from 'commander';
+import { Command, Option } from 'commander';
 import { createRequire } from 'module';
 import ora from 'ora';
 import path from 'path';
@@ -104,8 +104,9 @@ const registerTechDesignCommand = (commandName, deprecatedAlias = false) => prog
     : 'Prepare technical design generation request (techDesign phase, independent before proposal by default)')
     .option('--change <change-id>', 'Optionally bind generated design source to a change')
     .option('--desc <text>', 'Requirement description used for technical design generation')
-    .option('--dashen-page-id <id>', 'Dashen pageId used as requirement source')
-    .option('--dashen-url <url>', 'Dashen document URL used as requirement source')
+    .option('--feishu-url <url>', 'Feishu document URL used as requirement source')
+    .addOption(new Option('--dashen-page-id <id>', 'Legacy pageId used as requirement source').hideHelp())
+    .addOption(new Option('--dashen-url <url>', 'Legacy document URL used as requirement source').hideHelp())
     .option('--output <path>', 'Output path of generated request markdown (default: doc/*技术方案生成请求.md)')
     .option('--init-template', 'Generate empty design.md template inside a change (legacy mode)')
     .option('--force', 'Overwrite existing output file or bound design.md')
@@ -117,7 +118,11 @@ const registerTechDesignCommand = (commandName, deprecatedAlias = false) => prog
             console.error('Warning: "zhuanspec design" is deprecated. Please use "zhuanspec techDesign".');
         }
         const designCommand = new DesignCommand();
-        await designCommand.execute(changeName, options);
+        await designCommand.execute(changeName, {
+            ...options,
+            legacyPageId: options?.dashenPageId,
+            legacyUrl: options?.dashenUrl,
+        });
     }
     catch (error) {
         console.log();

package/dist/commands/artifact-workflow.js

@@ -13,7 +13,7 @@ import { createChange, validateChangeName } from '../utils/change-utils.js';
 import { discoverSkills } from '../core/skill-discovery.js';
 import { getNewChangeSkillTemplate, getContinueChangeSkillTemplate, getApplyChangeSkillTemplate, getFfChangeSkillTemplate, getSyncSpecsSkillTemplate, getArchiveChangeSkillTemplate, getProposeChangeSkillTemplate, getExploreSkillTemplate, getVerifySkillTemplate, getOpsxNewCommandTemplate, getOpsxContinueCommandTemplate, getOpsxApplyCommandTemplate, getOpsxFfCommandTemplate, getOpsxSyncCommandTemplate, getOpsxArchiveCommandTemplate, getOpsxProposeCommandTemplate, getOpsxExploreCommandTemplate, getOpsxVerifyCommandTemplate } from '../core/templates/skill-templates.js';
 import { FileSystemUtils } from '../utils/file-system.js';
-import { parseTasks, generateExecutionPlan, renderExecutionPlanXml, renderMermaidDiagram, hasDependsAnnotations, } from '../core/task-graph/index.js';
+import { parseTasks, generateExecutionPlan, renderExecutionPlanXml, hasDependsAnnotations, } from '../core/task-graph/index.js';
 const DEFAULT_SCHEMA = 'spec-driven';
 /**
  * Checks if color output is disabled via NO_COLOR env or --no-color flag.
@@ -427,26 +427,6 @@ async function generateApplyInstructions(projectRoot, changeName, schemaName) {
             if (hasDependencies && !allTasksComplete) {
                 const executionPlan = generateExecutionPlan(parsedTasks);
                 executionPlanXml = renderExecutionPlanXml(executionPlan);
-                // Generate Mermaid diagram and embed in tasks.md
-                if (executionPlan && !executionPlan.hasCycle) {
-                    const mermaidSection = renderMermaidDiagram(executionPlan, parsedTasks);
-                    if (mermaidSection) {
-                        // Read current tasks.md content
-                        let currentTasksContent = tasksContent;
-                        // Check if tasks.md already has Workflow Diagram section
-                        const workflowDiagramRegex = /## Workflow Diagram[\s\S]*?(?=\n## |$)/;
-                        if (workflowDiagramRegex.test(currentTasksContent)) {
-                            // Replace existing Workflow Diagram section
-                            currentTasksContent = currentTasksContent.replace(workflowDiagramRegex, mermaidSection);
-                        }
-                        else {
-                            // Append to file end
-                            currentTasksContent = currentTasksContent.trimEnd() + '\n\n' + mermaidSection;
-                        }
-                        // Write back to tasks.md
-                        fs.writeFileSync(tracksPath, currentTasksContent, 'utf-8');
-                    }
-                }
             }
         }
     }
@@ -475,17 +455,15 @@ async function generateApplyInstructions(projectRoot, changeName, schemaName) {
     }
     else if (tracksFile && remaining === 0 && total > 0) {
         state = 'all_done';
-        instruction = `All tasks are complete. Review should auto-run once after apply completion.
+        instruction = `All tasks are complete. Apply is finished.
 
 **Required Next Steps**
 
-1. Verify auto review report exists (\`metrics/review.json\`, \`metrics/tests.json\`)
-2. Ensure unit tests pass in the review report
-3. Ensure critical issues = 0
-4. If auto review failed/missing, run \`zhuanspec review ${changeName}\` manually
-5. Then continue to \`zhuanspec archive ${changeName}\`
+1. Run \`zhuanspec review ${changeName}\` to verify implementation quality
+2. Fix any review findings if needed
+3. Continue to \`zhuanspec archive ${changeName}\` after review passes
 
-Archive may be blocked if review/tests are missing or failed.`;
+Archive may be blocked if review results are missing or failed.`;
     }
     else if (!tracksFile) {
         // No tracking file (e.g., TDD schema) - ready to apply
@@ -588,16 +566,13 @@ function printApplyInstructionsText(instructions) {
     // Code review prompt for all_done state
     if (state === 'all_done') {
         console.log();
-        console.log('### 📋 Code Review (Auto + Required)');
+        console.log('### Next Step');
         console.log();
         console.log('All tasks are complete. You should now:');
         console.log();
-        console.log('1. Auto review is triggered once when all apply tasks complete');
-        console.log('2. Confirm `metrics/review.json` and `metrics/tests.json` exist');
-        console.log('3. Ensure review report is PASS with no critical issues');
-        console.log('4. Ensure unit tests pass');
-        console.log('5. If auto review failed/missing, run `zhuanspec review <change-id>` manually');
-        console.log('6. Then proceed to archive workflow');
+        console.log('1. Run `zhuanspec review <change-id>`');
+        console.log('2. Fix review findings if needed');
+        console.log('3. Then proceed to archive workflow');
     }
 }
 async function templatesCommand(options) {

package/dist/commands/design.d.ts

@@ -4,8 +4,9 @@ export declare class DesignCommand {
         initTemplate?: boolean;
         change?: string;
         desc?: string;
-        dashenPageId?: string;
-        dashenUrl?: string;
+        feishuUrl?: string;
+        legacyPageId?: string;
+        legacyUrl?: string;
         output?: string;
         validate?: boolean;
         autoFix?: boolean;

package/dist/commands/design.js

@@ -49,8 +49,9 @@ export class DesignCommand {
         if (options?.createChange && !boundChange) {
             const designContext = await this.resolveDesignContext({
                 desc: options?.desc,
-                dashenPageId: options?.dashenPageId,
-                dashenUrl: options?.dashenUrl,
+                feishuUrl: options?.feishuUrl,
+                legacyPageId: options?.legacyPageId,
+                legacyUrl: options?.legacyUrl,
             });
             const newChangeName = await this.generateChangeName(designContext);
             await this.createTechDesignChange(newChangeName, designContext);
@@ -76,11 +77,12 @@ export class DesignCommand {
         }
         const designContext = await this.resolveDesignContext({
             desc: options?.desc,
-            dashenPageId: options?.dashenPageId,
-            dashenUrl: options?.dashenUrl,
+            feishuUrl: options?.feishuUrl,
+            legacyPageId: options?.legacyPageId,
+            legacyUrl: options?.legacyUrl,
         });
-        if (!designContext.desc && !designContext.dashenPageId && !designContext.dashenUrl) {
-            throw new Error('Missing design source. Provide --desc / --dashen-page-id / --dashen-url to generate technical design.');
+        if (!designContext.desc && !designContext.feishuUrl && !designContext.legacyPageId && !designContext.legacyUrl) {
+            throw new Error('Missing design source. Provide --desc or --feishu-url to generate technical design.');
         }
         const outputPath = await this.resolveOutputPath(options?.output, boundChange);
         const exists = await FileSystemUtils.fileExists(outputPath);
@@ -112,15 +114,16 @@ export class DesignCommand {
     async resolveDesignContext(input) {
         const result = {
             desc: input.desc?.trim() ?? '',
-            dashenPageId: input.dashenPageId?.trim() ?? '',
-            dashenUrl: input.dashenUrl?.trim() ?? '',
+            feishuUrl: input.feishuUrl?.trim() ?? '',
+            legacyPageId: input.legacyPageId?.trim() ?? '',
+            legacyUrl: input.legacyUrl?.trim() ?? '',
         };
-        if (result.desc || result.dashenPageId || result.dashenUrl || !process.stdin.isTTY) {
+        if (result.desc || result.feishuUrl || result.legacyPageId || result.legacyUrl || !process.stdin.isTTY) {
             return result;
         }
         const { input: askInput } = await import('@inquirer/prompts');
         const source = await askInput({
-            message: '请输入需求描述（或留空后继续输入 Dashen 信息）',
+            message: '请输入需求描述或飞书文档 URL（飞书文档将使用飞书 CLI 读取）',
             default: '',
         });
         result.desc = source.trim();
@@ -147,12 +150,12 @@ export class DesignCommand {
             '',
             '## 输入',
             `- 需求描述: ${context.desc || '(未提供)'}`,
-            `- Dashen Page ID: ${context.dashenPageId || '(未提供)'}`,
-            `- Dashen URL: ${context.dashenUrl || '(未提供)'}`,
+            `- 飞书文档 URL: ${context.feishuUrl || context.legacyUrl || '(未提供)'}`,
+            '- 飞书读取方式: 使用飞书 CLI `lark-cli` 读取正文',
             `- 绑定变更: ${boundChange || '(无，独立于提案阶段)'}`,
             '',
             '## 生成要求',
-            '- 使用 Dashen 模板优先，本地模板兜底',
+            '- 使用飞书文档内容作为需求来源，本地输入兜底',
             '- 输出完整技术方案（含 Mermaid）',
             '- 覆盖需求功能点并附带校验结果与修复记录',
             '',
@@ -346,12 +349,17 @@ export class DesignCommand {
         if (context.desc) {
             base = context.desc;
         }
-        else if (context.dashenPageId) {
-            base = `tech-design-${context.dashenPageId}`;
+        else if (context.feishuUrl) {
+            const docMatch = context.feishuUrl.match(/(?:docx|wiki)\/([^/?#]+)/);
+            const storyMatch = context.feishuUrl.match(/story\/detail\/([^/?#]+)/);
+            base = `tech-design-${docMatch?.[1] || storyMatch?.[1] || Date.now()}`;
         }
-        else if (context.dashenUrl) {
+        else if (context.legacyPageId) {
+            base = `tech-design-${context.legacyPageId}`;
+        }
+        else if (context.legacyUrl) {
             // Extract page ID from URL if possible
-            const match = context.dashenUrl.match(/pages\/(\d+)/);
+            const match = context.legacyUrl.match(/pages\/(\d+)/);
             base = match ? `tech-design-${match[1]}` : `tech-design-${Date.now()}`;
         }
         else {
@@ -391,9 +399,9 @@ export class DesignCommand {
         // 3. Create techDesign/ directory and tech-spec.md placeholder
         const techDesignDir = path.join(changeDir, 'techDesign');
         await FileSystemUtils.createDirectory(techDesignDir);
-        await FileSystemUtils.writeFile(path.join(techDesignDir, 'tech-spec.md'), `# Tech Spec\n\ncreated: ${new Date().toISOString()}\nsource: ${context.desc || context.dashenPageId || 'manual'}\n\n> This file will be populated by the techDesign skill.\n`);
+        await FileSystemUtils.writeFile(path.join(techDesignDir, 'tech-spec.md'), `# Tech Spec\n\ncreated: ${new Date().toISOString()}\nsource: ${context.desc || context.feishuUrl || context.legacyPageId || 'manual'}\n\n> This file will be populated by the techDesign skill.\n`);
         // 3b. Also create .tech-design marker for backward compatibility
-        await FileSystemUtils.writeFile(path.join(changeDir, '.tech-design'), `created: ${new Date().toISOString()}\nsource: ${context.desc || context.dashenPageId || 'manual'}\n`);
+        await FileSystemUtils.writeFile(path.join(changeDir, '.tech-design'), `created: ${new Date().toISOString()}\nsource: ${context.desc || context.feishuUrl || context.legacyPageId || 'manual'}\n`);
         // 4. Create design.md skeleton
         await FileSystemUtils.writeFile(path.join(changeDir, 'design.md'), DEFAULT_DESIGN_TEMPLATE);
         // 5. Create doc/ request file (keep compatibility)

package/dist/core/completions/command-registry.js

@@ -86,13 +86,8 @@ export const COMMAND_REGISTRY = [
                 takesValue: true,
             },
             {
-                name: 'dashen-page-id',
-                description: 'Dashen pageId used as requirement source',
-                takesValue: true,
-            },
-            {
-                name: 'dashen-url',
-                description: 'Dashen document URL used as requirement source',
+                name: 'feishu-url',
+                description: 'Feishu document URL used as requirement source',
                 takesValue: true,
             },
             {

package/dist/core/configurators/slash/auggie.js

@@ -14,7 +14,7 @@ argument-hint: feature description or request
 ---`,
     design: `---
 description: 在 proposal 之前独立生成技术设计请求文档。
-argument-hint: dashen-page-id or description
+argument-hint: feishu-url or description
 ---`,
     apply: `---
 description: 实施已批准的 ZhuanSpec 变更并保持任务同步。

package/dist/core/configurators/slash/costrict.js

@@ -14,7 +14,7 @@ argument-hint: feature description or request
 ---`,
     design: `---
 description: "在 proposal 之前独立生成技术设计请求文档。"
-argument-hint: dashen-page-id or description
+argument-hint: feishu-url or description
 ---`,
     apply: `---
 description: "实施已批准的 ZhuanSpec 变更并保持任务同步。"

package/dist/core/configurators/slash/factory.js

@@ -14,7 +14,7 @@ argument-hint: request or feature description
 ---`,
     design: `---
 description: 在 proposal 之前独立生成技术设计请求文档。
-argument-hint: dashen-page-id or description
+argument-hint: feishu-url or description
 ---`,
     apply: `---
 description: 实施已批准的 ZhuanSpec 变更并保持任务同步。

package/dist/core/hooks/init.js

@@ -200,8 +200,7 @@ async function runInitHook(_options) {
     const versionBanner = await checkVersionUpdate();
     // Build system message — intentionally minimal. Only the version banner
     // and active-change phase line are surfaced. Per-phase guidance lives in
-    // the corresponding Skill / slash-command template (e.g. zhuanspec-apply
-    // carries the subagent spawn authorization).
+    // the corresponding Skill / slash-command template.
     let systemMessage = '';
     if (versionBanner) {
         systemMessage += `${versionBanner}\n`;
@@ -220,7 +219,7 @@ async function runInitHook(_options) {
                 systemMessage += ` (run /zhuanspec:proposal to continue)`;
             }
             else if (phase === 'apply') {
-                systemMessage += ` (run zhuanspec-apply skill to execute Waves)`;
+                systemMessage += ` (run zhuanspec-apply to implement pending tasks)`;
             }
             systemMessage += `\n`;
         }

package/dist/core/hooks/post-apply.d.ts

@@ -3,7 +3,7 @@
  *
  * Actions after Apply phase completes:
  * 1. Reverse Sync deviation detection
- * 2. Report status (user manually triggers review in a new session)
+ * 2. Report status (user manually triggers review when ready)
  */
 interface PostApplyOptions {
     json?: boolean;
@@ -16,14 +16,17 @@ interface HookOutput {
         reviewTriggered?: boolean;
         deviationDetected?: boolean;
         deviationFiles?: string[];
+        featureOmissionDetected?: boolean;
+        uncoveredFeatures?: string[];
+        missingScenarios?: string[];
+        partialScenarios?: string[];
     };
 }
 export declare function postApplyHook(options: PostApplyOptions): Promise<void>;
 /**
  * Execute post-apply actions: deviation detection only.
- * Auto review trigger has been removed to ensure Stop hook fires correctly
- * and apply phaseBaseline is properly marked.
- * Users should manually run `zhuanspec review <change-id>` in a new session.
+ * Auto review trigger has been removed so apply stays focused on implementation.
+ * Users should manually run `zhuanspec review <change-id>` when they want full validation.
  */
 export declare function executePostApply(changeDir: string, repoRoot: string): Promise<HookOutput>;
 export {};

package/dist/core/hooks/post-apply.js

@@ -3,11 +3,12 @@
  *
  * Actions after Apply phase completes:
  * 1. Reverse Sync deviation detection
- * 2. Report status (user manually triggers review in a new session)
+ * 2. Report status (user manually triggers review when ready)
  */
 import path from 'path';
 import { FileSystemUtils } from '../../utils/file-system.js';
 import { GitRepoDetector } from '../../utils/git-repo-detector.js';
+import { promises as fs } from 'fs';
 import { getBeijingTime, atomicWriteJson, recoverProgressJsonForWrite, } from './record-progress.js';
 import { ensureAccuracySnapshot } from '../metrics/code-accuracy.js';
 import { detectHookHost, sanitizeCodexEnvelope } from '../../utils/hook-host.js';
@@ -39,11 +40,36 @@ async function runPostApplyHook(changeId) {
 }
 /**
  * Execute post-apply actions: deviation detection only.
- * Auto review trigger has been removed to ensure Stop hook fires correctly
- * and apply phaseBaseline is properly marked.
- * Users should manually run `zhuanspec review <change-id>` in a new session.
+ * Auto review trigger has been removed so apply stays focused on implementation.
+ * Users should manually run `zhuanspec review <change-id>` when they want full validation.
  */
 export async function executePostApply(changeDir, repoRoot) {
+    // 0. Feature-omission gate（功能点遗漏闸口）：检测「范围内但未实现」的 Scenario/功能点
+    //    对应问题：PRD 已有功能点被静默漏实现，Review 未拦住。此处提前拦截，afterAction=pause。
+    const omissionResult = await detectFeatureOmission(changeDir);
+    if (omissionResult.detected) {
+        const parts = [];
+        if (omissionResult.uncoveredFeatures.length > 0) {
+            parts.push(`功能点遗漏 ${omissionResult.uncoveredFeatures.length} 个: ${omissionResult.uncoveredFeatures.join(', ')}`);
+        }
+        if (omissionResult.missingScenarios.length > 0) {
+            parts.push(`未实现 Scenario ${omissionResult.missingScenarios.length} 个`);
+        }
+        if (omissionResult.partialScenarios.length > 0) {
+            parts.push(`疑似未实现(partial) Scenario ${omissionResult.partialScenarios.length} 个`);
+        }
+        return {
+            continue: false,
+            systemMessage: `Post-apply BLOCKED: 检测到范围内功能点/Scenario 未落地（${parts.join('；')}）。请补齐缺失的代码实现（禁止改删 spec/技术方案/PRD），再重新进入 Review。`,
+            hookSpecificOutput: {
+                reviewTriggered: false,
+                featureOmissionDetected: true,
+                uncoveredFeatures: omissionResult.uncoveredFeatures,
+                missingScenarios: omissionResult.missingScenarios,
+                partialScenarios: omissionResult.partialScenarios,
+            },
+        };
+    }
     // 1. Reverse Sync deviation detection
     const deviationResult = await detectDeviation(changeDir, repoRoot);
     // 2. Report deviation status (no auto review trigger)
@@ -57,7 +83,7 @@ export async function executePostApply(changeDir, repoRoot) {
         }
         return {
             continue: true,
-            systemMessage: 'Post-apply: No deviation detected. Please run `zhuanspec review` in a new session to enter Review phase.',
+            systemMessage: 'Post-apply: No deviation detected. Please run `zhuanspec review` when you are ready to validate the change.',
             hookSpecificOutput: {
                 reviewTriggered: false,
                 deviationDetected: false,
@@ -75,6 +101,49 @@ export async function executePostApply(changeDir, repoRoot) {
         },
     };
 }
+/**
+ * 功能点遗漏检测：读取 apply 阶段 spec-code 一致性报告，识别「范围内但未实现」的遗漏。
+ *
+ * 数据来源优先级：
+ *   1. review/spec-consistency-result.json（consistency-check Skill 产出，含 uncoveredScenarios/partialScenarios/featureTrace）
+ *   2. 若报告不存在 → 视为未检测（detected=false），不阻断（交由 review 阶段兜底）
+ *
+ * 判定为遗漏（detected=true）的条件（任一命中）：
+ *   - featureTrace.uncoveredFeatures 非空（技术方案功能点 F 无落地 Scenario）
+ *   - uncoveredScenarios 中存在 status=missing 的项
+ *   - partialScenarios 非空（仅命中辅助关键词，疑似未实现）
+ */
+async function detectFeatureOmission(changeDir) {
+    const empty = {
+        detected: false,
+        uncoveredFeatures: [],
+        missingScenarios: [],
+        partialScenarios: [],
+    };
+    const reportPath = path.join(changeDir, 'review', 'spec-consistency-result.json');
+    let report;
+    try {
+        const raw = await fs.readFile(reportPath, 'utf-8');
+        report = JSON.parse(raw);
+    }
+    catch {
+        // 报告不存在或解析失败 → 不阻断，交由 review 阶段兜底
+        return empty;
+    }
+    const uncoveredFeatures = Array.isArray(report.featureTrace?.uncoveredFeatures)
+        ? report.featureTrace.uncoveredFeatures.filter((f) => typeof f === 'string')
+        : [];
+    const missingScenarios = Array.isArray(report.uncoveredScenarios)
+        ? report.uncoveredScenarios
+            .filter(s => s?.status === 'missing')
+            .map(s => s.scenario || '(未命名 Scenario)')
+        : [];
+    const partialScenarios = Array.isArray(report.partialScenarios)
+        ? report.partialScenarios.map(s => s?.scenario || '(未命名 Scenario)')
+        : [];
+    const detected = uncoveredFeatures.length > 0 || missingScenarios.length > 0 || partialScenarios.length > 0;
+    return { detected, uncoveredFeatures, missingScenarios, partialScenarios };
+}
 /**
  * Detect deviation by comparing proposal scope with actual git diff
  */

package/dist/core/hooks/review-hooks.d.ts

@@ -81,6 +81,25 @@ interface SpecConsistencyOutput {
         scenarioId: string;
         description: string;
     }>;
+    /**
+     * 仅命中辅助关键词（类名/表名）、未命中核心关键词的疑似未实现项。
+     * 非空视为未通过——必须澄清为 covered 或补齐代码，禁止改删 spec。
+     */
+    partialScenarios?: Array<{
+        scenario?: string;
+        sourceFeature?: string;
+        matchedKeyword?: string;
+        warning?: string;
+    }>;
+    /**
+     * 功能点 F 编号全链核对结果（以 feature-manifest.json 的 F 编号为分母）。
+     * uncoveredFeatures 非空 = 技术方案功能点无落地 Scenario，属功能点遗漏。
+     */
+    featureTrace?: {
+        totalFeatures?: number;
+        coveredFeatures?: number;
+        uncoveredFeatures?: string[];
+    };
     mapping: Array<{
         requirementId: string;
         scenarioId: string;

package/dist/core/hooks/review-hooks.js

@@ -261,9 +261,17 @@ export async function specConsistencyResultCheck(changeId, skillOutput) {
         };
     }
     const loopCount = output.loopCount || 0;
-    // Check consistency coverage
+    // Check consistency coverage —— 三类缺口任一命中即视为未通过（层4 终检）：
+    //   1. missing：核心与辅助关键词均未命中的 Scenario
+    //   2. partial：仅命中辅助关键词（类名/表名）的疑似未实现项
+    //   3. uncoveredFeatures：feature-manifest 中无落地 Scenario 的功能点 F
+    const partialScenarios = output.partialScenarios || [];
+    const uncoveredFeatures = output.featureTrace?.uncoveredFeatures || [];
     const hasUncovered = output.uncoveredScenarios.length > 0;
-    if (hasUncovered) {
+    const hasPartial = partialScenarios.length > 0;
+    const hasUncoveredFeatures = uncoveredFeatures.length > 0;
+    const hasGap = hasUncovered || hasPartial || hasUncoveredFeatures;
+    if (hasGap) {
         if (loopCount > MAX_LOOP_COUNT) {
             return {
                 pass: false,
@@ -273,6 +281,8 @@ export async function specConsistencyResultCheck(changeId, skillOutput) {
                     consistencyRate: output.consistencyRate,
                     totalScenarios: output.totalScenarios,
                     coveredScenarios: output.coveredScenarios,
+                    partialScenarios,
+                    uncoveredFeatures,
                     loopExceeded: true,
                 },
                 nextAction: 'stop',
@@ -286,12 +296,14 @@ export async function specConsistencyResultCheck(changeId, skillOutput) {
             metrics: {
                 consistencyRate: output.consistencyRate,
                 uncoveredScenarios: output.uncoveredScenarios,
+                partialScenarios,
+                uncoveredFeatures,
             },
             nextAction: 'fix',
             fixPrompt: formatConsistencyFixPrompt(output, loopCount),
         };
     }
-    // PASS: All scenarios covered
+    // PASS: All scenarios covered, no partial, no uncovered features
     return {
         pass: true,
         needFix: false,
@@ -301,6 +313,7 @@ export async function specConsistencyResultCheck(changeId, skillOutput) {
             totalRequirements: output.totalRequirements,
             totalScenarios: output.totalScenarios,
             coveredScenarios: output.coveredScenarios,
+            featureTrace: output.featureTrace,
             mapping: output.mapping,
         },
         nextAction: 'continue',
@@ -709,20 +722,33 @@ function formatMissingUnitTestEvidencePrompt(loopCount) {
 `;
 }
 function formatConsistencyFixPrompt(output, loopCount) {
-    const uncoveredList = output.uncoveredScenarios.map(s => `- ${s.requirementId}/${s.scenarioId}: ${s.description}`).join('\n');
+    const uncoveredList = output.uncoveredScenarios.map(s => `- [missing] ${s.requirementId}/${s.scenarioId}: ${s.description}`).join('\n');
+    const partialScenarios = output.partialScenarios || [];
+    const partialList = partialScenarios.map(s => `- [partial] ${s.scenario || '(未命名)'}${s.sourceFeature ? ` [${s.sourceFeature}]` : ''}: ${s.warning || '仅命中辅助关键词，疑似未实现'}`).join('\n');
+    const uncoveredFeatures = output.featureTrace?.uncoveredFeatures || [];
+    const featureList = uncoveredFeatures.map(f => `- [feature] ${f}: 该功能点无落地 Scenario，属功能点遗漏`).join('\n');
+    const sections = [];
+    if (output.uncoveredScenarios.length > 0) {
+        sections.push(`未覆盖 Scenario（${output.uncoveredScenarios.length} 个）：\n${uncoveredList}`);
+    }
+    if (partialScenarios.length > 0) {
+        sections.push(`疑似未实现 partial（${partialScenarios.length} 个，仅命中类名/表名等辅助关键词）：\n${partialList}`);
+    }
+    if (uncoveredFeatures.length > 0) {
+        sections.push(`遗漏功能点 F（${uncoveredFeatures.length} 个，feature-manifest 有、无落地 Scenario）：\n${featureList}`);
+    }
     return `
 🔄 Spec-Code Consistency Fix Loop (${loopCount}/${MAX_LOOP_COUNT})
 
-发现 ${output.uncoveredScenarios.length} 个未覆盖的 Scenario：
-
-${uncoveredList}
+${sections.join('\n\n')}
 
 ⚠️ 铁律：Spec is Truth — 文档与代码冲突时，错的一定是代码。
-🚫 禁止修改 Spec 文件内容（包括 Requirement 名称、Scenario 描述、Given/When/Then 条件）。
+🚫 绝对禁止为凑覆盖率修改 Spec 文件 / 技术方案 / feature-manifest（包括 Requirement 名称、Scenario 描述、Given/When/Then 条件、[F<n>] 标记）。
 
 请通过以下方式修复：
-1. 补充或修改代码实现，使其满足上述 Scenario 描述的业务诉求
-2. 修复后重新运行 spec-code-consistency 检查验证覆盖情况
+1. 对 missing/partial 项：补齐或修改**代码实现**，使其满足 Scenario 描述的业务诉求（partial 项须命中方法名/接口路径/组件名等核心关键词并通过深度检查）
+2. 对遗漏功能点 F：补齐对应代码实现（而非补 PRD/技术方案）；确因范围裁剪不做的，登记 proposal.md 功能点覆盖对照表并注明理由
+3. 修复后重新运行 spec-code-consistency 检查验证覆盖情况
 `;
 }
 // ============================================================
@@ -797,6 +823,8 @@ ${legacySection}
 | Requirements 数量 | ${results.specConsistency.metrics.totalRequirements || 0} |
 | Scenario 数量 | ${results.specConsistency.metrics.totalScenarios || 0} |
 | 一致性覆盖率 | ${results.specConsistency.metrics.consistencyRate || 0}% |
+| 疑似未实现 partial 数 | ${results.specConsistency.metrics.partialScenarios?.length || 0} |
+| 遗漏功能点 F | ${results.specConsistency.metrics.uncoveredFeatures?.join(', ') || '—'} |
 | 循环次数 | ${results.specConsistency.loopCount} |
 | 状态 | ${results.specConsistency.pass ? '✅ PASS' : '❌ FAIL'} |
 

package/dist/core/hooks/summarize.js

@@ -89,8 +89,7 @@ async function runSummarize() {
         }
     }
     // Deviation detection only (no auto review trigger).
-    // Apply 完成后不再自动触发 review，确保 Stop hook 正确闪断以标记 apply baseline。
-    // 用户需在新会话中手动执行 `zhuanspec review <change-id>` 进入 review 阶段。
+    // Apply 完成后不再自动触发 review；用户准备验收时再手动执行 `zhuanspec review <change-id>`。
     let deviationDetected = false;
     if (phase === 'apply' && allTasksComplete) {
         // Execute post-apply hook to detect deviations only

package/dist/core/task-graph/execution-planner.js

@@ -71,6 +71,7 @@ export function generateExecutionPlan(tasks, options) {
     // Create graph and validate
     const graph = new TaskGraph(incompleteTasks);
     const validation = graph.validate();
+    const taskById = new Map(incompleteTasks.map(task => [task.id, task]));
     // Check for cycles
     if (validation.errors.some(e => e.includes('Circular dependency'))) {
         return {
@@ -95,7 +96,7 @@ export function generateExecutionPlan(tasks, options) {
     // Initialize
     for (const task of incompleteTasks) {
         // Only count dependencies that exist in incomplete tasks
-        const validDeps = task.depends.filter(d => incompleteTasks.some(t => t.id === d));
+        const validDeps = task.depends.filter(d => taskById.has(d));
         inDegree.set(task.id, validDeps.length);
         dependents.set(task.id, []);
     }
@@ -120,7 +121,7 @@ export function generateExecutionPlan(tasks, options) {
             break;
         }
         const readyTasks = readyIds
-            .map(id => incompleteTasks.find(t => t.id === id))
+            .map(id => taskById.get(id))
             .filter(Boolean);
         waves.push({
             wave: waveNumber,