AI提示词高效驱动AI Coding,软件项目开发,工程最优实践探索

本文较长,来自作者近期工作感悟,虽然还有许多不成熟之处及待改善空间,但感觉对各软件团队在面对AI Coding浪潮的冲击下如何应对还是有必定协助的,特共享共勉。

特别是软件开发不同阶段,如何编写合适的提示词,这个各有各的玩法,但对软件工程成熟度而言,还是应该有规范化的要求,具备必定的章法,第7章内容(具体提示词)具有较大参考价值,各团队可以根据各自情况自行发挥,原理类似。

AI提示词高效驱动AI Coding,软件项目开发,工程最优实践探索

目录

1、软件开发8大典型阶段

2、软件团队6类典型角色

3、8大阶段6类角色的任务分配对照表

4、6类角色输出物对照表

5、8大阶段输出要求清单

6、8大阶段输出要求细节

7、8大阶段AI提示词(超级重点!)

8、AI提示词驱动开发示例


1、软件开发8大典型阶段

01-需求分析、02-架构设计、03-软件设计、04-前端实现、05-后端实现、06-测试设计、07-部署方案、08-运维方案

2、软件团队6类典型角色

  • 产品经理:聚焦需求定义与验收,贯穿需求分析到测试阶段。
  • 架构师:主导技术设计,覆盖架构、接口和部署方案。
  • 前端开发:代码为核心产出,辅以设计文档和测试报告。
  • 后端开发:代码为核心产出,辅以设计文档和测试报告。
  • 测试:覆盖全流程测试设计,包括接口、前端、后端和运维验证。
  • 运维:侧重部署和稳定性保障,与架构师协作基础设施设计。

3、8大阶段6类角色的任务分配对照表

开发阶段

产品经理

架构师

前端开发

后端开发

测试

运维

1. 需求分析

主导需求分析,编写需求规格说明书、用例图、功能列表、优先级排序

参与需求分析,提供技术可行性提议

参与需求评审

2. 架构设计

参与架构评审

主导架构设计,编写架构设计文档、技术栈选型、系统架构图、部署架构图

参与前端技术选型

参与后端技术选型

参与架构评审

参与部署架构设计

3. 软件设计

参与设计评审

主导详细设计,编写详细设计文档、数据库设计文档、API设计文档

主导页面原型设计,编写页面原型文档和原型文件

参与API设计,编写数据库设计

参与设计评审

4. 前端实现

参与功能验收

提供技术指导

主导前端开发,编写源代码、测试用例、构建配置、部署文档、开发文档

参与前端测试

5. 后端实现

参与功能验收

提供技术指导

主导后端开发,编写源代码、测试用例、数据库脚本、部署文档、开发文档

参与后端测试

6. 测试阶段

参与测试用例评审

参与性能测试

参与前端测试

参与后端测试

主导测试工作,编写测试计划、测试用例、测试报告

7. 部署阶段

参与部署方案评审

参与前端部署

参与后端部署

参与部署测试

主导部署工作,编写部署方案、运维手册、部署脚本

8. 运维阶段

参与运维方案评审

主导运维工作,编写监控配置、备份方案、安全配置、维护计划

注:

“主导”表明该角色在该阶段承担主要责任

“参与”表明该角色在该阶段提供支持或参与评审

“-“表明该角色在该阶段不直接参与

4、6类角色输出物对照表

产品经理

需求分析阶段

docs/01-需求分析/requirements-spec.md(需求规格说明书)

docs/01-需求分析/use-case-diagram.md(用例图)

docs/01-需求分析/feature-list.md(功能列表)

docs/01-需求分析/priority-ranking.md(优先级排序)

软件设计阶段

docs/03-软件设计/page-prototype.md(页面原型设计文档)

docs/03-软件设计/prototype/prototype.html(页面原型文件)

系统架构师

架构设计阶段

docs/02-架构设计/architecture-design.md(架构设计文档)

docs/02-架构设计/tech-stack.md(技术栈选型)

docs/02-架构设计/system-architecture.md(系统架构图)

docs/02-架构设计
/deployment-architecture.md(部署架构图)

软件设计阶段

docs/03-软件设计/detailed-design.md(详细设计文档)

docs/03-软件设计/database-design.md(数据库设计文档)

docs/03-软件设计/api-design.md(API设计文档)

前端开发

前端实现阶段

frontend/src/(源代码目录)

frontend/tests/(测试用例目录)

frontend/build/(构建配置目录)

frontend/deploy.md(部署文档)

frontend/docs/(开发文档)

后端开发

软件设计阶段

参与编写 docs/03-软件设计/api-design.md(API设计文档)

参与编写 docs/03-软件设计/database-design.md(数据库设计文档)

后端实现阶段

backend/src/(源代码目录)

backend/tests/(测试用例目录)

backend/db/(数据库脚本目录)

backend/deploy.md(部署文档)

backend/docs/(开发文档)

测试

测试阶段

test/test-plan.md(测试计划文档)

test/test-cases.md(测试用例文档)

test/test-report.md(测试报告文档)

运维人员

部署阶段

deploy/deploy-plan.md(部署方案文档)

deploy/operations.md(运维手册)

deploy/scripts/(部署脚本目录)

运维阶段

ops/monitoring/(监控配置目录)

ops/backup/(备份方案目录)

ops/security/(安全配置目录)

ops/maintenance/(维护计划目录)

注:

每个角色负责其对应输出物的编写和维护

部分输出物可能需要多个角色协作完成

所有输出物都需要经过相关角色的评审

5、不同阶段输出要求清单

需求分析阶段

docs/01-需求分析/requirements-spec.md(需求规格说明书)

docs/01-需求分析/use-case-diagram.md(用例图)

docs/01-需求分析/feature-list.md(功能列表)

docs/01-需求分析/priority-ranking.md(优先级排序)

架构设计阶段

docs/02-架构设计/architecture-design.md(架构设计文档)

docs/02-架构设计/tech-stack.md(技术栈选型)

docs/02-架构设计/system-architecture.md(系统架构图)

docs/02-架构设计
/deployment-architecture.md(部署架构图)

软件设计阶段

docs/03-软件设计/detailed-design.md(详细设计文档)

docs/03-软件设计/database-design.md(数据库设计文档)

docs/03-软件设计/api-design.md(API设计文档)

docs/03-软件设计/page-prototype.md(页面原型设计文档)

docs/03-软件设计/prototype/prototype.html(页面原型文件)

前端实现阶段

frontend/src/(源代码目录)

frontend/tests/(测试用例目录)

frontend/build/(构建配置目录)

frontend/deploy.md(部署文档)

frontend/docs/(开发文档)

后端实现阶段

backend/src/(源代码目录)

backend/tests/(测试用例目录)

backend/db/(数据库脚本目录)

backend/deploy.md(部署文档)

backend/docs/(开发文档)

测试阶段

test/test-plan.md(测试计划文档)

test/test-cases.md(测试用例文档)

test/test-report.md(测试报告文档)

部署阶段

deploy/deploy-plan.md(部署方案文档)

deploy/operations.md(运维手册)

deploy/scripts/(部署脚本目录)

运维阶段

ops/monitoring/(监控配置目录)

ops/backup/(备份方案目录)

ops/security/(安全配置目录)

ops/maintenance/(维护计划目录)

6、不同阶段输出要求细节

01-需求分析阶段

需求规格说明书 (requirements-spec.md)

  • 功能需求
  • 非功能需求
  • 系统约束
  • 验收标准

用例图 (use-case-diagram.md)

  • 用户角色
  • 用例描述
  • 用例关系
  • 用例流程

功能列表 (feature-list.md)

  • 功能模块
  • 功能点
  • 功能描述
  • 功能依赖

优先级排序 (priority-ranking.md)

  • 功能优先级
  • 开发优先级
  • 测试优先级
  • 发布优先级

02-架构设计阶段

架构设计文档 (architecture-design.md)

  • 系统架构图
  • 技术栈选型
  • 模块架构
  • 安全架构
  • 性能架构
  • 监控架构

技术栈选型 (tech-stack.md)

  • 前端技术栈
  • 后端技术栈
  • 数据库选型
  • 中间件选型

系统架构图 (system-architecture.md)

  • 整体架构
  • 模块划分
  • 接口设计
  • 数据流

部署架构图 (
deployment-architecture.md)

  • 部署拓扑
  • 环境配置
  • 网络架构
  • 安全架构

03-软件设计阶段

详细设计文档 (detailed-design.md)

  • 类图
  • 接口设计
  • 数据库设计
  • 算法设计

数据库设计文档 (database-design.md)

  • 表结构设计
  • 索引设计
  • 存储过程设计
  • 数据迁移设计

API设计文档 (api-design.md)

  • API接口设计
  • 数据格式设计
  • 错误处理设计

API文档

页面原型设计文档 (page-prototype.md)

  • 页面布局设计
  • 组件设计
  • 交互设计
  • 视觉设计

页面原型文件 (prototype/prototype.html)

  • 高保真UI原型
  • 功能模块实现
  • 交互效果

04-前端实现阶段

源代码目录 (frontend/src)

  • 组件目录
  • 路由配置
  • 状态管理
  • 工具函数
  • 样式文件

测试用例目录 (frontend/tests)

  • 单元测试
  • 集成测试
  • E2E测试

构建配置目录 (frontend/build)

  • Webpack配置
  • Babel配置
  • 环境配置

部署文档 (frontend/deploy.md)

  • 部署步骤
  • 环境要求
  • 配置说明

开发文档 (frontend/docs)

  • 开发规范
  • 组件文档
  • API文档

05-后端实现阶段

源代码目录 (backend/src)

  • 控制器
  • 服务层
  • 数据访问层
  • 工具类
  • 配置文件

测试用例目录 (backend/tests)

  • 单元测试
  • 集成测试
  • 性能测试

数据库脚本目录 (backend/db)

  • 建表脚本
  • 初始化数据
  • 存储过程

部署文档 (backend/deploy.md)

  • 部署步骤
  • 环境要求
  • 配置说明

开发文档 (backend/docs)

  • 开发规范
  • API文档
  • 数据库设计文档

06-测试阶段

测试计划文档 (test/test-plan.md)

  • 测试范围
  • 测试策略
  • 测试环境
  • 测试进度

测试用例文档 (test/test-cases.md)

  • 功能测试用例
  • 性能测试用例
  • 安全测试用例

测试报告文档 (test/test-report.md)

  • 测试结果
  • 问题统计
  • 改善提议

07-部署阶段

部署方案文档 (deploy/deploy-plan.md)

  • 部署架构
  • 部署步骤
  • 回滚方案

运维手册 (deploy/operations.md)

  • 日常运维
  • 故障处理
  • 监控告警

部署脚本目录 (deploy/scripts)

  • 部署脚本
  • 配置脚本
  • 监控脚本

08-运维阶段

监控配置目录 (ops/monitoring/)

  • 系统监控配置
  • 性能监控配置
  • 日志监控配置
  • 告警规则配置

备份方案目录 (ops/backup/)

  • 数据备份方案
  • 系统备份方案
  • 恢复演练方案
  • 备份验证方案

安全配置目录 (ops/security/)

  • 安全策略配置
  • 访问控制配置
  • 审计日志配置
  • 漏洞扫描配置

维护计划目录 (ops/maintenance/)

  • 日常维护计划
  • 定期维护计划
  • 应急维护计划
  • 升级维护计划

7、8大阶段AI提示词

01-需求分析

# 需求分析提示词

## 功能需求分析
请分析以下功能需求:
1. 用户故事
2. 功能点列表
3. 业务规则
4. 用户交互流程

## 非功能需求分析
请分析以下非功能需求:
1. 性能需求
2. 安全需求
3. 可用性需求
4. 可维护性需求

## 约束条件
请列出项目的主要约束条件:
1. 技术约束
2. 时间约束
3. 资源约束
4. 法律约束

## 输出要求
请提供以下文档:
1. docs/01-需求分析/requirements-spec.md(需求规格说明书)
2. docs/01-需求分析/use-case-diagram.md(用例图)
3. docs/01-需求分析/feature-list.md(功能列表)
4. docs/01-需求分析/priority-ranking.md(优先级排序)

02-架构设计

# 架构设计提示词

## 系统架构
请设计以下系统架构:
1. 整体架构图
2. 技术栈选择
3. 系统模块划分
4. 模块间交互

## 数据架构
请设计以下数据架构:
1. 数据模型
2. 数据流图
3. 存储方案
4. 数据安全

## 部署架构
请设计以下部署架构:
1. 部署拓扑图
2. 服务器配置
3. 网络架构
4. 负载均衡

## 安全架构
请设计以下安全架构:
1. 认证方案
2. 授权方案
3. 数据加密
4. 安全防护

## 输出要求
请提供以下文档:
1. docs/02-架构设计/architecture-design.md(架构设计文档)
2. docs/02-架构设计/system-architecture.md(系统架构图)
3. docs/02-架构设计/deployment-architecture.md(部署架构图)
4. docs/02-架构设计/tech-stack.md(技术选型说明)

03-软件设计

# 软件设计提示词

## 详细设计
请进行以下详细设计:
1. 类图设计
2. 接口设计
3. 数据库设计
4. 算法设计

## 模块设计
请设计以下模块:
1. 模块职责
2. 模块接口
3. 模块依赖
4. 模块测试

## 接口设计
请设计以下接口:
1. API接口
2. 数据格式
3. 错误处理
4. 接口文档

## 数据库设计
请设计以下数据库相关内容:
1. 表结构
2. 索引设计
3. 存储过程
4. 数据迁移

## 页面原型设计要求
请设计以下页面原型:
1. 页面布局
- 整体布局结构
- 导航菜单设计
- 页面组件布局
- 响应式设计
2. 交互设计
- 用户操作流程
- 表单交互
- 数据展示方式
- 反馈机制
3. 视觉设计
- 配色方案
- 字体规范
- 图标设计
- 视觉层次
4. 功能模块
- 参照设计文档内容

## 页面原型设计
通过以下方式完成所有原型图片的设计
1. 参照需求分析文档先设计出需要实现哪些功能
2. 作为UI设计师完成这些原型界面的设计
3. 使用html在一个界面上生成所有的原型界面,使用Tailwind CSS创建高保真UI原型,可从Unsplash获取图片素材,使用FontAwesome等开源图标库,让原型显得更精美和接近真实
4. 这些界面可直接用于项目开发

## 输出要求
请提供以下文档:
1. docs/03-软件设计/detailed-design.md(详细设计文档)
2. docs/03-软件设计/class-diagram.md(类图文档)
3. docs/03-软件设计/api-design.md(接口设计文档)
4. docs/03-软件设计/database-design.md(数据库设计文档)
5. docs/03-软件设计/prototype-design.md(页面原型设计文档)
6. docs/03-软件设计/prototype/prototype.html(页面原型文件)

04-前端实现

# 前端实现提示词

## 页面开发
请实现以下页面开发:
1. 页面布局
2. 组件开发
3. 路由配置
4. 状态管理

## 功能实现
请实现以下功能:
1. 用户交互
2. 数据展示
3. 表单处理
4. 动画效果

## 性能优化
请进行以下性能优化:
1. 代码优化
2. 资源加载
3. 缓存策略
4. 渲染优化

## 测试要求
请进行以下测试:
1. 单元测试
2. 集成测试
3. 性能测试
4. 兼容性测试

## 输出要求
请提供以下内容:
1. frontend/src/(源代码目录)
2. frontend/tests/(测试用例目录)
3. frontend/config/(构建配置目录)
4. docs/04-前端实现/deployment.md(部署文档)
5. docs/04-前端实现/development.md(开发文档)
6. 参照需求分析、架构设计、软件设计内容,特别是参照03-软件设计中prototype目录下原型图的设计,实现前端代码

05-后端实现

# 后端实现提示词

## 服务开发
请实现以下服务开发:
1. API接口
2. 业务逻辑
3. 数据处理
4. 缓存处理

## 数据库操作
请实现以下数据库操作:
1. 数据访问
2. 事务处理
3. 数据验证
4. 数据迁移

## 中间件集成
请集成以下中间件:
1. 消息队列
2. 缓存服务
3. 日志服务
4. 监控服务

## 安全实现
请实现以下安全功能:
1. 认证授权
2. 数据加密
3. 访问控制
4. 安全防护

## 输出要求
请提供以下内容:
1. backend/src/(源代码目录)
2. backend/config/(配置文件目录)
3. backend/scripts/(部署脚本目录)
4. docs/05-后端实现/api-docs.md(接口文档)
5. docs/05-后端实现/development.md(开发文档)
6. 参照需求分析、架构设计、软件设计内容,实现后端代码

06-测试设计

# 测试设计提示词

## 测试策略
请制定以下测试策略:
1. 测试范围
2. 测试方法
3. 测试环境
4. 测试工具

## 测试用例
请设计以下测试用例:
1. 功能测试
2. 性能测试
3. 安全测试
4. 兼容性测试

## 自动化测试
请设计以下自动化测试:
1. 单元测试
2. 接口测试
3. UI测试
4. 集成测试

## 测试执行
请执行以下测试:
1. 测试计划
2. 测试执行
3. 缺陷管理
4. 测试报告

## 输出要求
请提供以下内容:
1. docs/06-测试设计/test-plan.md(测试计划)
2. frontend/tests/(前端测试用例目录)
3. backend/tests/(后端测试用例目录)
4. docs/06-测试设计/test-report.md(测试报告)
5. docs/06-测试设计/test-cases.md(测试用例文档)

07-部署方案

# 部署方案提示词

## 环境配置
请配置以下环境:
1. 开发环境
2. 测试环境
3. 预发布环境
4. 生产环境

## 部署流程
请设计以下部署流程:
1. 构建流程
2. 部署步骤
3. 回滚方案
4. 监控方案

## 容器化部署
请设计以下容器化部署:
1. Docker配置
2. Kubernetes配置
3. 服务编排
4. 资源管理

## CI/CD流程
请设计以下CI/CD流程:
1. 代码集成
2. 自动化构建
3. 自动化测试
4. 自动化部署

## 输出要求
请提供以下内容:
1. docs/07-部署方案/deployment-guide.md(部署指南)
2. deploy/config/(部署配置目录)
3. deploy/scripts/(部署脚本目录)
4. docs/07-部署方案/monitoring.md(监控方案)
5. .github/workflows/(CI/CD工作流配置目录)

08-运维方案

# 运维方案提示词

## 监控方案
请设计以下监控方案:
1. 系统监控
2. 应用监控
3. 日志监控
4. 告警策略

## 运维流程
请设计以下运维流程:
1. 日常运维
2. 故障处理
3. 变更管理
4. 应急预案

## 安全管理
请设计以下安全管理:
1. 访问控制
2. 安全审计
3. 漏洞管理
4. 应急响应

## 性能优化
请设计以下性能优化:
1. 系统优化
2. 应用优化
3. 数据库优化
4. 网络优化

## 输出要求
请提供以下内容:
1. docs/08-运维方案/operation-manual.md(运维手册)
2. docs/08-运维方案/monitoring-plan.md(监控方案)
3. docs/08-运维方案/emergency-plan.md(应急预案)
4. docs/08-运维方案/optimization-plan.md(优化方案)
5. ops/scripts/(运维脚本目录)

8、AI提示词驱动开发示例

以设计一套通用的设备资产管理系统为例进行开发。

提示词如下,按阶段分别将提示词贴出,AI Coder自行处理,Cursor、Trae等都执行效果杠杠的。

设计一套通用的设备资产管理系统。
按01-需求分析中的提示词进行输出,特别是要严格遵循输出要求,不要输出多余的文档,也不要缺少要求的文档。

参照01-需求分析中文档,按02-架构设计中的提示词进行输出,特别是要严格遵循输出要求,不要输出多余的文档,也不要缺少要求的文档。

参照01-需求分析、02-架构设计文档,按03-软件设计中的提示词进行输出,特别是要严格遵循输出要求,不要输出多余的文档,也不要缺少要求的文档。

参照01-需求分析、02-架构设计、03-软件设计文档,按04-前端实现中的提示词进行输出,特别是要严格遵循输出要求,不要输出多余的文档,也不要缺少要求的文档。

参照01-需求分析、02-架构设计、03-软件设计文档,按05-后端实现中的提示词进行输出,特别是要严格遵循输出要求,不要输出多余的文档,也不要缺少要求的文档。

参照01-需求分析、02-架构设计、03-软件设计、04-前端实现、05-后端实现文档,按06-测试设计中的提示词进行输出,特别是要严格遵循输出要求,不要输出多余的文档,也不要缺少要求的文档。

参照01-需求分析、02-架构设计、03-软件设计、04-前端实现、05-后端实现、06-测试设计文档,按07-部署方案中的提示词进行输出,特别是要严格遵循输出要求,不要输出多余的文档,也不要缺少要求的文档。

参照01-需求分析、02-架构设计、03-软件设计、04-前端实现、05-后端实现、06-测试设计、07-部署方案文档,按08-运维方案中的提示词进行输出,特别是要严格遵循输出要求,不要输出多余的文档,也不要缺少要求的文档。

提示词目录,按阶段贴

AI提示词高效驱动AI Coding,软件项目开发,工程最优实践探索

自动生成的8个阶段文档

AI提示词高效驱动AI Coding,软件项目开发,工程最优实践探索

自动生成的前端、后端、测试、部署、运维代码及内容

AI提示词高效驱动AI Coding,软件项目开发,工程最优实践探索

© 版权声明
THE END
如果内容对您有所帮助,就支持一下吧!
点赞0 分享
凌晨不晚ohhh的头像 - 鹿快
评论 抢沙发

请登录后发表评论

    暂无评论内容