@localsummer/incspec 0.0.5 → 0.0.7

package/lib/terminal.mjs

@@ -241,6 +241,88 @@ export async function select({ message, choices }) {
   });
 }
 
+/**
+ * Interactive checkbox (multi-select) prompt
+ * @param {Object} options
+ * @param {string} options.message
+ * @param {Array<{name: string, value: any, checked?: boolean}>} options.choices
+ * @returns {Promise<any[]>}
+ */
+export async function checkbox({ message, choices }) {
+  return new Promise((resolve) => {
+    let cursor = 0;
+    const selected = choices.map(c => c.checked || false);
+
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+
+    if (process.stdin.isTTY) {
+      process.stdin.setRawMode(true);
+    }
+    readline.emitKeypressEvents(process.stdin, rl);
+
+    const render = () => {
+      process.stdout.write('\x1b[2J\x1b[H');
+
+      console.log(colorize(message, colors.bold, colors.cyan));
+      console.log(colorize('(space: toggle, a: toggle all, enter: confirm)', colors.dim));
+      console.log();
+
+      choices.forEach((choice, index) => {
+        const isCursor = cursor === index;
+        const isSelected = selected[index];
+        const pointer = isCursor ? colorize('>', colors.cyan) : ' ';
+        const check = isSelected ? colorize('[x]', colors.green) : '[ ]';
+        const name = isCursor ? colorize(choice.name, colors.bold) : choice.name;
+
+        console.log(`${pointer} ${check} ${name}`);
+      });
+    };
+
+    const cleanup = () => {
+      if (process.stdin.isTTY) {
+        process.stdin.setRawMode(false);
+      }
+      rl.close();
+    };
+
+    const handleKeypress = (str, key) => {
+      if (!key) return;
+
+      if (key.name === 'up' || key.name === 'k') {
+        cursor = cursor > 0 ? cursor - 1 : choices.length - 1;
+        render();
+      } else if (key.name === 'down' || key.name === 'j') {
+        cursor = cursor < choices.length - 1 ? cursor + 1 : 0;
+        render();
+      } else if (key.name === 'space') {
+        selected[cursor] = !selected[cursor];
+        render();
+      } else if (str === 'a') {
+        const allSelected = selected.every(s => s);
+        selected.fill(!allSelected);
+        render();
+      } else if (key.name === 'return') {
+        cleanup();
+        process.stdin.removeListener('keypress', handleKeypress);
+        process.stdout.write('\x1b[2J\x1b[H');
+        const result = choices.filter((_, i) => selected[i]).map(c => c.value);
+        resolve(result);
+      } else if (key.name === 'escape' || (key.ctrl && key.name === 'c')) {
+        cleanup();
+        process.stdin.removeListener('keypress', handleKeypress);
+        process.stdout.write('\x1b[2J\x1b[H');
+        process.exit(0);
+      }
+    };
+
+    process.stdin.on('keypress', handleKeypress);
+    render();
+  });
+}
+
 /**
  * Format a table for terminal output
  * @param {string[]} headers
@@ -290,3 +372,29 @@ export function spinner(message) {
     }
   };
 }
+
+/**
+ * Format date to local datetime string
+ * @param {Date} date - Date object
+ * @returns {string} Format: YYYY-MM-DD HH:mm
+ */
+export function formatLocalDateTime(date) {
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, '0');
+  const day = String(date.getDate()).padStart(2, '0');
+  const hours = String(date.getHours()).padStart(2, '0');
+  const minutes = String(date.getMinutes()).padStart(2, '0');
+  return `${year}-${month}-${day} ${hours}:${minutes}`;
+}
+
+/**
+ * Format date to local date string
+ * @param {Date} date - Date object
+ * @returns {string} Format: YYYY-MM-DD
+ */
+export function formatLocalDate(date) {
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, '0');
+  const day = String(date.getDate()).padStart(2, '0');
+  return `${year}-${month}-${day}`;
+}

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 = [
@@ -211,7 +212,7 @@ 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 lines = [
     '# Workflow Status',
@@ -292,7 +293,7 @@ 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');
@@ -324,7 +325,7 @@ function generateInitialWorkflowContent() {
  * @returns {Object}
  */
 export function startWorkflow(projectRoot, workflowName) {
-  const now = new Date().toISOString().replace('T', ' ').slice(0, 16);
+  const now = formatLocalDateTime(new Date());
   let workflow = readWorkflow(projectRoot);
 
   if (!workflow) {
@@ -381,7 +382,7 @@ 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);
 
   workflow.steps[index] = {
@@ -411,7 +412,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 +441,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,
@@ -549,7 +550,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,

package/package.json

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

package/templates/AGENTS.md

@@ -234,9 +234,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 +248,7 @@ incspec --version / -v          # 显示版本
 
 ### Cursor 斜杠命令
 
-运行 `incspec cursor-sync` 后,以下命令可用:
+运行 `incspec sync --cursor` 后,以下命令可用:
 
 | 命令 | 步骤 | 描述 |
 |------|------|------|
@@ -585,7 +588,7 @@ incspec status
 incspec status              # 我在哪里?
 incspec list               # 有什么?
 incspec validate --strict  # 是否正确?
-incspec cursor-sync        # 设置IDE命令
+incspec sync               # 设置IDE命令
 ```
 
 ## 与AI助手集成

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

@@ -1,6 +1,6 @@
 ---
 description: 分析代码工作流，生成带编号的API调用时序图、依赖关系图和依赖总结
-argument-hint: <source_path> [target_path]
+argument-hint: <source-path> [target-dir]
 allowed-tools: Glob, Grep, Read, Write, Bash
 ---
 
@@ -9,13 +9,13 @@ allowed-tools: Glob, Grep, Read, Write, Bash
 在开始分析前，先用 Bash 执行:
 
 ```bash
-incspec analyze <source_path> --module=<module> --workflow=analyze-<module>
+incspec analyze <source-path> --module=<module> --workflow=analyze-<module>
 ```
 
 完成报告写入后，再用 Bash 执行:
 
 ```bash
-incspec analyze <source_path> --module=<module> --workflow=analyze-<module> --complete --output=<output-file>
+incspec analyze <source-path> --module=<module> --workflow=analyze-<module> --complete --output=<output-file>
 ```
 
 **使用现有基准报告** (跳过分析):
@@ -35,7 +35,7 @@ incspec analyze --baseline=<baseline-file> [--module=<module>] [--workflow=<work
 ---
 
 说明:
-- `<module>` 默认为 source_path 最后一级目录名，若用户显式指定模块名则使用该值
+- `<module>` 默认为 source-path 最后一级目录名，若用户显式指定模块名则使用该值
 - `<output-file>` 必须与最终写入的文件名一致
 - 若 incspec 提示未初始化，请先运行 `incspec init`
 
@@ -45,19 +45,19 @@ incspec analyze --baseline=<baseline-file> [--module=<module>] [--workflow=<work
 
 你需要完成以下任务：
 
-1. **代码分析**：检查 source_path 目录下的所有组件和Store文件，识别初始化阶段的API调用
+1. **代码分析**：检查 source-path 目录下的所有组件和Store文件，识别初始化阶段的API调用
 2. **时序图绘制**：构建带编号的API调用时序图，展示调用顺序
 3. **依赖图绘制**：构建带编号的API依赖关系图，展示依赖关系
 4. **依赖总结**：生成带编号的依赖关系文字总结
-5. **Markdown输出**：将分析结果输出到 target_path 目录
+5. **Markdown输出**：将分析结果输出到 target-dir 目录
 
 **重要提示**：默认情况下，只输出上述核心分析内容。只有在用户明确要求提供"潜在问题与优化建议"时，才在文档末尾添加该部分内容。
 
 ## 输出配置
 
-- **target_path**: 报告输出目录，默认 `incspec/baselines`
+- **target-dir**: 报告输出目录，默认 `incspec/baselines`
 - **文件命名**: `{module}-baseline-v{n}.md`
-  - `{module}`: 模块名称，从 source_path 的最后一级目录名推断，或由用户指定
+  - `{module}`: 模块名称，从 source-path 的最后一级目录名推断，或由用户指定
   - `{n}`: 版本号，扫描目标目录中同名前缀的文件，取最大版本号+1，若无则为 1
 - **示例**: 分析 `src/views/resume` 目录，输出 `incspec/baselines/resume-baseline-v1.md`
 
@@ -85,7 +85,7 @@ incspec analyze --baseline=<baseline-file> [--module=<module>] [--workflow=<work
 
 ### 第一步：代码扫描
 
-- 使用 Glob 工具扫描 source_path 目录下的所有文件
+- 使用 Glob 工具扫描 source-path 目录下的所有文件
 - 关注文件类型：
   - 组件文件（.jsx, .tsx, .js, .ts）
   - Store文件（Zustand, MobX等）
@@ -132,7 +132,7 @@ incspec analyze --baseline=<baseline-file> [--module=<module>] [--workflow=<work
 # [模块名称] API工作流分析
 
 **分析时间**: [自动生成的时间戳]
-**分析范围**: [source_path的相对路径或绝对路径]
+**分析范围**: [source-path的相对路径或绝对路径]
 
 ## 概述
 
@@ -287,8 +287,8 @@ graph TD
 
 ## 工作流程
 
-1. **确认路径**：验证 source_path 和 target_path 的有效性
-2. **生成元信息**：记录分析时间（使用当前时间戳）和分析范围（source_path）
+1. **确认路径**：验证 source-path 和 target-dir 的有效性
+2. **生成元信息**：记录分析时间（使用当前时间戳）和分析范围（source-path）
 3. **扫描目录**：使用 Glob 工具获取所有相关文件
 4. **分析文件**：使用 Read 工具逐个分析文件中的API调用
 5. **构建模型**：在内存中构建完整的API调用关系模型
@@ -296,7 +296,7 @@ graph TD
 7. **生成图表**：使用Mermaid语法创建带编号的可视化图表
 8. **编写文档**：按照规范格式生成Markdown文档（包含元信息和三个核心部分）
 9. **可选增强**：仅当用户明确要求时，在文档末尾添加"潜在问题与优化建议"部分
-10. **保存输出**：使用 Write 工具保存到 target_path
+10. **保存输出**：使用 Write 工具保存到 target-dir
 
 ## 质量标准
 

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

@@ -1,6 +1,6 @@
 ---
 description: 基于现状、需求和依赖,生成增量需求的设计蓝图(时序、依赖、文件变更),指导代码生成
-argument-hint: [旧需求快照] [结构化需求] [UI依赖报告] [report-output-dir]
+argument-hint: [baseline-snapshot-path] [structured-requirements-path] [ui-dependencies-path] [report-output-dir]
 allowed-tools: Glob, Grep, Read, Write, Bash
 ---
 
@@ -31,9 +31,9 @@ incspec design --feature=<feature> --complete --output=<output-file>
 
 接收以下三份材料(由用户提供或从指定文件读取):
 
-1. **旧需求快照**(来自 `analyze-codeflow`): 包含 S1~Sxx 时序编号、Dxx 依赖节点、Rxx 关系总结
-2. **结构化需求描述**(来自 `structured-requirements-collection`): 包含新增/修改功能、触发条件、核心状态、数据流向的 5 列表格
-3. **UI依赖采集报告**(来自 `ui-dependency-collection`): 包含依赖类型、来源路径、变更类型的依赖详情表
+1. **baseline-snapshot-path** (来自 `analyze-codeflow`): 包含 S1~Sxx 时序编号、Dxx 依赖节点、Rxx 关系总结
+2. **structured-requirements-path** (来自 `structured-requirements-collection`): 包含新增/修改功能、触发条件、核心状态、数据流向的 5 列表格
+3. **ui-dependencies-path** (来自 `ui-dependency-collection`): 包含依赖类型、来源路径、变更类型的依赖详情表
 
 # 执行流程
 

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

@@ -1,6 +1,6 @@
 ---
 description: 将增量需求报告融合为新的代码流基线快照
-argument-hint: <increment-report-path> [baseline-output-path]
+argument-hint: <increment-report-path> [baseline-output-dir]
 allowed-tools: Read, Write, Bash
 ---
 
@@ -38,7 +38,7 @@ incspec merge <increment-report-path> --complete --output=<output-file>
 # 输入参数
 
 1. **increment-report-path** (必填): 增量需求融合快照报告的完整路径（如 increment-codeflow-v2.md）
-2. **baseline-output-path** (可选): 新基线报告的输出路径，默认为 `<原文件名>-baseline.md`
+2. **baseline-output-dir** (可选): 新基线报告的输出路径，默认为 `<原文件名>-baseline.md`
 
 # 执行流程
 
@@ -202,7 +202,7 @@ D3_DEL (删除) -> 已移除
 - 新基线总节点: N 个
 
 📁 输出文件:
-  ✓ <baseline-output-path>
+  ✓ <baseline-output-dir>
 
 🔄 下一步操作:
 1. 检查新基线报告的完整性
@@ -268,7 +268,7 @@ D3_DEL (删除) -> 已移除
 
 ## 输出目录
 
-- **baseline-output-path**: 默认为 `incspec/baselines`
+- **baseline-output-dir**: 默认为 `incspec/baselines`
 - 如目录不存在,需主动创建
 
 ## 文件命名

package/templates/inc-spec-skill/.security-scan-passed

@@ -0,0 +1,4 @@
+Security scan passed
+Scanned at: 2025-11-20T14:20:58.168746
+Tool: gitleaks + pattern-based validation
+Content hash: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

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

@@ -0,0 +1,231 @@
+---
+name: inc-spec-skill
+description: 设计优先的前端功能增量编码工作流。适用于实现新UI组件、修改现有功能，或当用户提及"增量编码"、"代码流程分析"、"需求收集"，以及需要带有API/Store依赖追踪的结构化功能开发时使用。
+---
+
+# AI增量编码
+
+## 目录
+
+- [快速开始](#快速开始)
+- [工作流概览](#工作流概览)
+- [CLI集成](#cli集成)
+- [步骤详情](#步骤详情)
+- [最佳实践](#最佳实践)
+- [参考资源](#参考资源)
+
+## 快速开始
+
+```
+1. 分析现有代码    → incspec analyze <path>
+2. 收集需求        → incspec collect-req
+3. 收集依赖        → incspec collect-dep
+4. 设计增量        → incspec design
+5. 应用代码变更    → incspec apply <report>
+6. 合并到基线      → incspec merge <report>
+7. 归档工作流      → incspec archive --yes
+```
+
+首次使用前初始化: `incspec init`
+
+## 工作流概览
+
+7步设计优先工作流确保代码变更与现有架构无缝集成:
+
+| 步骤 | 目的 | 产出 |
+|------|------|------|
+| 1. 代码流程分析 | 记录当前API/Store/组件交互 | 基线快照 |
+| 2. 需求收集 | 将模糊需求转换为结构化5列表格 | 需求报告 |
+| 3. 依赖收集 | 识别所有API/Store/类型依赖 | 依赖报告 |
+| 4. 增量设计 | 生成实现蓝图 | 增量快照 |
+| 5. 代码应用 | 按蓝图创建/修改文件 | 更新后的代码库 |
+| 6. 基线合并 | 将增量转换为干净基线 | 新基线 |
+| 7. 归档 | 归档工作流产出到 `archives/YYYY-MM/` | 干净的工作区 |
+
+## CLI集成
+
+每个步骤与 `incspec` CLI同步以跟踪工作流状态:
+
+| 步骤 | 开始 | 完成 |
+|------|------|------|
+| 分析 | `incspec analyze <path> --module=<m>` 或 `--baseline=<file>` | `--complete --output=<file>` |
+| 需求 | `incspec collect-req` | `--complete` |
+| 依赖 | `incspec collect-dep` | `--complete` |
+| 设计 | `incspec design --feature=<f>` | `--complete --output=<file>` |
+| 应用 | `incspec apply <report>` | `--complete` |
+| 合并 | `incspec merge <report>` | `--complete --output=<file>` |
+| 归档 | `incspec archive --yes` | - |
+
+管理命令:
+- `incspec status` - 查看工作流状态
+- `incspec list` - 列出规范文件
+- `incspec validate` - 验证项目健康状态
+
+## 步骤详情
+
+### 步骤1: 代码流程分析
+
+分析现有代码，创建API调用、依赖关系和组件交互的文档化基线。
+
+**输入:** 源代码目录路径 (如 `src/pages/dashboard`) 或现有基线文件 (`--baseline=<file>`)
+
+**输出:** 基线报告，包含:
+- 编号的API调用序列图 (如 `[1]`、`[2]`)
+- 组件/Store依赖关系图
+- 数据流摘要
+
+详见 [references/analyze-codeflow.md](references/analyze-codeflow.md)。
+
+### 步骤2: 需求收集
+
+将模糊的用户需求转换为严格的5列结构化表格，消除所有歧义术语。
+
+**输入:** 用户的非正式需求描述
+
+**输出:** 结构化表格，包含以下列:
+1. 需求ID
+2. 详细描述 (不含"某些"、"相关"等模糊术语)
+3. 验收标准
+4. 依赖项
+5. 实现备注
+
+详见 [references/structured-requirements-collection.md](references/structured-requirements-collection.md)。
+
+### 步骤3: 依赖收集
+
+在代码生成前识别所有上下文依赖。
+
+**输入:** 步骤2的结构化需求
+
+**输出:** 完整的依赖清单:
+- **API:** 端点、方法、请求/响应类型
+- **Store:** 模块、状态属性、actions
+- **类型:** 现有和新增的TypeScript接口
+- **组件:** 共享组件、工具函数
+
+详见 [references/ui-dependency-collection.md](references/ui-dependency-collection.md)。
+
+### 步骤4: 增量设计
+
+基于当前状态、需求和依赖生成实现蓝图。**设计获批前不编写任何代码。**
+
+**输入:** 基线(步骤1) + 需求(步骤2) + 依赖(步骤3)
+
+**输出:** 增量快照，包含:
+- 集成新调用的API序列图
+- 文件修改计划 (新增/修改/删除)
+- 分步实现指导
+
+详见 [references/analyze-increment-codeflow.md](references/analyze-increment-codeflow.md)。
+
+### 步骤5: 代码应用
+
+通过创建新文件和修改现有文件执行增量蓝图。
+
+**输入:** 步骤4的增量快照 + 源代码目录
+
+**输出:** 修改后的代码库:
+- 按蓝图创建的新文件
+- 更新的现有文件
+- 正确的导入和类型定义
+
+详见 [references/apply-increment-code.md](references/apply-increment-code.md)。
+
+### 步骤6: 基线合并
+
+将增量快照(带有新增/修改/删除标记)转换为干净基线，为下次迭代做准备。
+
+**输入:** 步骤4的增量快照
+
+**输出:** 代表当前系统状态的干净基线(无增量标记)
+
+详见 [references/merge-to-baseline.md](references/merge-to-baseline.md)。
+
+### 步骤7: 归档
+
+将已完成的工作流产出归档到 `archives/YYYY-MM/{module}/` 目录。
+
+**输入:** 要归档的文件(可选，默认为当前工作流)
+
+**操作:**
+```bash
+incspec archive --yes              # 归档所有工作流产出
+incspec archive <file> --yes       # 归档指定文件
+incspec archive <file> --keep      # 复制而非移动
+```
+
+详见 [references/inc-archive.md](references/inc-archive.md)。
+
+## 最佳实践
+
+**顺序执行:** 按步骤1-7顺序执行。跳过步骤会导致集成问题。
+
+**设计先于编码:** 步骤4设计获批前不编写任何代码。
+
+**不可跳过依赖:** 遗漏依赖(步骤3)是集成失败的首要原因。
+
+**CLI同步:** 始终与 `incspec` CLI同步以保证工作流可追溯。
+
+**验证节点:**
+- 步骤2后: 需求中无模糊术语
+- 步骤4后: 编码前审查蓝图
+- 步骤5后: 验证所有文件已正确创建/修改
+- 步骤7后: 确认工作区已清理
+
+## 常见陷阱
+
+| 陷阱 | 后果 |
+|------|------|
+| 跳过代码流程分析 | 集成问题，返工 |
+| 接受模糊需求 | 编码时发现歧义 |
+| 遗漏依赖 | 导入错误，运行时失败 |
+| 编码先于设计 | 在不符合架构的实现上浪费精力 |
+| 跳过基线合并 | 对当前系统状态产生混淆 |
+| 忽略归档 | 工作区杂乱，历史丢失 |
+
+## 参考资源
+
+| 文件 | 用途 |
+|------|------|
+| [analyze-codeflow.md](references/analyze-codeflow.md) | 代码流程分析和API序列图 |
+| [structured-requirements-collection.md](references/structured-requirements-collection.md) | 5列需求结构化 |
+| [ui-dependency-collection.md](references/ui-dependency-collection.md) | API/Store/类型依赖收集 |
+| [analyze-increment-codeflow.md](references/analyze-increment-codeflow.md) | 设计优先的增量蓝图 |
+| [apply-increment-code.md](references/apply-increment-code.md) | 基于蓝图的代码应用 |
+| [merge-to-baseline.md](references/merge-to-baseline.md) | 增量到基线转换 |
+| [inc-archive.md](references/inc-archive.md) | 工作流产出归档 |
+
+## 使用示例
+
+**任务:** 为产品仪表板添加筛选功能
+
+```
+步骤1: 分析产品仪表板代码流程
+       → 记录当前数据获取、store结构、API端点
+
+步骤2: 结构化筛选需求
+       → 将"添加一些筛选器"转换为具体筛选类型(类别、价格、评分)
+       → 定义确切行为和组合逻辑(AND/OR)
+
+步骤3: 收集依赖
+       → 识别筛选API端点、store扩展、共享筛选组件
+
+步骤4: 生成增量蓝图
+       → 规划FilterPanel集成、状态管理变更、文件修改
+
+步骤5: 应用增量
+       → 创建FilterPanel组件，修改ProductDashboard，更新store
+
+步骤6: 合并到基线
+       → 生成新仪表板状态的干净快照
+
+步骤7: 归档
+       → 归档工作流产出，为下次增量做准备(如添加排序功能)
+```
+
+## 开发工作流集成
+
+- **版本控制:** 步骤7(完整周期)后提交
+- **代码审查:** 在步骤4审查增量蓝图
+- **测试:** 在步骤5添加测试
+- **文档:** 在步骤6更新文档