@localsummer/incspec 0.0.6 → 0.0.8

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>` 直接跳过分析步骤，快速进入后续工作流。
 
 ## 快速开始
@@ -100,12 +146,12 @@ AI 编程助手在处理复杂前端代码库时常常力不从心，因为 API
 <details>
 <summary><strong>原生斜杠命令</strong>（点击展开）</summary>
 
-运行 `incspec cursor-sync` 后，这些工具可使用内置的 incspec 命令。
+运行 `incspec sync` 后，这些工具可使用内置的 incspec 命令。
 
 | 工具 | 命令 |
 |------|------|
 | **Cursor** | `/incspec/inc-analyze`、`/incspec/inc-collect-req`、`/incspec/inc-collect-dep`、`/incspec/inc-design`、`/incspec/inc-apply`、`/incspec/inc-merge`、`/incspec/inc-archive` |
-| **Claude Code** | 使用 AGENTS.md 工作流指令 |
+| **Claude Code** | 使用 `inc-spec-skill` Skill |
 
 </details>
 
@@ -159,16 +205,20 @@ incspec init
 - 生成包含工作流指令的 `AGENTS.md`
 - 在 `incspec/project.md` 中设置项目配置
 
-#### 步骤 3：同步 Cursor 命令（可选）
+#### 步骤 3：同步 IDE 集成（可选）
 
-如果使用 Cursor IDE：
+同步到 Cursor 或 Claude Code：
 ```bash
-incspec cursor-sync
+incspec sync              # 交互式选择
+incspec sync --cursor     # 仅 Cursor
+incspec sync --claude     # 仅 Claude Code
+incspec sync --all        # 全部
 ```
 
 **设置完成后：**
 - 运行 `incspec status` 验证设置
 - Cursor 用户可直接触发 `/incspec/inc-*` 命令
+- Claude Code 用户可使用 `inc-spec-skill` Skill
 
 ### 创建你的第一个增量
 
@@ -193,6 +243,14 @@ $ incspec status                              # 检查当前工作流状态
 $ incspec analyze src/views/Home --complete   # 标记步骤 1 完成
 ```
 
+**启动快速模式** (5步流程):
+
+适用于 Bug 修复或简单功能变更：
+```bash
+$ incspec analyze src/views/Home --quick      # 启动快速模式工作流
+```
+快速模式跳过步骤 3 (UI依赖采集) 和步骤 4 (增量设计)，直接从需求进入代码应用。
+
 **使用现有基准报告** (跳过分析):
 
 如果已有基准报告文件，可直接使用，跳过分析步骤：
@@ -271,7 +329,7 @@ AI：我将增量合并到新基线。
 
 ### 7. 归档已完成的工作
 
-完成 6 步工作流后，使用归档命令保存本轮产出：
+完成步骤 1-6 后，使用归档命令保存本轮产出：
 
 ```text
 你：归档本轮工作流产出
@@ -300,7 +358,7 @@ $ incspec archive -y    # 归档所有工作流产出，跳过确认
 
 在以下情况下执行归档：
 
-1. **6 步工作流全部完成** - 代码已应用，新基线已生成
+1. **步骤 1-6 全部完成** - 代码已应用，新基线已生成
 2. **功能已验证通过** - 确认变更符合预期
 3. **准备开始下一轮迭代** - 需要清空当前工作区
 
@@ -348,7 +406,7 @@ incspec/
 
 ```
 ┌────────────────────┐
-│ 6 步工作流完成     │
+│ 步骤 1-6 完成       │
 │ 新基线已生成       │
 └────────┬───────────┘
          │
@@ -437,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  # 使用现有基准(自动从归档恢复)
 
@@ -446,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>
@@ -501,7 +562,7 @@ incspec archive -y             # 跳过确认提示
 | `status` | `st` | 状态 |
 | `list` | `ls` | 列表 |
 | `validate` | `v` | 验证 |
-| `cursor-sync` | `cs` | 同步 |
+| `sync` | `s` | 同步 |
 | `update` | `up` | 更新 |
 | `help` | `h` | 帮助 |
 
@@ -513,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));
@@ -207,9 +223,9 @@ export async function analyzeCommand(ctx) {
   print('');
   print(colorize(`  /incspec/inc-analyze ${sourcePath} --module=${moduleName}`, colors.bold, colors.white));
   print('');
-  print(colorize('或使用 Claude Code 命令:', colors.cyan));
+  print(colorize('或在 Claude Code 中使用 inc-spec-skill 技能:', colors.cyan));
   print('');
-  print(colorize(`  /ai-increment:analyze-codeflow ${sourcePath} ${path.join(projectRoot, INCSPEC_DIR, DIRS.baselines)}`, colors.bold, colors.white));
+  print(colorize(`  请分析 ${sourcePath} 的代码流程，生成基线报告到 ${path.join(projectRoot, INCSPEC_DIR, DIRS.baselines)}`, colors.dim));
   print('');
   printInfo(`完成后运行 'incspec status' 查看进度`);
   print('');

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 命令:', colors.cyan));
-  print('');
-  print(colorize(`  /ai-increment:apply-increment-code ${incrementPath} ${path.join(projectRoot, sourceDir)}`, colors.bold, colors.white));
-  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-dep.mjs

@@ -62,9 +62,9 @@ export async function collectDepCommand(ctx) {
   print('');
   print(colorize(`  /incspec/inc-collect-dep`, colors.bold, colors.white));
   print('');
-  print(colorize('或使用 Claude Code 命令:', colors.cyan));
+  print(colorize('或在 Claude Code 中使用 inc-spec-skill 技能:', colors.cyan));
   print('');
-  print(colorize(`  /ai-increment:ui-dependency-collection ${path.join(projectRoot, INCSPEC_DIR, DIRS.requirements)}`, colors.bold, colors.white));
+  print(colorize(`  请收集 UI 依赖，生成依赖报告到 ${path.join(projectRoot, INCSPEC_DIR, DIRS.requirements)}`, colors.dim));
   print('');
   print(colorize('该命令将交互式采集 6 维度 UI 依赖:', colors.dim));
   print(colorize('  - UI组件库 (Arco/Antd)', colors.dim));

package/commands/collect-req.mjs

@@ -12,6 +12,7 @@ import {
   readWorkflow,
   updateStep,
   STATUS,
+  isQuickMode,
 } from '../lib/workflow.mjs';
 import {
   colors,
@@ -62,9 +63,9 @@ export async function collectReqCommand(ctx) {
   print('');
   print(colorize(`  /incspec/inc-collect-req`, colors.bold, colors.white));
   print('');
-  print(colorize('或使用 Claude Code 命令:', colors.cyan));
+  print(colorize('或在 Claude Code 中使用 inc-spec-skill 技能:', colors.cyan));
   print('');
-  print(colorize(`  /ai-increment:structured-requirements-collection ${path.join(projectRoot, INCSPEC_DIR, DIRS.requirements)}`, colors.bold, colors.white));
+  print(colorize(`  请收集需求，生成结构化需求表格到 ${path.join(projectRoot, INCSPEC_DIR, DIRS.requirements)}`, colors.dim));
   print('');
   print(colorize('该命令将交互式收集需求，生成 5 列结构化表格:', colors.dim));
   print(colorize('  | 新增/修改功能 | 涉及UI组件 | 触发条件 | 影响的核心状态 | 预期数据流向 |', colors.dim));
@@ -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/design.mjs

@@ -102,13 +102,13 @@ export async function designCommand(ctx) {
   print('');
   print(colorize(`  /incspec/inc-design --feature=${featureName}`, colors.bold, colors.white));
   print('');
-  print(colorize('或使用 Claude Code 命令:', colors.cyan));
+  print(colorize('或在 Claude Code 中使用 inc-spec-skill 技能:', colors.cyan));
   print('');
   const baselinePath = path.join(projectRoot, INCSPEC_DIR, DIRS.baselines, latestBaseline);
   const reqPath = path.join(projectRoot, INCSPEC_DIR, DIRS.requirements, 'structured-requirements.md');
   const depPath = path.join(projectRoot, INCSPEC_DIR, DIRS.requirements, 'ui-dependencies.md');
   const outDir = path.join(projectRoot, INCSPEC_DIR, DIRS.increments);
-  print(colorize(`  /ai-increment:analyze-increment-codeflow ${baselinePath} ${reqPath} ${depPath} ${outDir}`, colors.bold, colors.white));
+  print(colorize(`  请基于基线 ${latestBaseline} 和需求/依赖文件，设计增量方案到 ${outDir}`, colors.dim));
   print('');
   print(colorize('该命令将生成包含 7 大模块的增量设计蓝图:', colors.dim));
   print(colorize('  1. 一句话摘要', colors.dim));

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,19 +111,27 @@ const COMMANDS = {
   archive: {
     usage: 'incspec archive [file-path] [--workflow] [-k|--keep] [-y|--yes]',
     aliases: ['ar'],
-    description: '归档规范文件 (默认归档当前工作流产出)',
+    description: '步骤7: 归档工作流产出 (或指定文件)',
     options: [
       ['--workflow', '归档当前工作流全部产出文件'],
       ['-k, --keep', '复制而非移动'],
       ['-y, --yes', '跳过确认提示'],
     ],
   },
-  'cursor-sync': {
-    usage: 'incspec cursor-sync [--project|--global]',
-    aliases: ['cs'],
-    description: '同步 Cursor slash commands',
+  reset: {
+    usage: 'incspec reset',
+    aliases: ['rs'],
+    description: '重置当前工作流，归档已有产出',
+  },
+  sync: {
+    usage: 'incspec sync [--cursor] [--claude] [--all] [--project|--global]',
+    aliases: ['s'],
+    description: '同步集成到 IDE/AI 工具 (Cursor, Claude Code)',
     options: [
-      ['--project', '同步到项目目录'],
+      ['--cursor', '仅同步 Cursor 命令'],
+      ['--claude', '仅同步 Claude Code Skill'],
+      ['--all', '同步所有目标'],
+      ['--project', '同步到当前目录'],
       ['--global', '同步到全局目录'],
     ],
   },
@@ -158,7 +167,7 @@ export async function helpCommand(ctx = {}) {
  * Show general help
  */
 function showGeneralHelp() {
-  print(colorize('  incspec - 增量规范驱动开发工具', colors.bold, colors.cyan));
+  print(colorize('  IncSpec - 增量规范驱动开发工具', colors.bold, colors.cyan));
   print(colorize('  ────────────────────────────', colors.dim));
   print('');
   print(colorize('用法:', colors.bold));
@@ -167,7 +176,7 @@ function showGeneralHelp() {
 
   print(colorize('工作流命令:', colors.bold));
   print('');
-  
+
   const workflowCommands = ['analyze', 'collect-req', 'collect-dep', 'design', 'apply', 'merge'];
   workflowCommands.forEach((cmd, index) => {
     const def = COMMANDS[cmd];
@@ -180,7 +189,7 @@ function showGeneralHelp() {
   print(colorize('管理命令:', colors.bold));
   print('');
 
-  const mgmtCommands = ['init', 'update', 'status', 'list', 'validate', 'archive', 'cursor-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) : '';
@@ -198,7 +207,7 @@ function showGeneralHelp() {
   print(colorize('  incspec update                  # 更新模板文件', colors.dim));
   print(colorize('  incspec analyze src/views/Home  # 分析代码流程', colors.dim));
   print(colorize('  incspec status                  # 查看工作流状态', colors.dim));
-  print(colorize('  incspec cursor-sync             # 同步 Cursor 命令', colors.dim));
+  print(colorize('  incspec sync                    # 同步 IDE 集成', colors.dim));
   print('');
   print(colorize(`运行 'incspec help <command>' 查看命令详情。`, colors.dim));
   print('');