Spec 驱动开发
VistaCast 采用 VibeCode Spec-Driven + Artifacts Workflow。
流水线
spec/(战略 + 产品 + 架构)
→ artifacts/contracts/(OpenAPI、事件 schema)
→ repos/(server · web · ai · shared)
→ docs 同步
原则
| 规则 |
说明 |
| Spec 是边界 |
未写入 FR 的能力视为未承诺 |
| 契约在 artifacts/ |
跨端类型只在此生成并消费 |
| 可追溯 |
PR 引用 FR-xxx / US-xxx |
| 生态契约优先 |
跨产品 JWT、MQTT topic 先改 LuminaryWorks spec |
文档层级
| 层级 |
路径 |
内容 |
| L0 |
spec/strategic-analysis.md |
市场、GTM |
| L0 |
spec/product-roadmap.md |
FR、里程碑 |
| L1 |
spec/architecture.md |
模块、事件流 |
| L0 |
spec/spec-driven-development-spec.md |
完整 SDD 规范 |
D0 阶段规则
编码未启动时,允许 仅 Spec / Docs PR:
- 修改
spec/*.md、docs/
- 同步
LuminaryWorks/spec/products/vistacast.md
- 禁止 在无 Spec 的情况下添加实现代码
需求 ID
| 前缀 |
含义 |
US-xx |
用户故事 |
FR-PLT-xx |
平台基础 |
FR-AI-xx |
AI 检测 |
FR-RUL-xx |
规则告警 |
FR-ADM-xx |
管理台 |
FR-ECO-xx |
生态集成 |
完整规范:spec/spec-driven-development-spec.md