1

3Resources/AI/基于Harness-SDD-多仓管理的AI全栈开发实践.md

@@ -0,0 +1,86 @@
+---
+title: 基于 Harness + SDD + 多仓管理模式的 AI 全栈开发实践
+source: https://mp.weixin.qq.com/s/ygQGSH5c7GHYDvkqWoQTXQ
+author: 盖伦 / 得物技术
+date: 2026-05-06
+tags:
+  - AI开发
+  - 全栈
+  - SDD
+  - Harness
+  - Cursor
+  - ClaudeCode
+---
+
+# 基于 Harness + SDD + 多仓管理模式的 AI 全栈开发实践｜得物技术
+
+## 一、核心理念：Harness 思维 — 让 AI 模仿，而不是凭空创造
+
+### 全栈AI开发最容易踩的坑
+让AI从零开始写代码产生"外星代码"：风格不一致、复用率低、采纳率低。AI生成了代码，但Review成本和返工成本反而更高了。
+
+### Harness 思维的核心：给 AI 一个"模仿对象"
+给AI一个已有的实现作为参照，让它照着复刻一份，而不是凭空创造。
+
+**四条原则：**
+
+| 原则 | 说明 | 举例 |
+|------|------|------|
+| 找相似实现 | 在代码库中找到功能最相似的已有实现作为参照 | "结束语"参照"场景化欢迎语" |
+| 复用优先 | 能复用的组件、接口封装、数据结构直接复用 | 复用greetingExtendInfo数据结构 |
+| 模仿着复制 | "抄一份改一改"比用新方式好 | Controller/Service/Repository按已有模仿 |
+| 约束生成范围 | 提示词中明确指定参考文件/参考接口 | 前端修改入口@FeatureTable/index.tsx:53-58 |
+
+### 提示词体现 Harness
+- ❌ 不推荐：`请实现一个结束语管理的 CRUD 接口`
+- ✅ 推荐：明确指定参考文件、数据结构和接口路径，如"参照场景欢迎语功能（后端/api/v1/feature/list，前端FeatureTable/index.tsx:53-58）实现"
+
+## 二、全栈工作区搭建与 Codebase Indexing
+
+将前后端代码放在同一个工作区下的三个核心价值：
+1. **Codebase Indexing**：Cursor对工作区内所有代码进行向量化嵌入建立语义索引，AI能跨仓库理解代码关系
+2. **上下文完整**：AI同时能看到前后端代码，接口字段、命名风格自然对齐
+3. **SDD文档集中管理**：前后端SDD文档在同一工作区，便于接口契约对齐
+
+### Cursor vs Claude Code 实测对比
+
+| 功能维度 | Cursor | Claude Code |
+|---------|--------|-------------|
+| 代码库语义索引 | 支持grep+语义检索，速度快 | 仅支持grep，依赖模型能力 |
+| 代码生成速度 | 极速，平均1-3分钟 | 中速，平均3-30分钟 |
+| 代码采纳率 | 两者相当 | 两者相当 |
+| 文件/代码段引用 | 快捷键、拖拽即可引用 | 需手动@文件路径，无法引用代码段 |
+| 多Agent | 默认开启（多Tab并行） | 需手动注册子Agent |
+| 费率模型 | 失败任务不收费 | 失败任务耗时长，容易浪费Token |
+| 历史会话恢复 | 仅能查看当前项目会话记录 | 可查看全局会话记录 |
+| 综合评价 | 快速迭代首选，推荐Composer2模式 | 长链路复杂任务可用 |
+
+## 三、SDD 驱动的全栈代码生成流程
+
+- 全栈SDD需同时覆盖前后端
+- 提示词编写范式：明确需求、参考实现、数据结构、接口契约
+- 前后端需求点清单分工示例
+- SDD文档产出与指令使用说明
+
+## 四、多 Agent 协作：前后端并行开发
+
+- Cursor中使用多Tab并行（默认开启）
+- Claude Code中使用Subagent能力（需手动注册）
+- 建议：前端Agent专注UI/交互，后端Agent专注API/数据
+
+## 五、前后端联调：Mock 数据与分阶段验证
+
+- 三阶段验证策略
+- Mock数据编写要点
+- 后端独立构建验证
+- 前后端联调步骤
+
+## 六、警惕 SDD 陷阱：测试如何介入全栈研发
+
+- SDD不等于需求文档
+- 关注隐性功能（异常处理、边界情况、性能要求）
+- 测试应尽早介入
+
+## 七、综合效益与总结
+
+核心公式：**Harness（约束） + SDD（规格） + 多仓（上下文） = 高质量AI全栈代码**