---
name: source-prototype-to-delivery
type: pipeline_procedure
when: 用户提供需求文档、原型源码
scope:
  - backend
  - frontend
products:
  - '*'
id: ka-procedure-源码原型交付流程
asset_kind: procedure
lifecycle_status: active
authority: supporting
owner_mechanism_id: mc-artifact-contract
routes:
  - code_change
primary_triggers:
  - 源码原型交付流程
secondary_triggers: []
negative_triggers: []
priority: P1
specificity: 5
consumes:
  - mc-intent-router
emits:
  - execution_result
  - evidence
required_evidence:
  - execution_evidence
version: 1.0.0
last_reviewed: '2026-05-22'
migration_note: 知识资产标准化迁移
status: active
---

# 源码原型需求到交付

### 第1步：原型抓取
只能从导出的源码包（如 React/Vite zip）或已解压源码目录提取原型信息：路由、页面组件、布局结构、状态变量、事件处理、弹窗/导航/表单交互、样式令牌和导入的业务说明。禁止使用 Figma MCP、浏览器运行态、figma.site 或截图作为补充来源。若未提供源码包或源码目录，停止原型抓取并要求补充源码输入。对每个端或页面独立输出原型说明。
模板：原型说明模版.md
产出保存到：.soloforge/output/01-原型说明.md
工具：source

### 第2步：架构设计
根据原型说明和需求文档，设计系统模块划分、数据流向、技术选型与依据、风险点与应对方案。
产出保存到：.soloforge/output/02-架构设计.md

### 第3步：详细设计
根据架构设计产出，把数据结构和接口契约落到正式设计载体。
默认产出：
- docs/architecture/02-数据库设计文档.md
- docs/architecture/03-API接口规格文档.md
- docs/api/openapi.yaml
- db/migration 或 db/migrations 下的 SQL/migration 权威资产

### 第4步：接口设计
设计 API 路径、请求/响应结构、错误码、鉴权方案。接口契约必须写入 `docs/architecture/03-API接口规格文档.md` 并与 `docs/api/openapi.yaml` 对齐。

### 第5步：编码实现
根据切片计划和追踪矩阵绑定的 `SLICE-*`、`DD-*`、`AC-*` 进行前后端编码实现。可使用脚手架生成骨架代码。
工具：sf_scaffold, sf_expand

### 第6步：测试与审查验收
执行自动验证（构建 + 测试）、代码审查（质量/安全/性能/架构/技术债务五维度）、学习记录。
工具：sf_verify, sf_review, sf_learn
