@localsummer/incspec 0.0.7 → 0.0.9

package/README.md

@@ -12,7 +12,7 @@
 
 ![IncSpec 全局介绍](./assets/incspec.jpeg)
 
-IncSpec 通过**增量规范驱动开发**让人类与 AI 编程助手保持一致 - 这是一个 6+1 步工作流（6 步开发 + 归档），在修改代码前先捕获代码流程基线。**无需 API 密钥。**
+IncSpec 通过**增量规范驱动开发**让人类与 AI 编程助手保持一致 - 这是一个 7 步工作流，在修改代码前先捕获代码流程基线。**无需 API 密钥。**
 
 ## 为什么选择 IncSpec?
 
@@ -30,7 +30,7 @@ AI 编程助手在处理复杂前端代码库时常常力不从心，因为 API
 ## IncSpec 对比一览
 
 - **前端专注**：专为 API 数据流程分析和组件依赖设计。
-- **6+1 步循环**：分析 → 收集需求 → 收集依赖 → 设计 → 应用 → 合并 → 归档。
+- **7 步循环**：分析 → 收集需求 → 收集依赖 → 设计 → 应用 → 合并 → 归档。
 - **基线管理**：每个循环产出新基线，作为下一轮迭代的起点。
 - **与 OpenSpec 对比**：OpenSpec 擅长 0→1 功能规范。incspec 擅长理解和修改现有前端代码库（1→n），特别是 API 流程和状态管理复杂的场景。
 
@@ -38,6 +38,10 @@ AI 编程助手在处理复杂前端代码库时常常力不从心，因为 API
 
 ## 工作原理
 
+### 完整模式 (7步)
+
+适用于复杂功能开发，需要完整的 UI 依赖分析和增量设计。
+
 ```
 ┌────────────────────┐
 │ 1. 分析            │  分析现有代码流程
@@ -91,6 +95,48 @@ AI 编程助手在处理复杂前端代码库时常常力不从心，因为 API
               └───────────┘
 ```
 
+### 快速模式 (5步)
+
+适用于 Bug 修复、简单功能、不涉及复杂 UI 依赖的变更。
+
+```
+┌────────────────────┐
+│ 1. 分析            │  分析现有代码流程
+│    代码流程        │  生成基线快照
+└────────┬───────────┘
+         │
+         ▼
+┌────────────────────┐
+│ 2. 收集            │  捕获结构化需求
+│    需求            │  5 列表格格式
+└────────┬───────────┘
+         │
+         │  (跳过步骤 3 UI依赖采集)
+         │  (跳过步骤 4 增量设计)
+         │
+         ▼
+┌────────────────────┐
+│ 5. 应用            │  基于需求文档
+│    变更            │  直接实现代码变更
+└────────┬───────────┘
+         │
+         ▼
+┌────────────────────┐
+│ 6. 合并            │  重新分析代码
+│    到基线          │  生成新基线
+└────────┬───────────┘
+         │
+         ▼
+┌────────────────────┐
+│ 7. 归档            │  归档本轮产出
+│    产出            │  清空工作区
+└────────────────────┘
+```
+
+**模式选择建议:**
+- **完整模式**: 复杂 UI 功能、多组件交互、需要详细设计审查
+- **快速模式**: Bug 修复、简单功能、不涉及 UI 依赖变更
+
 > **提示**: 如果已有基准报告，可使用 `incspec analyze --baseline=<file>` 直接跳过分析步骤，快速进入后续工作流。
 
 ## 快速开始
@@ -197,6 +243,14 @@ $ incspec status                              # 检查当前工作流状态
 $ incspec analyze src/views/Home --complete   # 标记步骤 1 完成
 ```
 
+**启动快速模式** (5步流程):
+
+适用于 Bug 修复或简单功能变更：
+```bash
+$ incspec analyze src/views/Home --quick      # 启动快速模式工作流
+```
+快速模式跳过步骤 3 (UI依赖采集) 和步骤 4 (增量设计)，直接从需求进入代码应用。
+
 **使用现有基准报告** (跳过分析):
 
 如果已有基准报告文件，可直接使用，跳过分析步骤：
@@ -275,7 +329,7 @@ AI：我将增量合并到新基线。
 
 ### 7. 归档已完成的工作
 
-完成 6 步工作流后，使用归档命令保存本轮产出：
+完成步骤 1-6 后，使用归档命令保存本轮产出：
 
 ```text
 你：归档本轮工作流产出
@@ -304,7 +358,7 @@ $ incspec archive -y    # 归档所有工作流产出，跳过确认
 
 在以下情况下执行归档：
 
-1. **6 步工作流全部完成** - 代码已应用，新基线已生成
+1. **步骤 1-6 全部完成** - 代码已应用，新基线已生成
 2. **功能已验证通过** - 确认变更符合预期
 3. **准备开始下一轮迭代** - 需要清空当前工作区
 
@@ -352,7 +406,7 @@ incspec/
 
 ```
 ┌────────────────────┐
-│ 6 步工作流完成     │
+│ 步骤 1-6 完成       │
 │ 新基线已生成       │
 └────────┬───────────┘
          │
@@ -441,8 +495,9 @@ incspec help <command>    # 显示特定命令帮助
 
 ```bash
 # 步骤 1：分析代码流程
-incspec analyze <source-path> [--module=name]   # 别名：a
+incspec analyze <source-path> [--module=name] [--quick]  # 别名：a
 incspec a src/views/Home --module=home
+incspec analyze src/views/Home --quick                   # 启动快速模式
 incspec analyze src/views/Home --complete -o baselines/home-baseline-v1.md
 incspec analyze --baseline=home-baseline-v1.md  # 使用现有基准(自动从归档恢复)
 
@@ -450,21 +505,23 @@ incspec analyze --baseline=home-baseline-v1.md  # 使用现有基准(自动从
 incspec collect-req                             # 别名：cr
 incspec cr --complete
 
-# 步骤 3：收集 UI 依赖
+# 步骤 3：收集 UI 依赖（快速模式跳过）
 incspec collect-dep                             # 别名：cd
 incspec cd --complete
 
-# 步骤 4：生成增量设计
+# 步骤 4：生成增量设计（快速模式跳过）
 incspec design [--feature=name]                 # 别名：d
 incspec d --feature=user-auth --complete -o increments/auth-increment-v1.md
 
 # 步骤 5：应用代码变更
 incspec apply [increment-path]                  # 别名：ap
 incspec ap --source-dir=src/ --complete
+# 快速模式下自动使用 requirements/structured-requirements.md 作为输入
 
 # 步骤 6：合并到基线
 incspec merge [increment-path]                  # 别名：m
 incspec m --complete -o baselines/home-baseline-v2.md
+# 快速模式下重新分析代码生成新基线
 ```
 
 </details>
@@ -517,7 +574,7 @@ incspec archive -y             # 跳过确认提示
 
 | 特性 | incspec | OpenSpec |
 |------|---------|----------|
-| 工作流 | 6+1 步增量循环（含归档） | 3 阶段（proposal → apply → archive） |
+| 工作流 | 7 步增量循环 | 3 阶段（proposal → apply → archive） |
 | 侧重点 | 前端 API 流程分析 | 通用功能规范 |
 | 编号系统 | S/D/N/C/R 多层编号 | 单一编号 |
 | 代码生成 | 集成应用步骤 | 需手动编码 |

package/commands/analyze.mjs

@@ -14,6 +14,7 @@ import {
   startWorkflow,
   updateStep,
   STATUS,
+  MODE,
   getStepInfo,
   isWorkflowIncomplete,
   getWorkflowProgress,
@@ -123,10 +124,12 @@ export async function analyzeCommand(ctx) {
 
     // Handle workflow state
     let workflow = readWorkflow(projectRoot);
+    const isQuick = options.quick || options.q;
     if (!workflow?.currentWorkflow) {
       const workflowName = typeof options.workflow === 'string' ? options.workflow : `analyze-${moduleName}`;
-      workflow = startWorkflow(projectRoot, workflowName);
-      printSuccess(`已创建新工作流: ${workflowName}`);
+      workflow = startWorkflow(projectRoot, workflowName, { mode: isQuick ? MODE.QUICK : MODE.FULL });
+      const modeLabel = isQuick ? '(快速模式: 5步)' : '';
+      printSuccess(`已创建新工作流: ${workflowName} ${modeLabel}`);
     }
 
     // Mark step as completed
@@ -151,15 +154,18 @@ export async function analyzeCommand(ctx) {
 
   // Get workflow state
   let workflow = readWorkflow(projectRoot);
+  const isQuick = options.quick || options.q;
 
   // Check if starting new workflow
   if (!workflow?.currentWorkflow) {
     let workflowName = typeof options.workflow === 'string' ? options.workflow : '';
     if (!workflowName) {
-      workflowName = await prompt('请输入工作流名称', `analyze-${moduleName}`);
+      const modeHint = isQuick ? '(快速模式)' : '';
+      workflowName = await prompt(`请输入工作流名称 ${modeHint}`, `analyze-${moduleName}`);
     }
-    workflow = startWorkflow(projectRoot, workflowName);
-    printSuccess(`已创建新工作流: ${workflowName}`);
+    workflow = startWorkflow(projectRoot, workflowName, { mode: isQuick ? MODE.QUICK : MODE.FULL });
+    const modeLabel = isQuick ? '(快速模式: 5步)' : '';
+    printSuccess(`已创建新工作流: ${workflowName} ${modeLabel}`);
   } else if (isWorkflowIncomplete(workflow)) {
     // Current workflow is incomplete, ask for confirmation
     const progress = getWorkflowProgress(workflow);
@@ -167,19 +173,21 @@ export async function analyzeCommand(ctx) {
     printWarning(`当前工作流 "${workflow.currentWorkflow}" 未完成 (${progress.completed}/${progress.total})`);
     print(colorize(`  最后完成步骤: ${progress.lastCompletedStep || '无'}`, colors.dim));
     print('');
-    
+
     const shouldArchive = await confirm('是否归档当前工作流并开始新工作流?');
-    
+
     if (!shouldArchive) {
       printInfo('已取消。继续当前工作流。');
       print('');
     } else {
       let workflowName = typeof options.workflow === 'string' ? options.workflow : '';
       if (!workflowName) {
-        workflowName = await prompt('请输入新工作流名称', `analyze-${moduleName}`);
+        const modeHint = isQuick ? '(快速模式)' : '';
+        workflowName = await prompt(`请输入新工作流名称 ${modeHint}`, `analyze-${moduleName}`);
       }
-      workflow = startWorkflow(projectRoot, workflowName);
-      printSuccess(`已归档旧工作流，创建新工作流: ${workflowName}`);
+      workflow = startWorkflow(projectRoot, workflowName, { mode: isQuick ? MODE.QUICK : MODE.FULL });
+      const modeLabel = isQuick ? '(快速模式: 5步)' : '';
+      printSuccess(`已归档旧工作流，创建新工作流: ${workflowName} ${modeLabel}`);
     }
   }
 
@@ -192,6 +200,14 @@ export async function analyzeCommand(ctx) {
   print(colorize('步骤 1: 代码流程分析', colors.bold, colors.cyan));
   print(colorize('─────────────────────', colors.dim));
   print('');
+
+  // Show quick mode info
+  if (isQuick) {
+    print(colorize('快速模式流程: 分析 -> 需求收集 -> 应用代码 -> 合并基线', colors.yellow));
+    print(colorize('(跳过 UI依赖采集 和 增量设计)', colors.dim));
+    print('');
+  }
+
   print(colorize('配置:', colors.bold));
   print(colorize(`  源代码路径: ${sourcePath}`, colors.dim));
   print(colorize(`  模块名称: ${moduleName}`, colors.dim));

package/commands/apply.mjs

@@ -3,6 +3,7 @@
  */
 
 import * as path from 'path';
+import * as fs from 'fs';
 import {
   ensureInitialized,
   INCSPEC_DIR,
@@ -13,6 +14,7 @@ import {
   readWorkflow,
   updateStep,
   STATUS,
+  isQuickMode,
 } from '../lib/workflow.mjs';
 import { listSpecs } from '../lib/spec.mjs';
 import {
@@ -45,24 +47,7 @@ export async function applyCommand(ctx) {
     return;
   }
 
-  // Get increment file
-  let incrementPath = args[0];
-  if (!incrementPath) {
-    const increments = listSpecs(projectRoot, 'increments');
-    if (increments.length > 0) {
-      const featureName = workflow.currentWorkflow.replace(/^analyze-/, '');
-      const matched = increments.find(spec => spec.name.startsWith(`${featureName}-increment-`));
-      if (matched) {
-        incrementPath = matched.path;
-      } else {
-        incrementPath = increments[0].path;
-        printWarning(`未找到与当前工作流匹配的增量文件，已使用最近文件: ${increments[0].name}`);
-      }
-    } else {
-      printWarning('未找到增量设计文件。请先运行步骤 4 (design)。');
-      return;
-    }
-  }
+  const quickMode = isQuickMode(workflow);
 
   // Get source directory
   const config = readProjectConfig(projectRoot);
@@ -70,12 +55,52 @@ export async function applyCommand(ctx) {
     ? options['source-dir']
     : (config?.source_dir || 'src');
 
+  // Determine input based on mode
+  let inputPath;
+  let inputType;
+
+  if (quickMode) {
+    // Quick mode: use requirements document
+    const reqFile = path.join(projectRoot, INCSPEC_DIR, DIRS.requirements, 'structured-requirements.md');
+    if (!fs.existsSync(reqFile)) {
+      printWarning('未找到需求文件。请先运行步骤 2 (collect-req)。');
+      return;
+    }
+    inputPath = path.join(INCSPEC_DIR, DIRS.requirements, 'structured-requirements.md');
+    inputType = 'requirements';
+  } else {
+    // Full mode: use increment design file
+    let incrementPath = args[0];
+    if (!incrementPath) {
+      const increments = listSpecs(projectRoot, 'increments');
+      if (increments.length > 0) {
+        const featureName = workflow.currentWorkflow.replace(/^analyze-/, '');
+        const matched = increments.find(spec => spec.name.startsWith(`${featureName}-increment-`));
+        if (matched) {
+          incrementPath = matched.path;
+        } else {
+          incrementPath = increments[0].path;
+          printWarning(`未找到与当前工作流匹配的增量文件，已使用最近文件: ${increments[0].name}`);
+        }
+      } else {
+        printWarning('未找到增量设计文件。请先运行步骤 4 (design)。');
+        return;
+      }
+    }
+    inputPath = incrementPath;
+    inputType = 'increment';
+  }
+
   print('');
   print(colorize('步骤 5: 应用代码变更', colors.bold, colors.cyan));
+  if (quickMode) {
+    print(colorize('(快速模式 - 基于需求文档)', colors.yellow));
+  }
   print(colorize('────────────────────', colors.dim));
   print('');
   print(colorize(`当前工作流: ${workflow.currentWorkflow}`, colors.dim));
-  print(colorize(`增量设计文件: ${incrementPath}`, colors.dim));
+  print(colorize(`输入文件: ${inputPath}`, colors.dim));
+  print(colorize(`输入类型: ${inputType === 'requirements' ? '结构化需求' : '增量设计'}`, colors.dim));
   print(colorize(`源代码目录: ${sourceDir}`, colors.dim));
   print('');
 
@@ -84,21 +109,41 @@ export async function applyCommand(ctx) {
 
   print(colorize('使用说明:', colors.bold));
   print('');
-  print(colorize('请在 Cursor 中运行以下命令:', colors.cyan));
-  print('');
-  print(colorize(`  /incspec/inc-apply ${incrementPath}`, colors.bold, colors.white));
-  print('');
-  print(colorize('或在 Claude Code 中使用 inc-spec-skill 技能:', colors.cyan));
-  print('');
-  print(colorize(`  请按照 ${incrementPath} 的增量设计，应用代码变更到 ${path.join(projectRoot, sourceDir)}`, colors.dim));
-  print('');
-  print(colorize('该命令将:', colors.dim));
-  print(colorize('  1. 解析增量设计文件中的变更计划', colors.dim));
-  print(colorize('  2. 按依赖顺序排序变更', colors.dim));
-  print(colorize('  3. 执行代码新建/修改/删除', colors.dim));
-  print(colorize('  4. 输出变更摘要', colors.dim));
+
+  if (quickMode) {
+    // Quick mode instructions
+    print(colorize('快速模式下，请直接根据需求文档实现代码变更:', colors.cyan));
+    print('');
+    print(colorize('在 Cursor 中:', colors.dim));
+    print(colorize(`  /incspec/inc-apply ${inputPath}`, colors.bold, colors.white));
+    print('');
+    print(colorize('在 Claude Code 中:', colors.dim));
+    print(colorize(`  请根据 ${inputPath} 中的需求描述，直接实现代码变更`, colors.dim));
+    print('');
+    print(colorize('该命令将:', colors.dim));
+    print(colorize('  1. 解析需求文档中的功能描述', colors.dim));
+    print(colorize('  2. 基于现有基线分析影响范围', colors.dim));
+    print(colorize('  3. 直接执行代码新建/修改/删除', colors.dim));
+    print(colorize('  4. 输出变更摘要', colors.dim));
+  } else {
+    // Full mode instructions
+    print(colorize('请在 Cursor 中运行以下命令:', colors.cyan));
+    print('');
+    print(colorize(`  /incspec/inc-apply ${inputPath}`, colors.bold, colors.white));
+    print('');
+    print(colorize('或在 Claude Code 中使用 inc-spec-skill 技能:', colors.cyan));
+    print('');
+    print(colorize(`  请按照 ${inputPath} 的增量设计，应用代码变更到 ${path.join(projectRoot, sourceDir)}`, colors.dim));
+    print('');
+    print(colorize('该命令将:', colors.dim));
+    print(colorize('  1. 解析增量设计文件中的变更计划', colors.dim));
+    print(colorize('  2. 按依赖顺序排序变更', colors.dim));
+    print(colorize('  3. 执行代码新建/修改/删除', colors.dim));
+    print(colorize('  4. 输出变更摘要', colors.dim));
+  }
+
   print('');
-  printWarning('请在执行前仔细审查增量设计文件!');
+  printWarning('请在执行前仔细审查输入文件!');
   print('');
   printInfo(`完成后运行 'incspec status' 查看进度`);
   print('');

package/commands/archive.mjs

@@ -10,7 +10,7 @@ import {
   DIRS,
 } from '../lib/config.mjs';
 import { archiveSpec, getSpecInfo } from '../lib/spec.mjs';
-import { archiveWorkflow, readWorkflow, STATUS } from '../lib/workflow.mjs';
+import { archiveWorkflow, readWorkflow, updateStep, STATUS, isQuickMode, MODE } from '../lib/workflow.mjs';
 import {
   colors,
   colorize,
@@ -21,7 +21,24 @@ import {
   confirm,
 } from '../lib/terminal.mjs';
 
-const ARCHIVABLE_STEP_INDEXES = [0, 1, 2, 3, 5];
+// Full mode: archivable steps are 1, 2, 3, 4, 6 (0-based: 0, 1, 2, 3, 5)
+// Note: Step 5 (apply) has no file output, Step 7 (archive) is this command itself
+const FULL_MODE_ARCHIVABLE_INDEXES = [0, 1, 2, 3, 5];
+// Quick mode: archivable steps are 1, 2, 6 (0-based: 0, 1, 5)
+// Note: Steps 3, 4 are skipped in quick mode
+const QUICK_MODE_ARCHIVABLE_INDEXES = [0, 1, 5];
+
+/**
+ * Get archivable step indexes based on workflow mode
+ * @param {Object} workflow
+ * @returns {number[]}
+ */
+function getArchivableStepIndexes(workflow) {
+  if (isQuickMode(workflow)) {
+    return QUICK_MODE_ARCHIVABLE_INDEXES;
+  }
+  return FULL_MODE_ARCHIVABLE_INDEXES;
+}
 
 function escapeRegExp(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
@@ -114,8 +131,10 @@ function getArchivableOutputs(workflow) {
     return null;
   }
 
+  const archivableIndexes = getArchivableStepIndexes(workflow);
   const outputs = [];
-  for (const index of ARCHIVABLE_STEP_INDEXES) {
+
+  for (const index of archivableIndexes) {
     const step = workflow.steps[index];
     if (!step || step.status !== STATUS.COMPLETED || !step.output || step.output === '-') {
       return null;
@@ -260,6 +279,9 @@ export async function archiveCommand(ctx) {
         printSuccess(`文件已${keepOriginal ? '复制' : '移动'}到: ${archivePath}`);
       }
 
+      // Mark step 7 as completed
+      updateStep(projectRoot, 7, STATUS.COMPLETED);
+
       const refreshed = readWorkflow(projectRoot);
       if (refreshed?.currentWorkflow && shouldArchiveWorkflow(projectRoot, refreshed)) {
         const workflowName = refreshed.currentWorkflow;

package/commands/collect-req.mjs

@@ -12,6 +12,7 @@ import {
   readWorkflow,
   updateStep,
   STATUS,
+  isQuickMode,
 } from '../lib/workflow.mjs';
 import {
   colors,
@@ -76,5 +77,12 @@ export async function collectReqCommand(ctx) {
   if (options.complete) {
     updateStep(projectRoot, STEP_NUMBER, STATUS.COMPLETED, OUTPUT_FILE);
     printSuccess(`步骤 2 已标记为完成: ${OUTPUT_FILE}`);
+
+    // Quick mode hint
+    if (isQuickMode(workflow)) {
+      print('');
+      printInfo('快速模式: 跳过步骤 3、4，直接进入步骤 5');
+      print(colorize("  运行 'incspec apply' 继续", colors.cyan));
+    }
   }
 }

package/commands/help.mjs

@@ -34,12 +34,13 @@ const COMMANDS = {
     description: '显示当前工作流状态',
   },
   analyze: {
-    usage: 'incspec analyze <source-path> [--module=name] [--baseline=file]',
+    usage: 'incspec analyze <source-path> [--module=name] [--quick] [--baseline=file]',
     aliases: ['a'],
     description: '步骤1: 分析代码流程，生成基线快照',
     options: [
       ['-m, --module=<name>', '指定模块名称'],
       ['-w, --workflow=<name>', '指定工作流名称(避免交互提示)'],
+      ['-q, --quick', '启动快速模式(5步流程: 分析->需求->应用->合并->归档)'],
       ['-b, --baseline=<file>', '使用现有基准报告(自动从归档恢复)'],
       ['--complete', '标记步骤完成'],
       ['-o, --output=<file>', '完成时指定输出文件'],
@@ -110,13 +111,18 @@ const COMMANDS = {
   archive: {
     usage: 'incspec archive [file-path] [--workflow] [-k|--keep] [-y|--yes]',
     aliases: ['ar'],
-    description: '归档规范文件 (默认归档当前工作流产出)',
+    description: '步骤7: 归档工作流产出 (或指定文件)',
     options: [
       ['--workflow', '归档当前工作流全部产出文件'],
       ['-k, --keep', '复制而非移动'],
       ['-y, --yes', '跳过确认提示'],
     ],
   },
+  reset: {
+    usage: 'incspec reset',
+    aliases: ['rs'],
+    description: '重置当前工作流，归档已有产出',
+  },
   sync: {
     usage: 'incspec sync [--cursor] [--claude] [--all] [--project|--global]',
     aliases: ['s'],
@@ -183,7 +189,7 @@ function showGeneralHelp() {
   print(colorize('管理命令:', colors.bold));
   print('');
 
-  const mgmtCommands = ['init', 'update', 'status', 'list', 'validate', 'archive', 'sync', 'help'];
+  const mgmtCommands = ['init', 'update', 'status', 'list', 'validate', 'archive', 'reset', 'sync', 'help'];
   mgmtCommands.forEach(cmd => {
     const def = COMMANDS[cmd];
     const aliases = def.aliases ? colorize(` (${def.aliases.join(', ')})`, colors.dim) : '';

package/commands/merge.mjs

@@ -12,6 +12,7 @@ import {
   readWorkflow,
   updateStep,
   STATUS,
+  isQuickMode,
 } from '../lib/workflow.mjs';
 import { listSpecs, getNextVersion } from '../lib/spec.mjs';
 import {
@@ -43,24 +44,7 @@ export async function mergeCommand(ctx) {
     return;
   }
 
-  // Get increment file
-  let incrementPath = args[0];
-  if (!incrementPath) {
-    const increments = listSpecs(projectRoot, 'increments');
-    if (increments.length > 0) {
-      const featureName = workflow.currentWorkflow.replace(/^analyze-/, '');
-      const matched = increments.find(spec => spec.name.startsWith(`${featureName}-increment-`));
-      if (matched) {
-        incrementPath = matched.path;
-      } else {
-        incrementPath = increments[0].path;
-        printWarning(`未找到与当前工作流匹配的增量文件，已使用最近文件: ${increments[0].name}`);
-      }
-    } else {
-      printWarning('未找到增量设计文件。请先运行步骤 4 (design)。');
-      return;
-    }
-  }
+  const quickMode = isQuickMode(workflow);
 
   // Calculate output file
   const moduleName = workflow.currentWorkflow.replace(/^analyze-/, '');
@@ -70,12 +54,39 @@ export async function mergeCommand(ctx) {
   const outputFile = outputOverride || defaultOutputFile;
   const outputPath = path.join(INCSPEC_DIR, DIRS.baselines, outputFile);
 
+  // Get increment file (only needed for full mode)
+  let incrementPath = null;
+  if (!quickMode) {
+    incrementPath = args[0];
+    if (!incrementPath) {
+      const increments = listSpecs(projectRoot, 'increments');
+      if (increments.length > 0) {
+        const featureName = workflow.currentWorkflow.replace(/^analyze-/, '');
+        const matched = increments.find(spec => spec.name.startsWith(`${featureName}-increment-`));
+        if (matched) {
+          incrementPath = matched.path;
+        } else {
+          incrementPath = increments[0].path;
+          printWarning(`未找到与当前工作流匹配的增量文件，已使用最近文件: ${increments[0].name}`);
+        }
+      } else {
+        printWarning('未找到增量设计文件。请先运行步骤 4 (design)。');
+        return;
+      }
+    }
+  }
+
   print('');
   print(colorize('步骤 6: 合并到基线', colors.bold, colors.cyan));
+  if (quickMode) {
+    print(colorize('(快速模式 - 重新分析生成新基线)', colors.yellow));
+  }
   print(colorize('─────────────────', colors.dim));
   print('');
   print(colorize(`当前工作流: ${workflow.currentWorkflow}`, colors.dim));
-  print(colorize(`增量设计文件: ${incrementPath}`, colors.dim));
+  if (!quickMode) {
+    print(colorize(`增量设计文件: ${incrementPath}`, colors.dim));
+  }
   print(colorize(`输出基线文件: ${outputPath}`, colors.dim));
   print('');
 
@@ -84,20 +95,40 @@ export async function mergeCommand(ctx) {
 
   print(colorize('使用说明:', colors.bold));
   print('');
-  print(colorize('请在 Cursor 中运行以下命令:', colors.cyan));
-  print('');
-  print(colorize(`  /incspec/inc-merge ${incrementPath}`, colors.bold, colors.white));
-  print('');
-  print(colorize('或在 Claude Code 中使用 inc-spec-skill 技能:', colors.cyan));
-  print('');
-  const outDir = path.join(projectRoot, INCSPEC_DIR, DIRS.baselines);
-  print(colorize(`  请将 ${incrementPath} 的增量合并到基线 ${outDir}`, colors.dim));
-  print('');
-  print(colorize('该命令将:', colors.dim));
-  print(colorize('  1. 解析增量设计文件中的时序图和依赖图', colors.dim));
-  print(colorize('  2. 清理增量标记 (🆕/✏️/❌)', colors.dim));
-  print(colorize('  3. 重新编号为 S1-Sxx, D1-Dxx', colors.dim));
-  print(colorize('  4. 生成新的基线快照', colors.dim));
+
+  if (quickMode) {
+    // Quick mode instructions
+    print(colorize('快速模式下，将重新分析当前代码生成新基线:', colors.cyan));
+    print('');
+    print(colorize('在 Cursor 中:', colors.dim));
+    print(colorize(`  /incspec/inc-merge --output=${outputFile}`, colors.bold, colors.white));
+    print('');
+    print(colorize('在 Claude Code 中:', colors.dim));
+    print(colorize(`  请分析当前代码状态，生成新的基线报告到 ${outputPath}`, colors.dim));
+    print('');
+    print(colorize('该命令将:', colors.dim));
+    print(colorize('  1. 分析当前代码的完整流程', colors.dim));
+    print(colorize('  2. 生成 API 调用时序图', colors.dim));
+    print(colorize('  3. 生成依赖关系图', colors.dim));
+    print(colorize('  4. 保存为新版本基线快照', colors.dim));
+  } else {
+    // Full mode instructions
+    print(colorize('请在 Cursor 中运行以下命令:', colors.cyan));
+    print('');
+    print(colorize(`  /incspec/inc-merge ${incrementPath}`, colors.bold, colors.white));
+    print('');
+    print(colorize('或在 Claude Code 中使用 inc-spec-skill 技能:', colors.cyan));
+    print('');
+    const outDir = path.join(projectRoot, INCSPEC_DIR, DIRS.baselines);
+    print(colorize(`  请将 ${incrementPath} 的增量合并到基线 ${outDir}`, colors.dim));
+    print('');
+    print(colorize('该命令将:', colors.dim));
+    print(colorize('  1. 解析增量设计文件中的时序图和依赖图', colors.dim));
+    print(colorize('  2. 清理增量标记', colors.dim));
+    print(colorize('  3. 重新编号为 S1-Sxx, D1-Dxx', colors.dim));
+    print(colorize('  4. 生成新的基线快照', colors.dim));
+  }
+
   print('');
   print(colorize('新基线将作为下一轮增量开发的起点。', colors.dim));
   print('');