基于 Harness + SDD + 多仓管理模式的 AI 全栈开发实践

📌 一句话摘要

本文提出了一套结合 Harness 约束思维、SDD 文档驱动和多 Agent 协作的全栈 AI 开发方法论，旨在提升 AI 生成代码的采纳率和开发效率。

📝 详细摘要

文章基于得物技术的实际项目经验，系统阐述了如何利用 AI 工具（如 Cursor、Claude Code）进行高效的全栈开发。核心方法论包含三个部分：Harness 思维，即通过给 AI 提供现有代码作为模仿对象，约束其生成风格一致、可复用的代码；SDD（Specification-Driven Development）文档驱动，通过生成前后端两份对齐的 SDD 文档，确保接口契约一致，并指导 AI 进行代码生成；多 Agent 协作，利用 Cursor 的多 Tab 或 Claude Code 的 Subagent 机制，实现前后端代码的并行开发。文章还详细介绍了全栈工作区搭建、提示词编写范式、三阶段验证策略，并特别警示了 AI 自动复刻隐性功能带来的测试陷阱。实践数据显示，该方法论可将开发效率提升 50% 以上。

💡 主要观点

1. Harness 思维通过提供模仿对象来约束 AI 代码生成，提升代码采纳率。 直接让 AI 从零生成代码容易产生风格不一致、复用率低的「外星代码」。通过给 AI 一个已有的、功能相似的实现作为参照，并明确约束生成范围，可以显著提升生成代码的质量和可维护性。
2. SDD 文档驱动是前后端并行开发的基础，确保接口契约对齐。 全栈开发需要生成前端和后端两份独立的 SDD 文档，其中接口定义、字段映射必须严格对应。这为后续的多 Agent 并行开发提供了统一的蓝图，避免了因信息不对称导致的联调问题。
3. 多 Agent 协作模式可实现前后端代码的并行生成，大幅缩短开发周期。 利用 Cursor 的多 Tab 或 Claude Code 的 Subagent 机制，可以同时启动多个 AI Agent 分别处理前端和后端的代码生成任务。SDD 文档先行，确保并行开发时接口契约一致。
4. AI 自动复刻的隐性功能是测试环节需要重点关注的陷阱。 AI 在模仿参考代码时，会无意识地复刻许多未在 SDD 中描述的隐性逻辑（如表单清空、默认值处理）。测试人员需要将 SDD 作为起点，主动对比代码差异，发现并验证这些隐性行为。

💬 文章金句

• Harness（约束）思维的本质是：给 AI 一个已有的实现作为参照，让它照着复刻一份，而不是凭空创造。
• 约束越精准，生成代码的可用性越高。
• SDD 描述的是「技术上怎么实现」，而不是「业务上所有的行为」。
• 把 SDD 文档当作起点，而不是终点。

📊 文章信息

阅读完整文章