Phase 03 · 场景建模
场景 Skill 会读取产品原型和功能规格,为每个场景 ID 生成时序图。时序图描述哪个角色在什么顺序下调用哪个系统能力,以及有哪些边界情况。
产物内容
logos/resources/prd/3-technical-plan/2-scenario-implementation/ 中会生成场景实现文档,例如:
S01-user-registration.md
S02-login.md
S03-password-reset.md
示例
sequenceDiagram
actor User
participant App
participant API
participant DB
User->>App: 填写注册表单
App->>API: POST /auth/register
API->>DB: INSERT users
DB-->>API: user_id
API-->>App: 201 Created + JWT
App-->>User: 跳转控制台
为什么先有场景再设计 API
场景图迫使团队先看完整交互,而不是孤立设计接口。时序图里的每个边界情况会进入测试设计,每个 API 调用会进入 OpenAPI 规格。
跳过这一步,API 很容易偏离真实用户流程。