81 lines
3.7 KiB
Markdown
81 lines
3.7 KiB
Markdown
---
|
||
title: 基于 Harness + SDD + 多仓管理模式的 AI 全栈开发实践
|
||
source: https://mp.weixin.qq.com/s/ygQGSH5c7GHYDvkqWoQTXQ
|
||
author: 盖伦 / 得物技术
|
||
date: 2026-05-06
|
||
tags: [AI开发, 全栈, SDD, Harness, Cursor, Claude Code]
|
||
---
|
||
|
||
# 基于 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全栈代码**
|