一直有人问我,说SDD规范驱动开发里的spec到底是什么?在AI生成PLAN之前,如何用spec来约束架构?
一般来说,同一个公司,同一个产品,同一个团队,技术栈和架构规范就是固定下来的。这个规范约束,不会因为你做需求a还是需求b而不同,这个东西,就是spec。
我服务过一个教育公司,后端技术栈是PHP,他们的几百行spec基线大概长这样:
# 架构规范基线
## 技术基线
| 层 | 选型 |
| 语言 | PHP 8.3+ |
| 框架 | Laravel 13.x |
| 前端交互 | Livewire 3.x |
| 模板 | Blade |
| 样式 | Tailwind CDN(MVP期) |
| 数据库 | MariaDB 10.3+ |
| 测试 | Pest |
| 代码质量 | Pint + PHPStan |
| AI开发工具 | Claude Code + Laravel Boost |
| 版本控制 | git + Conventional Commits |
## 分层架构
HTTP请求 → Route → Controller / Livewire → Service → Eloquent Model → MariaDB
| 层 | 职责 |
| Route | URL映射、中间件挂载 |
| Controller/Livewire组件 | 接收输入、调用Service、返回响应 |
| Service | 全部业务逻辑、业务验证、留痕写入 |
| Eloquent Model | 数据访问、关联、访问器 |
## 目录结构约定
app/
├── Http/Controllers/ # 薄的HTTP入口
├── Livewire/ # Livewire组件
│ └── [组件名].php # 与 resources/views/livewire/ 下blade同名对应
├── Models/ # Eloquent模型
├── Services/ # 业务逻辑层
├── Support/ # 工具类
└── Policies/ # 权限策略
resources/views/
├── layouts/ # 布局母版
├── livewire/ # 与app/Livewire/一一对应
└── pages/ # 静态页
database/
├── migrations/ # 表结构唯一事实源
└── seeders/ # 测试数据
## 编码规范
## 安全基线
## 数据纪律
## 测试规范
## 质量门槛
## 部署
## AI协作约定
## 红线清单
...(限于篇幅,细节省略)
几句话可能讲不清,直播和大家聊聊:《企业AI编程,spec驱动到底是啥?》
完整几百行spec基线md,直播分享给大家。
欢迎预约,直播间不见不散。
贵司AI编程,有使用spec基线吗?
文章原文
一般来说,同一个公司,同一个产品,同一个团队,技术栈和架构规范就是固定下来的。这个规范约束,不会因为你做需求a还是需求b而不同,这个东西,就是spec。
我服务过一个教育公司,后端技术栈是PHP,他们的几百行spec基线大概长这样:
# 架构规范基线
## 技术基线
| 层 | 选型 |
| 语言 | PHP 8.3+ |
| 框架 | Laravel 13.x |
| 前端交互 | Livewire 3.x |
| 模板 | Blade |
| 样式 | Tailwind CDN(MVP期) |
| 数据库 | MariaDB 10.3+ |
| 测试 | Pest |
| 代码质量 | Pint + PHPStan |
| AI开发工具 | Claude Code + Laravel Boost |
| 版本控制 | git + Conventional Commits |
## 分层架构
HTTP请求 → Route → Controller / Livewire → Service → Eloquent Model → MariaDB
| 层 | 职责 |
| Route | URL映射、中间件挂载 |
| Controller/Livewire组件 | 接收输入、调用Service、返回响应 |
| Service | 全部业务逻辑、业务验证、留痕写入 |
| Eloquent Model | 数据访问、关联、访问器 |
## 目录结构约定
app/
├── Http/Controllers/ # 薄的HTTP入口
├── Livewire/ # Livewire组件
│ └── [组件名].php # 与 resources/views/livewire/ 下blade同名对应
├── Models/ # Eloquent模型
├── Services/ # 业务逻辑层
├── Support/ # 工具类
└── Policies/ # 权限策略
resources/views/
├── layouts/ # 布局母版
├── livewire/ # 与app/Livewire/一一对应
└── pages/ # 静态页
database/
├── migrations/ # 表结构唯一事实源
└── seeders/ # 测试数据
## 编码规范
## 安全基线
## 数据纪律
## 测试规范
## 质量门槛
## 部署
## AI协作约定
## 红线清单
...(限于篇幅,细节省略)
几句话可能讲不清,直播和大家聊聊:《企业AI编程,spec驱动到底是啥?》
完整几百行spec基线md,直播分享给大家。
欢迎预约,直播间不见不散。
贵司AI编程,有使用spec基线吗?
文章原文
