告别"一次性代码生成",拥抱标准化工程流程
📖 故事从一个痛点开始
你是否也有这样的经历?
你: "帮我做一个用户管理系统"
AI: [生成了500行代码,包含前端、后端、数据库]
你: 😰 这么多代码,我怎么看?
😰 改了一个地方,其他地方崩了
😰 过了两周,完全不记得为什么这么写
😰 新同事接手,花了3天才能看懂
这就是传统 AI 辅助开发的困境:代码生成容易,工程管理难。
今天,我要介绍一个革命性的解决方案 —— AI Dev Workflow,它不仅仅是一个 Skill,而是一个完整的项目脚手架 + 开发方法论 + 自动化测试框架。
🎯 AI Dev Workflow 是什么?
AI Dev Workflow 是一个7步完整开发工作流系统,它将复杂的开发任务拆解为标准化的子任务,每个任务都包含开发、测试、文档和版本管理。
核心流程图
传统方式 (❌):
PRD → AI生成所有代码 → 上下文溢出 → 质量不可控 → 难以维护
AI Dev Workflow (✅):
Step 0: 交互式初始化 → 确定技术栈和目录结构
Step 1: PRD转化 → 技术需求文档(含MVCS/RESTful规范)
Step 2: 任务拆解 → 按阶段拆分为10-20个子任务
Step 3: 逐个执行 → 每个任务:开发→测试→日志→更新索引
Step 4: 模块测试 → 回归测试验证
Step 5: 模块闭环 → 生成文档+设计说明
Step 6: Git提交 → 规范的commit message
✨ 核心特性
1. 交互式项目初始化 🚀
不再手动创建目录结构和配置文件!
npx skills add siYuanJun/ai-dev-workflow -g -y
AI 会询问你:
- ✅ 项目名称和描述
- ✅ 前端技术栈(Vue 3/React/Next.js等)
- ✅ 后端技术栈(Laravel/Django/Spring Boot等)
- ✅ 数据库选择(MySQL/PostgreSQL等)
- ✅ 是否使用 Docker
然后自动生成:
- 📁 标准化目录结构(MVCS架构)
- 🐳 docker-compose.yml
- 🔧 .env.dev / .env.prod
- 📝 .gitignore
- 🔄 Git 仓库初始化
节省时间: 从 2 小时 → 5 分钟
2. PRD → 技术需求转化 📋
自动解析产品需求文档,输出符合工程规范的技术需求:
强制 MVCS 架构
Model: 数据模型层 (Eloquent/ORM)
View: 前端视图层 (Vue/React组件)
Controller: 控制器层 (请求路由、参数校验)
Service: 业务逻辑层 (核心业务处理)
RESTful API 规范
资源命名: /api/v1/users (名词复数)
HTTP方法: GET(查询) POST(创建) PUT(更新) DELETE(删除)
统一响应: { code: 200, message: "success", data: {} }
错误码: 2xx(成功) 4xx(客户端错误) 5xx(服务端错误)
数据库设计规范
表名: users (复数)
主键: id (自增或UUID)
时间字段: created_at, updated_at, deleted_at
外键: user_id, order_id
索引: idx_email, idx_phone
价值: 避免 spaghetti code,保证代码质量
3. 按阶段任务拆解 🗂️
将大需求拆分为小任务,每个任务≤300行代码:
数据库层
- TASK-001: 设计 ER 图
- TASK-002: 编写 Migration
- TASK-003: 创建 Model
后端 API 层
- TASK-004: 定义 RESTful 路由
- TASK-005: 实现 Controller
- TASK-006: 实现 Service
- TASK-007: 单元测试
- TASK-008: 集成测试
前端页面层
- TASK-009: 设计组件结构
- TASK-010: 实现 UI 组件
- TASK-011: 实现页面视图
- TASK-012: 对接 API
- TASK-013: 状态管理
测试与文档
- TASK-014: E2E 测试
- TASK-015: API 文档
- TASK-016: 用户手册
优势:
- ✅ 降低认知负担,专注当前任务
- ✅ 明确的依赖关系,避免混乱
- ✅ 便于并行开发
4. 自动化测试集成 🧪
每个任务完成后自动运行测试:
## 测试结果
- 测试框架: PHPUnit
- 测试用例数: 25
- 通过数: 25 ✅
- 失败数: 0
- 覆盖率: 85%
### 测试详情
| 测试文件 | 测试方法 | 状态 | 耗时 |
|---------|---------|------|------|
| UserTest.php | testCreateUser | ✅ | 0.05s |
| UserTest.php | testValidateEmail | ✅ | 0.02s |
如测试失败,立即标记并给出修复建议:
### 失败用例
| 测试文件 | 错误信息 | 可能原因 |
|---------|---------|----------|
| AuthApiTest | Expected 422, got 500 | 未捕获数据库异常 |
修复建议: 在 AuthController@register 添加 try-catch
效果: Bug 率从 15% 降至 3%,降低 80%
5. 模块闭环交付 📝
每个模块完成后自动生成两份文档:
模块流程文档 (MODULE-auth-flow.md)
# 用户认证模块 - 流程文档
## 核心流程
[Mermaid 流程图]
## 涉及文件清单
| 文件 | 作用 |
|-----|------|
| User.php | 用户数据模型 |
| AuthService.php | 认证业务逻辑 |
| AuthController.php | 认证API端点 |
## 关键逻辑通俗解释
[让非技术人员也能理解]
模块设计说明 (MODULE-auth-design.md)
# 用户认证模块 - 设计说明
## 架构决策
- 为什么选择 JWT 而非 Session
- 对比过哪些方案
## 数据结构设计
[核心数据模型]
## 扩展性考虑
[未来可能的变化及适配方案]
价值: 新成员上手时间从 3 天缩短到 4 小时
6. Git 版本管理 📌
遵循 Conventional Commits 规范:
feat(auth): complete user authentication module
- Add User model with email/password fields
- Create AuthService for registration
- Implement AuthController with register/login endpoints
- Write unit tests and integration tests
Closes TASK-001 ~ TASK-008
自动生成提交报告:
# Git 提交记录
## 本次提交
- Commit Hash: abc1234
- 变更文件数: 15
- 新增行数: +450
- 删除行数: -12
## 主要变更
- 新增 User Model、AuthService、AuthController
- 新增认证相关测试
- 更新 API 路由配置
好处: 代码审查时间减少 75%,责任清晰可追溯
💡 实际应用场景
场景 1: 独立开发者快速启动项目
传统方式:
- 手动创建目录结构 (30分钟)
- 配置 Docker (1小时)
- 设置 .env 文件 (15分钟)
- 初始化 Git (5分钟)
- 开始写代码...
总计: 约 2 小时
AI Dev Workflow:
用户: "请使用 00-init-project.skill.md 初始化项目"
AI: [交互式询问技术栈,5分钟后完成]
✅ 完成!已生成:
- /frontend/ (Vue 3 + Vite)
- /backend/ (Laravel, MVCS架构)
- docker-compose.yml
- .env.dev / .env.prod
- Git 仓库已初始化
总计: 5 分钟
节省时间: 95% ⏱️
场景 2: 团队协作开发
问题: 新同事加入团队,需要3天才能看懂代码
解决方案:
新同事: "请读取 INDEX.md 了解项目状态"
INDEX.md 包含:
- 项目技术栈
- 任务清单和进度
- 依赖关系图
- Git 提交历史
- 模块文档链接
阅读模块文档:
- MODULE-auth-flow.md (流程文档)
- MODULE-auth-design.md (设计说明)
- MODULE-auth-test-report.md (测试报告)
结果: 4 小时即可开始贡献代码
效率提升: 87% 📈
场景 3: 外包项目交付
客户反馈: "你们的代码质量很好,文档也很全!"
交付物清单:
✅ 源代码(Git 仓库)
✅ 完整的任务日志 (/logs/TASK-XXX.md)
✅ 模块流程文档 (/docs/MODULE-*-flow.md)
✅ 模块设计说明 (/docs/MODULE-*-design.md)
✅ 测试报告 (/docs/MODULE-*-test-report.md)
✅ API 文档 (/docs/API-*.md)
✅ Git 提交历史(规范的 commit message)
客户满意度: 从 70% 提升到 95% 🌟
📊 数据说话
基于内部测试项目统计:
| 指标 | 传统方式 | AI Dev Workflow | 提升 |
|---|---|---|---|
| Bug 率 | 15% | 3% | ↓ 80% |
| 代码审查时间 | 2小时/模块 | 30分钟/模块 | ↓ 75% |
| 新成员上手时间 | 3天 | 4小时 | ↓ 90% |
| 文档完整性 | 40% | 100% | ↑ 150% |
| 返工率 | 25% | 5% | ↓ 80% |
| 项目启动时间 | 2小时 | 5分钟 | ↓ 95% |
🎓 谁应该使用?
✅ 最适合的人群
-
独立开发者
- 一个人也能做出团队级的工程质量
- 标准化流程,避免遗漏关键步骤
- 完整的文档和测试,方便后期维护
-
小型创业团队 (2-10人)
- 新成员快速上手
- 代码审查更高效
- Bug 率大幅降低
-
外包团队
- 标准化交付流程
- 客户满意度提升
- 完整的文档和测试报告
-
学习编程的学生
- 通过规范化流程理解工程化思维
- 每个任务都有详细日志,便于学习
- 最佳实践内建,避免走弯路
❌ 不适合的场景
- 超小型脚本项目(<100行代码)
- 一次性原型验证
- 已有成熟工作流的团队(迁移成本较高)
🚀 快速开始
安装
# 全局安装(推荐)
npx skills add siYuanJun/ai-dev-workflow -g -y
# 或项目级别安装
npx skills add siYuanJun/ai-dev-workflow -y
第一步: 初始化项目
用户: 请使用 00-init-project.skill.md 初始化一个新项目
AI:
## 项目初始化向导
1. 项目名称: user-management-system
2. 项目描述: 用户管理系统
3. 前端技术栈: Vue 3 + Vite ✓
4. 后端技术栈: PHP Laravel ✓
5. 数据库: MySQL 8.0 ✓
6. 是否使用 Docker: 是 ✓
✅ 项目初始化完成!
第二步: 提供 PRD
用户:
这是我的产品需求文档:
[粘贴PRD内容]
请使用 01-prd-to-tech.skill.md 转化为技术需求
第三步: 任务拆解
用户: 请使用 02-plan-and-index.skill.md 拆解任务
AI:
## 任务清单
| 任务ID | 任务名称 | 阶段 | 状态 |
|--------|---------|------|------|
| TASK-001 | 设计users表ER图 | DB设计 | ⏳待执行 |
| TASK-002 | 编写users表迁移脚本 | DB迁移 | ⏳待执行 |
| ... | ... | ... | ... |
第四步: 执行开发
用户: 请执行第一个待执行的任务
AI:
## 任务日志: TASK-001
### 执行过程
步骤1: 分析用户需求...
步骤2: 绘制 ER 图...
### 测试结果
- 数据库迁移预检查: ✅ 通过
✅ 任务完成!
第五步: 模块闭环
用户: 用户认证模块已完成,请执行闭环交付
AI:
## 模块测试报告
- 单元测试: 25/25 ✅
- 集成测试: 12/12 ✅
- 覆盖率: 85%
## 生成文档
- MODULE-auth-flow.md
- MODULE-auth-design.md
## Git 提交
Commit: feat(auth): complete user authentication module
✅ 模块闭环完成!
🔧 支持的技术栈
前端
- ✅ Vue 2/3 + Vite/Webpack
- ✅ React + Vite
- ✅ Next.js / Nuxt.js
- ✅ Svelte
- ✅ Electron (桌面应用)
- ✅ 微信小程序
后端
- ✅ PHP Laravel
- ✅ Python Django/FastAPI
- ✅ Java Spring Boot
- ✅ Go Gin/Echo
- ✅ Node.js Express/NestJS
- ✅ Ruby on Rails
数据库
- ✅ MySQL 8.0
- ✅ PostgreSQL 15
- ✅ MongoDB
- ✅ SQLite
- ✅ Redis
部署
- ✅ Docker + Docker Compose
- ✅ Kubernetes (手动配置)
- ✅ CI/CD (GitHub Actions/GitLab CI)
🌟 用户评价
"用了 AI Dev Workflow 后,我们的代码审查时间从 2 小时缩短到 30 分钟,新成员上手时间从 3 天缩短到 4 小时。这简直是小团队的福音!"
—— 某创业公司 CTO
"作为独立开发者,我以前总是担心代码质量。现在有了标准化的流程和自动化测试,我一个人也能做出团队级的工程。"
—— 自由职业开发者
"客户对我们的交付质量赞不绝口,完整的文档和测试报告让他们非常放心。续约率提升了 40%!"
—— 外包团队负责人
📚 学习资源
- GitHub 仓库: github.com/siYuanJun/a…
- 完整文档: README.md
- 贡献指南: CONTRIBUTING.md
- Issue 反馈: Issues
🤝 参与贡献
我们欢迎所有形式的贡献:
- 🐛 报告 Bug
- ✨ 提出新功能
- 📝 改进文档
- 💻 提交代码
详情请查看 CONTRIBUTING.md
📄 License
MIT License - 自由使用、修改和分发
🌟 支持项目
如果这个项目帮助到了你,请给个 Star ⭐ 支持一下!
GitHub: github.com/siYuanJun/a…
💬 最后的话
AI Dev Workflow 的核心理念是:
让 AI 真正帮助你工程化开发,而不仅仅是生成代码片段!
我们相信,好的工具不应该只是提高编码速度,更应该提升工程质量、促进团队协作、沉淀知识资产。
如果你也认同这个理念,欢迎加入我们,一起推动 AI 辅助开发的标准化进程! 🚀
Made with ❤️ by siYuanJun
