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/*.mddocs/
  • 同步 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