Workflow & Methodology

工作流和方法总结

在 Decision 项目中，我采用的是一套以产品验证为前置、以阶段门禁为控制、以高保真原型为实现基线、以自动化测试和视觉验收为闭环的研发工作流。

工作流流程图

核心工作流

1. 需求澄清

先完成头脑风暴、市场调研、竞品分析和 ROI 预估，再沉淀最终功能清单。该阶段重点回答为什么做、给谁做、做到什么边界。

2. 产品设计

按用户流程图、系统流程图、概念原型、产品需求文档和高保真原型逐步收敛。核心原则是先确认语义，再确认结构，最后确认视觉。

3. 技术设计和实施计划

把产品需求翻译为系统架构、接口设计、数据模型、Agent 推演生命周期、状态管理、分支管理、报告生成和测试策略。

4. 正式开发

以高保真原型为唯一视觉基线，按页面顺序逐页等价迁移，并建立原型节点到 React 组件、数据字段和事件的映射。

5. 测试与验收

测试验收独立成阶段，覆盖系统测试、回归测试、浏览器测试、性能、安全、部署和用户验收，并回到 ROI 假设中复核收益。

核心方法论

阶段门禁

每个阶段都有对应产物和确认口令，当前阶段未确认前不进入下一阶段。

状态单一来源

以 workflow-state.yaml 作为当前阶段和确认状态的唯一依据。

变更影响管理

通过 traceability.yaml 和同步脚本检查上游依据和下游影响。

原型即基线

高保真原型不是参考图，而是正式前端等价迁移的唯一基线。

最小实现

只做当前阶段、当前页面、当前需求真正需要的内容。

证据驱动验收

用测试、构建、截图、差异图和用户确认记录证明完成度。

与工作流匹配的文件结构

MultiAgent/
├── AGENTS.md
│   └── 项目级工作规则、阶段门禁、变更控制和编码约束
├── docs/
│   ├── product/
│   │   ├── workflow-state.yaml
│   │   │   └── 当前阶段、确认状态和下一阶段的唯一状态来源
│   │   ├── traceability.yaml
│   │   │   └── 产品产物之间的依赖关系映射
│   │   ├── sync-status.yaml
│   │   │   └── 变更扫描后的待同步状态
│   │   ├── 变更记录.md
│   │   │   └── 每次同步和确认后的变更记录
│   │   ├── 一致性与变更追踪.md
│   │   │   └── 产物一致性和影响管理说明
│   │   ├── 00-需求澄清.md
│   │   ├── 01-市场调研.md
│   │   ├── 02-竞品分析.md
│   │   ├── 03-ROI预估.md
│   │   ├── 04-功能清单.md
│   │   │   └── 阶段 1：需求澄清和功能范围
│   │   ├── 05-用户流程图.excalidraw
│   │   ├── 06-系统流程图.excalidraw
│   │   ├── 07-概念原型.html
│   │   ├── 08-产品需求文档.md
│   │   ├── 09-高保真原型/
│   │   │   ├── login.html
│   │   │   ├── home.html
│   │   │   ├── config.html
│   │   │   ├── research.html
│   │   │   ├── workspace.html
│   │   │   ├── report.html
│   │   │   ├── knowledge.html
│   │   │   ├── src/
│   │   │   ├── verification/
│   │   │   ├── baseline-manifest.json
│   │   │   └── updatelog.md
│   │   │       └── 阶段 2：从流程、PRD 到高保真原型的正式设计产物
│   │   ├── 10-系统设计文档_v3.md
│   │   │   └── 阶段 3：技术架构、接口、数据模型和实施计划
│   │   └── 11-开发记录.md
│   │       └── 阶段 4：逐页开发、映射关系、测试结果和验收记录
│   └── superpowers/
│       └── plans/
│           └── 实施计划和阶段性开发计划
├── scripts/
│   ├── product-sync.mjs
│   ├── product-sync-state.mjs
│   ├── excalidraw-user-flow.mjs
│   └── install-product-sync-watcher.sh
│       └── 产品同步、状态扫描、流程图检查和监听器脚本
├── tests/
│   ├── product-sync-state.test.mjs
│   └── excalidraw-user-flow.test.mjs
│       └── 产品治理脚本和流程图规范的自动化测试
├── apps/
│   ├── web/
│   │   ├── src/
│   │   └── verification/
│   │       └── 正式前端代码、页面测试、原型截图、实现截图和差异图
│   └── api/
│       ├── app/
│       └── tests/
│           └── 后端 API、状态管理、推演逻辑和后端测试
├── data/
│   └── 运行数据和项目数据
├── config/
│   └── 项目配置
└── 成果展示/
    ├── demo录屏.mov
    └── 工作流和方法总结.md
        └── 展示材料，集中呈现工作流、方法论、流程图和文件结构

这套工作流适合复杂 AI 产品和多 Agent 系统，它能够解决需求不确定、交互复杂、技术链路长、验收难度高这四类风险问题。