@localsummer/incspec 0.0.6 → 0.0.8

package/lib/workflow.mjs

@@ -8,6 +8,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import { INCSPEC_DIR, FILES, getTemplatesDir } from './config.mjs';
+import { formatLocalDateTime } from './terminal.mjs';
 
 /** Workflow steps definition */
 export const STEPS = [
@@ -17,6 +18,7 @@ export const STEPS = [
   { id: 4, name: 'design-increment', label: '增量设计', command: 'design' },
   { id: 5, name: 'apply-code', label: '应用代码变更', command: 'apply' },
   { id: 6, name: 'merge-baseline', label: '合并到基线', command: 'merge' },
+  { id: 7, name: 'archive-workflow', label: '归档工作流产出', command: 'archive' },
 ];
 
 /** Step status */
@@ -24,8 +26,21 @@ export const STATUS = {
   PENDING: 'pending',
   IN_PROGRESS: 'in_progress',
   COMPLETED: 'completed',
+  SKIPPED: 'skipped',
 };
 
+/** Workflow mode */
+export const MODE = {
+  FULL: 'full',
+  QUICK: 'quick',
+};
+
+/** Quick mode valid steps (1-based) */
+export const QUICK_MODE_STEPS = [1, 2, 5, 6, 7];
+
+/** Quick mode skipped steps (1-based) */
+export const QUICK_MODE_SKIPPED = [3, 4];
+
 function normalizeOutputName(outputFile) {
   if (!outputFile || typeof outputFile !== 'string') {
     return outputFile;
@@ -116,6 +131,7 @@ export function parseWorkflow(content) {
   const workflow = {
     currentWorkflow: null,
     currentStep: null,
+    mode: MODE.FULL,
     startTime: null,
     lastUpdate: null,
     steps: [],
@@ -136,6 +152,13 @@ export function parseWorkflow(content) {
     workflow.currentStep = parseInt(stepMatch[1], 10);
   }
 
+  // Parse mode field
+  const modeMatch = content.match(/\*\*工作流模式\*\*:\s*(.+)/);
+  if (modeMatch) {
+    const modeValue = modeMatch[1].trim().toLowerCase();
+    workflow.mode = modeValue === 'quick' ? MODE.QUICK : MODE.FULL;
+  }
+
   const startMatch = content.match(/\*\*开始时间\*\*:\s*(.+)/);
   if (startMatch) {
     workflow.startTime = startMatch[1].trim();
@@ -211,13 +234,15 @@ export function readWorkflow(projectRoot) {
  * @returns {string}
  */
 export function generateWorkflowContent(workflow) {
-  const now = new Date().toISOString().replace('T', ' ').slice(0, 16);
+  const now = formatLocalDateTime(new Date());
+  const mode = workflow.mode || MODE.FULL;
 
   const lines = [
     '# Workflow Status',
     '',
     `**当前工作流**: ${workflow.currentWorkflow || '-'}`,
     `**当前步骤**: ${workflow.currentStep || '-'}`,
+    `**工作流模式**: ${mode}`,
     `**开始时间**: ${workflow.startTime || '-'}`,
     `**最后更新**: ${now}`,
     '',
@@ -271,10 +296,11 @@ export function initWorkflow(projectRoot) {
   const workflowPath = getWorkflowPath(projectRoot);
   const content = generateInitialWorkflowContent();
   fs.writeFileSync(workflowPath, content, 'utf-8');
-  
+
   return {
     currentWorkflow: null,
     currentStep: null,
+    mode: MODE.FULL,
     startTime: null,
     lastUpdate: null,
     steps: STEPS.map(() => ({
@@ -292,14 +318,14 @@ export function initWorkflow(projectRoot) {
  */
 function generateInitialWorkflowContent() {
   const templatePath = path.join(getTemplatesDir(), 'WORKFLOW.md');
-  const now = new Date().toISOString().replace('T', ' ').slice(0, 16);
-  
+  const now = formatLocalDateTime(new Date());
+
   if (fs.existsSync(templatePath)) {
     let content = fs.readFileSync(templatePath, 'utf-8');
     content = content.replace(/\{\{last_update\}\}/g, now);
     return content;
   }
-  
+
   // Fallback to generated content
   const workflow = {
     currentWorkflow: null,
@@ -313,7 +339,7 @@ function generateInitialWorkflowContent() {
     })),
     history: [],
   };
-  
+
   return generateWorkflowContent(workflow);
 }
 
@@ -321,10 +347,12 @@ function generateInitialWorkflowContent() {
  * Start a new workflow
  * @param {string} projectRoot
  * @param {string} workflowName
+ * @param {Object} options - { mode: 'full' | 'quick' }
  * @returns {Object}
  */
-export function startWorkflow(projectRoot, workflowName) {
-  const now = new Date().toISOString().replace('T', ' ').slice(0, 16);
+export function startWorkflow(projectRoot, workflowName, options = {}) {
+  const now = formatLocalDateTime(new Date());
+  const mode = options.mode || MODE.FULL;
   let workflow = readWorkflow(projectRoot);
 
   if (!workflow) {
@@ -335,12 +363,12 @@ export function startWorkflow(projectRoot, workflowName) {
   if (workflow.currentWorkflow) {
     const progress = getWorkflowProgress(workflow);
     const isComplete = progress.completed === progress.total;
-    
+
     // Format: "workflowName (completed/total)" for incomplete, just name for complete
-    const historyName = isComplete 
-      ? workflow.currentWorkflow 
+    const historyName = isComplete
+      ? workflow.currentWorkflow
       : `${workflow.currentWorkflow} (${progress.completed}/${progress.total})`;
-    
+
     workflow.history.unshift({
       name: historyName,
       status: isComplete ? 'completed' : 'incomplete',
@@ -352,12 +380,24 @@ export function startWorkflow(projectRoot, workflowName) {
   // Start new workflow
   workflow.currentWorkflow = workflowName;
   workflow.currentStep = 1;
+  workflow.mode = mode;
   workflow.startTime = now;
-  workflow.steps = STEPS.map(() => ({
-    status: STATUS.PENDING,
-    output: null,
-    completedAt: null,
-  }));
+
+  // Initialize steps - mark skipped steps in quick mode
+  workflow.steps = STEPS.map((step) => {
+    if (mode === MODE.QUICK && QUICK_MODE_SKIPPED.includes(step.id)) {
+      return {
+        status: STATUS.SKIPPED,
+        output: null,
+        completedAt: now,
+      };
+    }
+    return {
+      status: STATUS.PENDING,
+      output: null,
+      completedAt: null,
+    };
+  });
 
   writeWorkflow(projectRoot, workflow);
   return workflow;
@@ -381,8 +421,9 @@ export function updateStep(projectRoot, stepNumber, status, outputFile = null) {
     throw new Error(`无效的步骤编号: ${stepNumber}`);
   }
 
-  const now = new Date().toISOString().replace('T', ' ').slice(0, 16);
+  const now = formatLocalDateTime(new Date());
   const normalizedOutput = normalizeOutputName(outputFile);
+  const mode = workflow.mode || MODE.FULL;
 
   workflow.steps[index] = {
     status,
@@ -390,11 +431,15 @@ export function updateStep(projectRoot, stepNumber, status, outputFile = null) {
     completedAt: status === STATUS.COMPLETED ? now : null,
   };
 
-  // Update current step
+  // Update current step based on mode
   if (status === STATUS.IN_PROGRESS) {
     workflow.currentStep = stepNumber;
-  } else if (status === STATUS.COMPLETED && stepNumber < STEPS.length) {
-    workflow.currentStep = stepNumber + 1;
+  } else if (status === STATUS.COMPLETED) {
+    const nextStep = getNextStep(stepNumber, mode);
+    if (nextStep) {
+      workflow.currentStep = nextStep;
+    }
+    // nextStep is null means workflow is complete
   }
 
   writeWorkflow(projectRoot, workflow);
@@ -411,7 +456,7 @@ export function completeWorkflow(projectRoot) {
     throw new Error('工作流未初始化');
   }
 
-  const now = new Date().toISOString().replace('T', ' ').slice(0, 16);
+  const now = formatLocalDateTime(new Date());
 
   // Add to history
   workflow.history.unshift({
@@ -440,7 +485,7 @@ export function archiveWorkflow(projectRoot) {
     throw new Error('工作流未初始化');
   }
 
-  const now = new Date().toISOString().replace('T', ' ').slice(0, 16);
+  const now = formatLocalDateTime(new Date());
 
   workflow.history.unshift({
     name: workflow.currentWorkflow,
@@ -483,27 +528,39 @@ export function getStepByCommand(command) {
 /**
  * Calculate workflow completion progress
  * @param {Object} workflow
- * @returns {{completed: number, total: number, lastCompletedStep: number|null}}
+ * @returns {{completed: number, total: number, lastCompletedStep: number|null, mode: string}}
  */
 export function getWorkflowProgress(workflow) {
   if (!workflow || !workflow.steps) {
-    return { completed: 0, total: STEPS.length, lastCompletedStep: null };
+    return { completed: 0, total: STEPS.length, lastCompletedStep: null, mode: MODE.FULL };
   }
 
+  const mode = workflow.mode || MODE.FULL;
   let completed = 0;
   let lastCompletedStep = null;
 
   workflow.steps.forEach((step, index) => {
+    const stepNumber = index + 1;
+
+    // Skip counting skipped steps in quick mode
+    if (mode === MODE.QUICK && QUICK_MODE_SKIPPED.includes(stepNumber)) {
+      return;
+    }
+
     if (step && step.status === STATUS.COMPLETED) {
       completed++;
-      lastCompletedStep = index + 1;
+      lastCompletedStep = stepNumber;
     }
   });
 
+  // Quick mode has 5 steps (1,2,5,6,7), full mode has 7 steps
+  const total = mode === MODE.QUICK ? QUICK_MODE_STEPS.length : STEPS.length;
+
   return {
     completed,
-    total: STEPS.length,
+    total,
     lastCompletedStep,
+    mode,
   };
 }
 
@@ -533,7 +590,7 @@ export function isWorkflowIncomplete(workflow) {
  */
 export function addToHistory(projectRoot, entry) {
   let workflow = readWorkflow(projectRoot);
-  
+
   if (!workflow) {
     workflow = {
       currentWorkflow: null,
@@ -549,7 +606,7 @@ export function addToHistory(projectRoot, entry) {
     };
   }
 
-  const now = new Date().toISOString().replace('T', ' ').slice(0, 16);
+  const now = formatLocalDateTime(new Date());
 
   workflow.history.unshift({
     name: entry.name,
@@ -561,3 +618,40 @@ export function addToHistory(projectRoot, entry) {
   writeWorkflow(projectRoot, workflow);
   return workflow;
 }
+
+/**
+ * Check if workflow is in quick mode
+ * @param {Object} workflow
+ * @returns {boolean}
+ */
+export function isQuickMode(workflow) {
+  return workflow?.mode === MODE.QUICK;
+}
+
+/**
+ * Get next valid step based on mode
+ * @param {number} currentStep - Current step number (1-based)
+ * @param {string} mode - Workflow mode
+ * @returns {number|null} - Next step number or null if complete
+ */
+export function getNextStep(currentStep, mode) {
+  if (mode === MODE.QUICK) {
+    const currentIndex = QUICK_MODE_STEPS.indexOf(currentStep);
+    if (currentIndex >= 0 && currentIndex < QUICK_MODE_STEPS.length - 1) {
+      return QUICK_MODE_STEPS[currentIndex + 1];
+    }
+    return null; // Workflow complete
+  }
+  // Full mode
+  return currentStep < STEPS.length ? currentStep + 1 : null;
+}
+
+/**
+ * Check if a step should be skipped based on mode
+ * @param {number} stepNumber - Step number (1-based)
+ * @param {string} mode - Workflow mode
+ * @returns {boolean}
+ */
+export function shouldSkipStep(stepNumber, mode) {
+  return mode === MODE.QUICK && QUICK_MODE_SKIPPED.includes(stepNumber);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@localsummer/incspec",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "面向 AI 编程助手的增量规范驱动开发工具",
   "bin": {
     "incspec": "index.mjs"

package/templates/AGENTS.md

@@ -4,48 +4,69 @@ AI 编码助手使用 IncSpec 进行增量规格驱动开发的操作指南。
 
 ## 快速检查清单
 
+**完整模式 (7步):**
 - 初始化项目: `incspec init` (创建 `incspec/` 目录结构)
 - 检查状态: `incspec status` 或 `incspec st`
-- 按顺序执行6步工作流: analyze → collect-req → collect-dep → design → apply → merge
+- 按顺序执行7步工作流: analyze → collect-req → collect-dep → design → apply → merge -> archive
 - 使用编号引用: `[S1]` 表示时序步骤, `[D1]` 表示依赖, `[C1]` 表示变更
 - 标记增量: `[N1]` 新增, `[S1-Modified]` 修改, `[S1-Deleted]` 删除
 - 继续前先验证: `incspec validate --strict`
 - 合并后循环回到步骤1开始下一个增量周期
 
-## 六步工作流
+**快速模式 (5步):**
+- 启动快速模式: `incspec analyze <path> --quick`
+- 按顺序执行: analyze → collect-req → apply → merge -> archive
+- 跳过步骤 3 (UI依赖采集) 和步骤 4 (增量设计)
+- 适用于 Bug 修复、简单功能、不涉及复杂 UI 依赖的变更
+
+## 七步工作流
 
 ### 概览
 
 ```
-┌─────────────────────────────────────────────────────────────────────────┐
-│                      IncSpec 六步增量开发周期                            │
-├─────────────────────────────────────────────────────────────────────────┤
-│                                                                         │
-│   ┌──────────┐    ┌──────────┐    ┌──────────┐                         │
-│   │ 步骤 1   │    │ 步骤 2   │    │ 步骤 3   │                         │
-│   │ 分析     │───▶│ 收集     │───▶│ 收集     │                         │
-│   │ 代码流   │    │ 需求     │    │ UI依赖   │                         │
-│   └──────────┘    └──────────┘    └──────────┘                         │
-│        ▲                               │                                │
-│        │                               ▼                                │
-│   ┌──────────┐    ┌──────────┐    ┌──────────┐                         │
-│   │ 步骤 6   │    │ 步骤 5   │    │ 步骤 4   │                         │
-│   │ 合并到   │◀───│ 应用     │◀───│ 设计     │                         │
-│   │ 基线     │    │ 代码     │    │ 增量     │                         │
-│   └──────────┘    └──────────┘    └──────────┘                         │
-│        │                                                                │
-│        └──────────────── 循环回到步骤 1 ────────────────────────────▶  │
-│                                                                         │
-└─────────────────────────────────────────────────────────────────────────┘
+┌───────────────────────────────────────────────────────────────────────────────────┐
+│                            IncSpec 工作流模式                                      │
+├───────────────────────────────────────────────────────────────────────────────────┤
+│                                                                                   │
+│   完整模式 (7步):                                                                 │
+│                                                                                   │
+│   ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐                   │
+│   │ 步骤 1   │    │ 步骤 2   │    │ 步骤 3   │    │ 步骤 4   │                   │
+│   │ 分析     │───▶│ 收集     │───▶│ 收集     │───▶│ 设计     │                   │
+│   │ 代码流   │    │ 需求     │    │ UI依赖   │    │ 增量     │                   │
+│   └──────────┘    └──────────┘    └──────────┘    └──────────┘                   │
+│        ▲                                               │                          │
+│        │                                               ▼                          │
+│   ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐                   │
+│   │          │    │ 步骤 7   │    │ 步骤 6   │    │ 步骤 5   │                   │
+│   │  循环    │◀───│ 归档     │◀───│ 合并到   │◀───│ 应用     │                   │
+│   │          │    │ 产出     │    │ 基线     │    │ 代码     │                   │
+│   └──────────┘    └──────────┘    └──────────┘    └──────────┘                   │
+│                                                                                   │
+│   快速模式 (5步):                                                                 │
+│                                                                                   │
+│   ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐   │
+│   │ 步骤 1   │    │ 步骤 2   │    │ 步骤 5   │    │ 步骤 6   │    │ 步骤 7   │   │
+│   │ 分析     │───▶│ 收集     │───▶│ 应用     │───▶│ 合并到   │───▶│ 归档     │   │
+│   │ 代码流   │    │ 需求     │    │ 代码     │    │ 基线     │    │ 产出     │   │
+│   └──────────┘    └──────────┘    └──────────┘    └──────────┘    └──────────┘   │
+│   (跳过步骤 3 UI依赖采集 和 步骤 4 增量设计)                                      │
+│                                                                                   │
+└───────────────────────────────────────────────────────────────────────────────────┘
 ```
 
+**模式选择:**
+- **完整模式**: 复杂 UI 功能、多组件交互、需要详细设计审查
+- **快速模式**: Bug 修复、简单功能、不涉及 UI 依赖变更
+
 ### 步骤 1: 分析代码工作流
 
-**命令**: `incspec analyze <source-path> [--module=name] [--baseline=file]`
+**命令**: `incspec analyze <source-path> [--module=name] [--quick] [--baseline=file]`
 
 **目的**: 生成包含 API 调用时序图和依赖关系图的基线快照。
 
 **选项**:
+- `--quick`: 启动快速模式 (5步流程)
 - `--baseline=<file>`: 使用现有基准报告，自动从 baselines/ 或 archives/ 目录恢复
 
 **输出**: `incspec/baselines/{module}-baseline-v{n}.md`
@@ -186,6 +207,19 @@ graph TD
 
 **结果**: 新基线成为下一个增量周期的起点。
 
+### 步骤 7: 归档工作流产出
+
+**命令**: `incspec archive [--yes] [<file>] [--keep]`
+
+**目的**: 将已完成的工作流产出文件归档到历史记录目录。
+
+**处理流程**:
+1. 确定要归档的文件 (默认全部当前工作流产出)
+2. 创建归档目录: `incspec/archives/YYYY-MM/{module}/`
+3. 移动或复制文件到归档目录 (取决于 `--keep` 选项)
+4. 更新工作流状态以反映归档
+
+
 ## 任务前准备
 
 **上下文检查清单**:
@@ -199,7 +233,7 @@ graph TD
 - 始终从最新基线开始
 - 在开始新增量之前完成上一个增量
 - 使用 `incspec validate` 检查完整性
-- 严格按步骤顺序执行: 1 → 2 → 3 → 4 → 5 → 6
+- 严格按步骤顺序执行: 1 → 2 → 3 → 4 → 5 → 6 → 7
 
 ## 快速开始
 
@@ -217,13 +251,14 @@ incspec list baselines          # 仅列出基线
 incspec list -l                 # 长格式(含时间戳)
 incspec list -a                 # 包含归档
 
-# 6步工作流
-incspec analyze <path> [--module=name] [--baseline=file]  # 步骤1: 基线分析
+# 7步工作流
+incspec analyze <path> [--module=name] [--quick] [--baseline=file]  # 步骤1: 基线分析
 incspec collect-req / cr                  # 步骤2: 需求收集
-incspec collect-dep / cd                  # 步骤3: 依赖收集
-incspec design [--feature=name] / d       # 步骤4: 增量设计
+incspec collect-dep / cd                  # 步骤3: 依赖收集 (快速模式跳过)
+incspec design [--feature=name] / d       # 步骤4: 增量设计 (快速模式跳过)
 incspec apply [path] / ap                 # 步骤5: 代码执行
 incspec merge [path] / m                  # 步骤6: 基线合并
+incspec archive --yes                     # 步骤7: 归档产出
 
 # 验证与管理
 incspec validate / v            # 验证完整性
@@ -234,9 +269,12 @@ incspec archive <file>          # 归档指定文件
 incspec archive <file> --keep   # 复制而非移动
 
 # IDE 集成
-incspec cursor-sync             # 同步 Cursor 斜杠命令
-incspec cursor-sync --project   # 同步到项目目录
-incspec cursor-sync --global    # 同步到全局目录
+incspec sync                    # 交互式选择同步目标
+incspec sync --cursor           # 同步 Cursor 斜杠命令
+incspec sync --claude           # 同步 Claude Code Skill
+incspec sync --all              # 同步全部
+incspec sync --global           # 同步到全局目录
+incspec sync --project          # 同步到当前目录
 
 # 帮助
 incspec help [command]          # 显示帮助
@@ -245,7 +283,7 @@ incspec --version / -v          # 显示版本
 
 ### Cursor 斜杠命令
 
-运行 `incspec cursor-sync` 后,以下命令可用:
+运行 `incspec sync --cursor` 后,以下命令可用:
 
 | 命令 | 步骤 | 描述 |
 |------|------|------|
@@ -255,6 +293,7 @@ incspec --version / -v          # 显示版本
 | `/incspec/inc-design` | 4 | 设计增量蓝图 |
 | `/incspec/inc-apply` | 5 | 应用代码变更 |
 | `/incspec/inc-merge` | 6 | 合并到基线 |
+| `/incspec/inc-archive` | 7 | 归档工作流产出 |
 | `/incspec/inc-status` | - | 检查工作流状态 |
 | `/incspec/inc-help` | - | 显示帮助 |
 
@@ -481,7 +520,7 @@ updated: 2024-01-16T14:30:00Z
 
 ### 工作流纪律
 
-1. **不要跳过步骤** - 每个步骤都建立在前一步的基础上
+1. **不要跳过步骤** - 完整模式按1-7顺序执行，快速模式按1-2-5-6-7执行
 2. **一次一个增量** - 完成后再开始下一个
 3. **频繁验证** - 继续前运行 `incspec validate`
 4. **保持基线最新** - 实施成功后始终合并
@@ -585,13 +624,15 @@ incspec status
 incspec status              # 我在哪里?
 incspec list               # 有什么?
 incspec validate --strict  # 是否正确?
-incspec cursor-sync        # 设置IDE命令
+incspec sync               # 设置IDE命令
 ```
 
 ## 与AI助手集成
 
 ### 推荐工作流
 
+**完整模式 (7步):**
+
 1. **人类**: 提供高层需求
 2. **AI**: 运行步骤1 (analyze) 理解代码库
 3. **AI**: 运行步骤2 (collect-req) 并提出澄清问题
@@ -601,7 +642,19 @@ incspec cursor-sync        # 设置IDE命令
 7. **AI**: 运行步骤5 (apply) 生成代码
 8. **人类**: 测试并验证变更
 9. **AI**: 运行步骤6 (merge) 更新基线
-10. **循环**: 返回步骤1开始下一个增量
+10. **AI**: 运行步骤7 (archive) 归档产出
+11. **循环**: 返回步骤1开始下一个增量
+
+**快速模式 (5步):**
+
+1. **人类**: 提供简单需求 (Bug修复/小功能)
+2. **AI**: 运行步骤1 (analyze --quick) 理解代码库
+3. **AI**: 运行步骤2 (collect-req) 收集需求
+4. **AI**: 运行步骤5 (apply) 生成代码
+5. **人类**: 测试并验证变更
+6. **AI**: 运行步骤6 (merge) 更新基线
+7. **AI**: 运行步骤7 (archive) 归档产出
+8. **循环**: 返回步骤1开始下一个增量
 
 ### 核心原则
 
@@ -610,4 +663,4 @@ incspec cursor-sync        # 设置IDE命令
 - **可追溯** - 每个变更都关联到需求
 - **可逆转** - 基线提供回滚点
 
-记住: 基线是真相。增量是提案。通过6步周期保持它们同步。
+记住: 基线是真相。增量是提案。通过7步周期保持它们同步。

package/templates/INCSPEC_BLOCK.md

@@ -10,7 +10,7 @@
 - 请求含义模糊，需要先了解规范工作流再编码
 
 通过 `@/incspec/AGENTS.md` 可以了解：
-- 如何使用 6 步增量编码工作流
+- 如何使用 7 步增量编码工作流
 - 规范格式与约定
 - 项目结构与指南
 

package/templates/WORKFLOW.md

@@ -2,6 +2,7 @@
 
 **当前工作流**: -
 **当前步骤**: -
+**工作流模式**: full
 **开始时间**: -
 **最后更新**: {{last_update}}
 

package/templates/cursor-commands/analyze-codeflow.md

@@ -18,6 +18,17 @@ incspec analyze <source-path> --module=<module> --workflow=analyze-<module>
 incspec analyze <source-path> --module=<module> --workflow=analyze-<module> --complete --output=<output-file>
 ```
 
+**启动快速模式工作流** (5步流程):
+
+```bash
+incspec analyze <source-path> --module=<module> --quick
+```
+
+快速模式跳过步骤 3 (UI依赖采集) 和步骤 4 (增量设计)，直接从需求进入代码应用。适用于：
+- Bug 修复
+- 简单功能迭代
+- 不涉及复杂 UI 依赖变更的任务
+
 **使用现有基准报告** (跳过分析):
 
 若已有基准报告文件，可直接使用:
@@ -27,7 +38,7 @@ incspec analyze --baseline=<baseline-file> [--module=<module>] [--workflow=<work
 ```
 
 说明:
-- `<baseline-file>` 文件名，自动搜索 baselines/ 和 archives/ 目录
+- `<baseline-file>` 文件名，自动递归搜索 baselines/ 和 archives/ 目录
 - 若文件在归档目录，自动移动到 baselines/ 目录
 - `<module>` 默认从文件名推断 (xxx-baseline-vN.md -> xxx)
 - `<workflow>` 默认为 analyze-<module>