Workflow & Methodology

工作流和方法总结

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

核心工作流

1. 需求澄清

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

2. 产品设计

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

3. 技术设计和实施计划

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

4. 正式开发

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

5. 测试与验收

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

核心方法论

阶段门禁

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

状态单一来源

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

变更影响管理

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

原型即基线

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

最小实现

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

证据驱动验收

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

工作流流程图

需求澄清

产品设计

技术设计

正式开发

测试验收

交付闭环

与工作流匹配的文件结构

MultiAgent/
├── docs/product/
│   ├── workflow-state.yaml        当前阶段和确认状态
│   ├── traceability.yaml          产物依赖关系
│   ├── 00-需求澄清.md
│   ├── 01-市场调研.md
│   ├── 02-竞品分析.md
│   ├── 03-ROI预估.md
│   ├── 04-功能清单.md
│   ├── 05-用户流程图.excalidraw
│   ├── 06-系统流程图.excalidraw
│   ├── 07-概念原型.html
│   ├── 08-产品需求文档.md
│   ├── 09-高保真原型/
│   ├── 10-系统设计文档_v3.md
│   └── 11-开发记录.md
├── apps/web/                      正式前端和视觉验收截图
├── apps/api/                      后端 API 和业务逻辑
├── tests/                         产品治理和流程图检查测试
├── scripts/                       同步、校验和开发脚本
└── 成果展示/                       面试展示材料

这套方法适合复杂 AI 产品和多 Agent 系统，因为它能够同时处理需求不确定、交互复杂、技术链路长、验收难度高这四类风险。