@localsummer/incspec 0.0.7 → 0.0.8

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            # 验证完整性
@@ -258,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` | - | 显示帮助 |
 
@@ -484,7 +520,7 @@ updated: 2024-01-16T14:30:00Z
 
 ### 工作流纪律
 
-1. **不要跳过步骤** - 每个步骤都建立在前一步的基础上
+1. **不要跳过步骤** - 完整模式按1-7顺序执行，快速模式按1-2-5-6-7执行
 2. **一次一个增量** - 完成后再开始下一个
 3. **频繁验证** - 继续前运行 `incspec validate`
 4. **保持基线最新** - 实施成功后始终合并
@@ -595,6 +631,8 @@ incspec sync               # 设置IDE命令
 
 ### 推荐工作流
 
+**完整模式 (7步):**
+
 1. **人类**: 提供高层需求
 2. **AI**: 运行步骤1 (analyze) 理解代码库
 3. **AI**: 运行步骤2 (collect-req) 并提出澄清问题
@@ -604,7 +642,19 @@ incspec 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开始下一个增量
 
 ### 核心原则
 
@@ -613,4 +663,4 @@ incspec 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>

package/templates/cursor-commands/apply-increment-code.md

@@ -6,6 +6,14 @@ allowed-tools: Read, Write, Edit, Bash, Grep, Glob
 
 ## CLI 同步 (自动)
 
+**检测工作流模式:**
+
+```bash
+incspec status
+```
+
+### 完整模式 (7步)
+
 开始执行前，先用 Bash 执行:
 
 ```bash
@@ -22,17 +30,45 @@ incspec apply <increment-report-path> [--source-dir=<source-code-dir>] --complet
 - 若未提供 `source-code-dir`，省略 `--source-dir`
 - 若提示没有活跃工作流，请先完成步骤 1-4
 
+### 快速模式 (5步)
+
+快速模式下，输入文件为需求文档（而非增量设计文件）：
+
+```bash
+incspec apply --complete
+```
+
+说明:
+- 输入文件自动使用 `incspec/requirements/structured-requirements.md`
+- 无需提供增量设计文件路径
+- 请先完成步骤 1-2
+
 # 角色定位
 
-你是前端增量代码执行器。基于《增量需求融合快照》报告,在 source-code-dir 中直接创建新文件和修改现有文件,完成增量需求的代码实施。
+你是前端增量代码执行器。根据工作流模式，基于不同的输入文件在 source-code-dir 中直接创建新文件和修改现有文件，完成增量需求的代码实施。
+
+## 模式说明
+
+- **完整模式**: 基于《增量需求融合快照》报告（步骤 4 产出）执行代码变更
+- **快速模式**: 基于《结构化需求报告》（步骤 2 产出）直接执行代码变更，跳过增量设计步骤
 
 # 输入参数
 
+## 完整模式
+
 1. **increment-report-path** (必填): `increment-codeflow-v2.md` 报告的完整路径
 2. **source-code-dir** (可选): 源代码根目录,默认为当前工作目录
 
+## 快速模式
+
+1. **requirements-path** (自动): 自动使用 `incspec/requirements/structured-requirements.md`
+2. **baseline-path** (自动): 自动使用步骤 1 生成的基线报告
+3. **source-code-dir** (可选): 源代码根目录,默认为当前工作目录
+
 # 执行流程
 
+> 以下为完整模式的执行流程。快速模式流程请参见 [快速模式执行流程](#快速模式执行流程) 部分。
+
 ## 步骤 1: 读取并解析报告
 
 读取 increment-report-path 指定的报告文件,提取以下关键信息:
@@ -390,3 +426,95 @@ old_string: `interface ListState {
    - Edit 工具修改: 在 JSX 中添加 BatchActions 组件
 
 执行完成后输出摘要。
+
+---
+
+# 快速模式执行流程
+
+快速模式下，无需解析增量设计报告的模块 3/4/5，直接基于需求文档和基线报告执行代码变更。
+
+## 输入文件
+
+1. **基线报告**: 步骤 1 生成的 `{module}-baseline-v{n}.md`（理解现有代码结构）
+2. **需求文档**: 步骤 2 生成的 `structured-requirements.md`（明确变更目标）
+
+## 执行步骤
+
+### 步骤 1: 读取输入文件
+
+1. **读取基线报告**: 从 `incspec/baselines/` 获取最新的基线快照
+   - 理解当前代码架构
+   - 识别现有 API 调用流程
+   - 识别现有依赖关系
+
+2. **读取需求文档**: 从 `incspec/requirements/structured-requirements.md` 获取结构化需求
+   - 提取 5 列结构化表格
+   - 明确变更目标和影响范围
+
+### 步骤 2: 分析变更影响
+
+基于基线报告和需求文档，分析变更影响：
+
+1. **识别影响的组件**: 根据需求表格中的"涉及的 UI 组件"列
+2. **识别影响的状态**: 根据需求表格中的"影响的核心状态"列
+3. **理解数据流向**: 根据需求表格中的"预期数据流向"列
+4. **确定变更范围**: 结合基线报告中的依赖关系
+
+### 步骤 2.5: 执行前确认
+
+在开始执行变更前，必须向用户确认：
+
+```
+⚠️ 即将在 <source-code-dir> 中执行代码变更（快速模式）
+
+📋 变更计划:
+- 基于需求: incspec/requirements/structured-requirements.md
+- 参考基线: incspec/baselines/{module}-baseline-v{n}.md
+- 预计变更: 新建 X 个文件，修改 Y 个文件
+
+🔴 风险提示:
+- 快速模式跳过了增量设计步骤，变更未经详细设计审查
+- 建议: 请确保当前代码已提交到 git 或已备份
+
+是否继续执行? (yes/no)
+```
+
+仅在用户明确同意后才开始执行。
+
+### 步骤 3: 直接执行代码变更
+
+按照需求文档的描述，直接在源代码目录执行变更：
+
+1. **搜索参考文件**: 在 source-code-dir 中查找同类型的现有文件
+2. **读取参考文件**: 学习项目代码风格和模式
+3. **执行变更**: 使用 Write/Edit 工具创建或修改文件
+4. **验证完整性**: 确保所有依赖正确引入
+
+### 步骤 4: 输出变更摘要
+
+```
+✅ 快速模式代码变更已完成
+
+📊 变更统计:
+- 新建文件: X 个
+- 修改文件: Y 个
+- 删除代码: Z 处
+
+📁 变更文件清单:
+  ✓ src/components/NewFeature.tsx (新建)
+  ✓ src/store/featureStore.ts (修改)
+
+🧪 建议的后续操作:
+1. 运行 TypeScript 编译检查: npx tsc --noEmit
+2. 运行测试: npm test
+3. 手动验证功能是否正确实现
+```
+
+## 快速模式 vs 完整模式
+
+| 对比项 | 完整模式 | 快速模式 |
+|-------|---------|---------|
+| 输入文件 | 增量设计报告 (模块 2-5) | 需求文档 + 基线报告 |
+| 变更规划 | 详细的变更链条设计 | 基于需求直接分析 |
+| 适用场景 | 复杂功能、多组件交互 | Bug 修复、简单功能 |
+| 风险程度 | 低（经过详细设计） | 中（跳过设计阶段） |

package/templates/cursor-commands/merge-to-baseline.md

@@ -6,6 +6,14 @@ allowed-tools: Read, Write, Bash
 
 ## CLI 同步 (自动)
 
+**检测工作流模式:**
+
+```bash
+incspec status
+```
+
+### 完整模式 (7步)
+
 开始执行前，先用 Bash 执行:
 
 ```bash
@@ -22,9 +30,27 @@ incspec merge <increment-report-path> --complete --output=<output-file>
 - `<output-file>` 必须与最终写入的文件名一致
 - 若提示没有活跃工作流，请先完成步骤 1-5
 
+### 快速模式 (5步)
+
+快速模式下，不依赖增量设计报告，直接重新分析当前代码生成新基线：
+
+```bash
+incspec merge --complete --output=<output-file>
+```
+
+说明:
+- 快速模式下无需提供增量设计报告路径
+- 实际执行的是对当前代码的重新分析
+- 请先完成步骤 1-2 和步骤 5 (应用代码变更)
+
 # 角色定位
 
-你是增量基线融合专家。你的职责是将增量需求融合快照报告（包含新增、修改、删除标记）转换为干净的基线快照报告，作为下一轮增量迭代的起点。
+你是增量基线融合专家。根据工作流模式执行不同的融合策略。
+
+## 模式说明
+
+- **完整模式**: 将增量需求融合快照报告（步骤 4 产出）转换为干净的基线快照报告
+- **快速模式**: 重新分析当前代码状态（已应用变更后），生成新版本基线快照
 
 # 核心目标
 
@@ -327,3 +353,63 @@ D3_DEL (删除) -> 已移除
 ---
 
 记住：你的目标是生成一个干净的、无增量标记的基线快照报告，它应该看起来就像是对当前代码直接执行 analyze-codeflow 分析得到的结果，为下一轮增量迭代提供可靠的对比基准。
+
+---
+
+# 快速模式执行流程
+
+快速模式下，合并步骤实际是"重新分析"：不依赖增量设计报告，而是直接分析当前代码状态生成新基线。
+
+## 核心区别
+
+| 对比项 | 完整模式 | 快速模式 |
+|-------|---------|---------|
+| 输入文件 | 增量设计报告 | 无（直接分析代码） |
+| 执行逻辑 | 清理增量标记、重新编号 | 重新执行 analyze-codeflow |
+| 产出 | 融合后的基线 | 全新的基线快照 |
+
+## 执行步骤
+
+### 步骤 1: 确认代码变更已完成
+
+确保步骤 5 (应用代码变更) 已完成，代码库处于变更后的状态。
+
+### 步骤 2: 获取分析范围
+
+从当前工作流状态中获取：
+- 原始分析的源代码路径 (source-path)
+- 模块名称 (module)
+
+### 步骤 3: 重新执行代码分析
+
+使用 analyze-codeflow.md 的分析方法，对当前代码状态进行完整分析：
+
+1. **扫描代码目录**: 识别所有组件、Store、API 调用
+2. **构建时序图**: 生成新的 API 调用时序图（S1, S2, S3...）
+3. **构建依赖图**: 生成新的依赖关系图（D1, D2, D3...）
+4. **总结依赖关系**: 生成新的依赖关系总结（R1, R2, R3...）
+
+### 步骤 4: 输出新基线
+
+- **输出目录**: `incspec/baselines/`
+- **文件命名**: `{module}-baseline-v{n+1}.md`（版本号递增）
+- **元信息**: 标注为"由快速模式工作流生成"
+
+### 步骤 5: 输出摘要
+
+```
+✅ 快速模式基线生成已完成
+
+📊 分析统计:
+- 时序步骤: X 个 (S1-SX)
+- 依赖节点: Y 个 (D1-DY)
+- 依赖关系: Z 组 (R1-RZ)
+
+📁 输出文件:
+  ✓ incspec/baselines/{module}-baseline-v{n+1}.md
+
+🔄 下一步操作:
+1. 检查新基线报告的完整性
+2. 运行 `incspec archive --yes` 归档当前工作流
+3. 此基线将作为下一轮增量分析的起点
+```

package/templates/cursor-commands/structured-requirements-collection.md

@@ -99,6 +99,12 @@ incspec collect-req --complete
 4. **完成提示**: 文件写入后,在对话中仅输出一行字:
    > "✅ 结构化需求描述已全部收齐并写入文件,可直接用于后续增量 Diff 分析。"
 
+## 快速模式提示
+
+若当前工作流为快速模式 (通过 `incspec status` 确认)，完成需求收集后输出:
+
+> "✅ 结构化需求已收齐。快速模式下，直接运行 `incspec apply` 进入代码应用阶段。"
+
 # 示例交互
 
 **用户**: "我想在简历列表的操作列加一个下载按钮。"

package/templates/inc-spec-skill/SKILL.md

@@ -16,6 +16,7 @@ description: 设计优先的前端功能增量编码工作流。适用于实现
 
 ## 快速开始
 
+**完整模式 (7步):**
 ```
 1. 分析现有代码    → incspec analyze <path>
 2. 收集需求        → incspec collect-req
@@ -26,11 +27,35 @@ description: 设计优先的前端功能增量编码工作流。适用于实现
 7. 归档工作流      → incspec archive --yes
 ```
 
+**快速模式 (5步):**
+```
+1. 分析现有代码    → incspec analyze <path> --quick
+2. 收集需求        → incspec collect-req
+3. 应用代码变更    → incspec apply (基于需求文档)
+4. 合并到基线      → incspec merge (重新分析生成)
+5. 归档工作流      → incspec archive --yes
+```
+
 首次使用前初始化: `incspec init`
 
+## 执行规则
+
+当用户请求满足以下条件时，**直接开始执行**，无需搜索确认:
+- 明确指定了模式（完整/快速）
+- 提供了目标路径或基线文件
+- 意图清晰无歧义
+
+**默认行为**:
+- 未指定模式时，默认使用完整模式
+- 提供 `--baseline=<file>` 时，跳过步骤1的代码分析，直接使用已有基线
+- 提供 `--quick` 时，启用快速模式流程
+- 选项可自由组合，Agent 应根据用户意图推断最优组合
+
 ## 工作流概览
 
-7步设计优先工作流确保代码变更与现有架构无缝集成:
+### 完整模式 (7步)
+
+适用于复杂功能开发，需要完整的 UI 依赖分析和增量设计。
 
 | 步骤 | 目的 | 产出 |
 |------|------|------|
@@ -42,6 +67,22 @@ description: 设计优先的前端功能增量编码工作流。适用于实现
 | 6. 基线合并 | 将增量转换为干净基线 | 新基线 |
 | 7. 归档 | 归档工作流产出到 `archives/YYYY-MM/` | 干净的工作区 |
 
+### 快速模式 (5步)
+
+适用于简单功能或不涉及复杂 UI 依赖的变更。
+
+| 步骤 | 目的 | 产出 |
+|------|------|------|
+| 1. 代码流程分析 | 记录当前API/Store/组件交互 | 基线快照 |
+| 2. 需求收集 | 将模糊需求转换为结构化5列表格 | 需求报告 |
+| 5. 代码应用 | 基于需求直接创建/修改文件 | 更新后的代码库 |
+| 6. 基线合并 | 重新分析生成新基线 | 新基线 |
+| 7. 归档 | 归档工作流产出 | 干净的工作区 |
+
+**模式选择建议:**
+- **完整模式**: 复杂 UI 功能、多组件交互、需要详细设计审查
+- **快速模式**: Bug 修复、简单功能、不涉及 UI 依赖变更
+
 ## CLI集成
 
 每个步骤与 `incspec` CLI同步以跟踪工作流状态:
@@ -67,6 +108,12 @@ description: 设计优先的前端功能增量编码工作流。适用于实现
 
 分析现有代码，创建API调用、依赖关系和组件交互的文档化基线。
 
+**命令:** `incspec analyze <path> [--module=<m>] [--quick] [--baseline=<file>]`
+
+**选项:**
+- `--quick`: 启用快速模式 (5步流程)
+- `--baseline=<file>`: 复用已有基线，跳过代码分析
+
 **输入:** 源代码目录路径 (如 `src/pages/dashboard`) 或现有基线文件 (`--baseline=<file>`)
 
 **输出:** 基线报告，包含:
@@ -158,20 +205,28 @@ incspec archive <file> --keep      # 复制而非移动
 
 ## 最佳实践
 
-**顺序执行:** 按步骤1-7顺序执行。跳过步骤会导致集成问题。
+**顺序执行:** 按步骤顺序执行。完整模式按 1-7 执行，快速模式按 1-2-5-6-7 执行。跳过步骤会导致集成问题。
 
-**设计先于编码:** 步骤4设计获批前不编写任何代码。
+**设计先于编码:** 完整模式下，步骤4设计获批前不编写任何代码。快速模式跳过设计步骤，适用于简单变更。
 
-**不可跳过依赖:** 遗漏依赖(步骤3)是集成失败的首要原因。
+**不可跳过依赖:** 完整模式下，遗漏依赖(步骤3)是集成失败的首要原因。
 
 **CLI同步:** 始终与 `incspec` CLI同步以保证工作流可追溯。
 
+**模式选择:**
+- 不确定时优先选择完整模式
+- 仅在变更范围明确、不涉及复杂依赖时使用快速模式
+
 **验证节点:**
 - 步骤2后: 需求中无模糊术语
-- 步骤4后: 编码前审查蓝图
+- 步骤4后 (完整模式): 编码前审查蓝图
 - 步骤5后: 验证所有文件已正确创建/修改
 - 步骤7后: 确认工作区已清理
 
+**关键人工确认点:**
+- 完整模式: 步骤2后 + 步骤4后
+- 快速模式: 步骤2后 (需求确认后才能开始编码)
+
 ## 常见陷阱
 
 | 陷阱 | 后果 |

package/templates/inc-spec-skill/references/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>