在开始编码前,先让 AI 编写详细的 Product Specs(产品规格说明书)。好的文档是成功的一半。
Product Specs 应包含:
功能规格:
详细的功能描述
用户故事和使用场景
输入输出定义
边界条件处理
技术规格:
技术架构设计
数据模型定义
API 接口规范
性能指标要求
实施细节:
开发步骤分解
测试策略
部署方案
回滚计划
示例结构:
# 用户管理系统 Product Specs## 1. 功能概述### 1.1 核心功能- 用户注册/登录
- 权限管理
- 个人信息维护## 2. 技术架构### 2.1 前端技术栈- React 18 + TypeScript
- 状态管理:Redux Toolkit### 2.2 后端技术栈- Node.js + Express
- 数据库:PostgreSQL## 3. API设计### 3.1 用户认证POST /api/auth/login
{
"username": "string",
"password": "string"
}## 4. 数据模型...
建议:
创建专门的 docs 目录管理这些文档
使用版本控制追踪文档变更
定期更新文档与代码保持同步




