从 Vibe Coding 到 Harness × SDD 全栈开发实战

第一阶段：Vibe Coding 的“可控化”改（不是瞎写，而是写规格）

Vibe Coding 最大的痛点是生成的代码“能跑但不规范”。实战中的破局点是让AI生成代码的同时，强制生成OpenAPI/Swagger 和 AsyncAPI 规格文件。

• 实战操作：在Prompt中明确要求：“请为这个功能编写代码，并同步生成 openapi.yaml 和 package.json 中的版本依赖锁”。
• 工具链：使用 Cursor/Windsurf 结合 GitHub Copilot，利用 .cursorrules 文件强行约束AI的输出结构，确保生成的不仅是逻辑，还有可被机器读取的规格元数据。
• 产物：一份包含API契约、数据库Schema（Prisma/Entity）、以及基础单元测试的PR（Pull Request）。

第二阶段：SDD（规格驱动）的“契约”锚定

规格驱动开发的核心是“契约即真理”。在AI生成大量代码后，你需要用规格来反向校验代码，而不是用代码去解释规格。

• 实战策略：引入 Confluent Schema Registry（用于Kafka事件）和 Stoplight（用于REST API）进行规格托管。
• GitOps 结合：将 openapi.yaml 作为PR合并的硬性门槛。利用 Spectral（Linter工具）对规格进行质量检查，确保AI生成的API路径符合RESTful规范，且没有破坏原有版本的兼容性。
• Mock 先行：基于固化的规格，使用 Prism 生成Mock Server。这样前端开发和后端开发（或AI生成的后端）可以彻底解耦并行。

第三阶段：Harness 平台的全栈编排（核心实战）

Harness 在这里不仅是CI/CD（持续集成/持续部署），它是连接“规格”与“运行时”的神经中枢。实战中要利用其 AI 增强模块 和 GitOps 引擎。

• Harness CI（持续集成）：在Pipeline中插入 “规格合规性检查” 步骤。如果AI生成的代码导致OpenAPI规格与现有生产环境规格冲突，Pipeline直接Fail（失败），不构建镜像。
• Harness CD + GitOps（持续部署+GitOps）：利用Harness的 ServiceNow 集成 或 自定义审批流程。当部署新服务时，Harness会自动读取SDD中定义的 SLO（服务等级目标）（如：P99延迟 < 100ms）。
• 特性标志（Feature Flags）：这是全栈实战的杀手锏。将AI生成的新功能用Harness FF（特性标志）包裹起来，先在生产环境对内部员工或小流量用户开放，而不是全量上线。

第四阶段：Harness × SDD 的“持续验证”闭环（AI+平台）

这是全栈实战的最后一步，也是让系统“自愈”的关键。

• 混沌工程与自动回滚：在Harness中定义 “Verification（验证）” 步骤。利用其机器学习算法，自动对比新版本部署后的 黄金指标（吞吐量、错误率、饱和度）与历史基线。
• SDD 反馈写入：如果验证失败（例如错误率飙升），Harness自动触发回滚，并自动在Git中创建Issue，将失败的监控截图和日志片段附着在Issue上，@给AI Coding Agent，要求其根据规格修正代码。
• 数据库变更的SDD：引入 Bytebase 或 Liquibase 与Harness集成，将数据库DDL（数据定义语言）变更也视为“规格”，确保AI生成的SQL变更必须通过审核才能由Harness推送到生产库。

给你的实战命令行级建议（伪代码逻辑）：

# 1. 本地 Vibe Coding 生成代码+规格
cursor-prompt> "基于此 Proto 文件，生成 Go 微服务并输出 OpenAPI"

# 2. 提交触发 Harness Pipeline
git push origin feature/ai-gen

# 3. Harness 执行 SDD 合规检查
harness pipeline run --stage "Spec-Lint" --check "openapi.yaml"

# 4. 部署金丝雀版本，Harness 自动采集遥测数据
harness deploy --strategy Canary --verify "prometheus-metrics"

# 5. 验证通过则全量，不通过则回滚并 AI 自愈
harness verify --baseline "last-release" --auto-rollback true

深度思考（避开陷阱）： 千万不要把Vibe Coding生成的代码直接丢给Harness。你的核心工作是训练AI生成符合你企业规格模板的代码。建议在你的代码仓库中维护一个 spec-template/ 文件夹，里面存放标准的 Dockerfile、skaffold.yaml 和 monitoring-config，每次让AI以此为蓝本进行填充，而不是自由发挥。