这是一套面向个人项目 AI Coding 的轻量级软件工程 Agent 系统。
目标是帮助你在使用 AI 编码时，不只是“让 AI 写代码”，而是建立一个相对完整、可追踪、可验证、可迭代的软件工程流程。
这套系统包含 8 个 Agent：
-
Orchestrator Agent / 项目编排 Agent
-
Product Agent / 产品需求 Agent
-
Design Agent / UIUX 设计 Agent
-
Architect Agent / 架构设计 Agent
-
Development Agent / 开发实现 Agent
-
QA Agent / 测试质量 Agent
-
Security & Review Agent / 安全与代码审查 Agent
-
DevOps & Release Agent / 部署发布 Agent
这套 Agent 系统用于解决 AI Coding 中常见的问题：
-
需求不清楚就开始写代码
-
AI 写出来的代码不可维护
-
前后端接口不一致
-
没有测试
-
没有 Code Review
-
没有安全检查
-
没有部署和回滚方案
-
上线后没有反馈闭环
-
项目越写越乱，后续难以维护
这套系统希望做到：
需求清楚
设计够用
架构轻量
开发可控
测试可验证
代码可审查
发布可回滚
反馈可迭代
负责整个项目流程的编排和推进。
-
判断当前项目阶段
-
拆分下一步任务
-
决定调用哪个 Agent
-
执行 DoR / DoD 检查
-
维护需求追踪关系
-
控制项目范围
-
推动下一轮迭代
我现在有一个项目想法，下一步应该做什么？
这个任务可以进入开发了吗？
这个功能可以发布了吗？
帮我判断当前项目缺少哪些东西。
负责将项目想法转化为产品需求。
-
市场/竞品分析
-
需求定义
-
MVP 范围定义
-
PRD 编写
-
用户故事编写
-
验收标准编写
-
开发任务初步拆分
PRD
MVP 范围
用户故事
验收标准
开发任务列表
需求追踪关系
我想做一个 AI 日程管理工具，帮我定义 MVP。
帮我把这个想法拆成用户故事和验收标准。
帮我写一个轻量 PRD。
负责将需求转化为用户流程、页面结构和交互说明。
-
用户流程设计
-
页面清单定义
-
页面结构说明
-
组件状态定义
-
表单校验说明
-
空状态/加载状态/错误状态设计
-
Figma 设计资产说明
-
设计验收标准
用户流程
页面清单
页面结构说明
组件清单
设计验收标准
Figma 说明
根据这个登录需求，帮我设计页面和交互。
帮我输出任务管理页面的页面结构。
帮我定义这个表单的状态和错误提示。
负责将产品需求和设计规格转化为技术方案。
-
技术选型
-
系统架构设计
-
模块划分
-
API 设计
-
数据库设计
-
鉴权方案
-
错误处理规范
-
日志规范
-
ADR 架构决策记录
技术架构说明
API Spec
Database Schema
鉴权设计
错误码规范
ADR
垂直切片开发建议
根据这个 PRD，帮我设计技术架构。
帮我设计登录功能的 API 和数据库表。
帮我判断这个项目应该用什么技术栈。
负责根据已经准备好的需求、设计和架构实现代码。
-
前端实现
-
后端实现
-
API 实现
-
数据库 migration
-
表单校验
-
错误处理
-
单元测试
-
前后端联调
-
验收标准自检
代码变更
数据库迁移
测试说明
实现报告
验收标准自检
根据这个任务，实现登录功能。
根据这个 API Spec，实现后端接口。
根据这个设计规格，实现页面组件。
负责测试计划、测试用例、边界条件、冒烟测试和回归测试。
-
测试计划制定
-
测试用例设计
-
验收标准映射
-
边界条件测试
-
异常场景测试
-
冒烟测试清单
-
回归测试清单
-
缺陷报告模板
-
发布建议
测试计划
测试用例
边界测试
异常测试
冒烟测试清单
回归测试清单
缺陷报告
根据这个登录功能，帮我设计测试用例。
帮我检查这个验收标准是否可测试。
帮我生成发布前冒烟测试清单。
负责代码审查、安全审查和发布风险判断。
-
Code Review
-
安全审查
-
OWASP Top 10 检查
-
鉴权/授权检查
-
输入校验检查
-
敏感信息泄露检查
-
依赖风险检查
-
测试覆盖检查
-
架构一致性检查
-
是否建议合并判断
Code Review 报告
安全审查报告
阻塞问题
非阻塞建议
测试缺口
发布风险
帮我 review 这次登录功能代码。
帮我检查这段 API 是否有安全问题。
帮我判断这个 PR 是否可以合并。
负责构建、部署、CI/CD、发布、监控、回滚和反馈闭环。
-
环境变量管理
-
构建和测试命令整理
-
CI/CD 流程设计
-
部署步骤设计
-
数据库 migration 发布策略
-
发布前检查
-
上线后验证
-
回滚方案
-
Release Note
-
监控和日志建议
部署说明
CI/CD 流程
环境变量清单
发布检查清单
回滚方案
Release Note
上线后验证清单
帮我设计这个项目的部署流程。
这个版本可以上线了吗？
帮我生成 Release Note 和回滚方案。
建议按照以下流程使用这套 Agent。
项目想法
↓
Orchestrator Agent 判断阶段
↓
Product Agent 定义需求
↓
Design Agent 输出页面和交互
↓
Architect Agent 输出技术方案
↓
QA Agent 提前设计测试用例
↓
Development Agent 实现功能
↓
Security & Review Agent 审查代码
↓
QA Agent 验证功能
↓
DevOps & Release Agent 部署发布
↓
线上监控和用户反馈
↓
Orchestrator Agent 进入下一轮迭代
如果你做的是个人小项目，不需要每次都完整调用所有 Agent。
最小流程可以是：
Product Agent
↓
Architect Agent
↓
Development Agent
↓
Security & Review Agent
↓
DevOps & Release Agent
如果涉及页面较复杂，增加：
Design Agent
如果涉及核心功能或上线发布，增加：
QA Agent
如果你不知道下一步该做什么，优先调用：
Orchestrator Agent
不要一次性做完整个产品。
推荐按垂直切片开发。
一个垂直切片包括：
一个用户故事
↓
页面/交互
↓
API
↓
数据库
↓
业务逻辑
↓
测试
↓
Review
↓
部署验证
例如：
切片 1：用户注册
切片 2：用户登录
切片 3：创建任务
切片 4：查看任务列表
切片 5：编辑任务
切片 6：删除任务
每个切片都应该可以独立验证。
你可以在项目中建立一个 docs 目录，用于存放 Agent 产物。
project-root/
docs/
product/
prd.md
user-stories.md
acceptance-criteria.md
design/
user-flow.md
page-spec.md
design-spec.md
architecture/
architecture.md
api-spec.md
database-schema.md
adr/
qa/
test-plan.md
test-cases.md
regression-checklist.md
review/
code-review-report.md
security-review-report.md
devops/
deployment.md
env.md
rollback.md
release-note.md
project/
backlog.md
traceability-matrix.md
iteration-plan.md
建议维护一条轻量追踪链：
需求 ID → 用户故事 → 验收标准 → 设计稿 → API → 数据表 → 代码 PR → 测试用例 → 发布版本 → 用户反馈
示例：
REQ-001 用户登录
├── US-001 邮箱密码登录
├── AC-001 登录成功后进入工作台
├── PAGE-001 登录页
├── API-001 POST /api/auth/login
├── DB-001 users
├── PR-003 login feature
├── TC-001 登录成功测试
└── Release v0.1.0
任务开始开发前，需要满足 DoR。
有需求 ID
有用户故事
有验收标准
有优先级
有 UI 或交互说明
有 API 或数据依赖说明
有边界条件说明
没有关键未决问题
任务范围足够小
如果不满足 DoR，不建议让 Development Agent 开始写代码。
任务完成时，需要满足 DoD。
功能实现完成
验收标准全部满足
关键测试通过
Lint 通过
Type Check 通过
Build 通过
Code Review 通过
无高危安全问题
文档或接口说明已更新
可以部署验证
如果不满足 DoD，不建议合并或发布。
每个 Agent 都有独立 Prompt。
推荐使用方式：
为每个 Agent 开一个独立对话，把对应 Agent Prompt 作为系统提示词。
适合：
长期维护某个 Agent
上下文清晰
输出稳定
在同一对话里手动指定：
请以 Product Agent 的身份处理以下内容：
……
或者：
请以 Architect Agent 的身份，根据以下 PRD 输出技术架构：
……
适合：
个人快速使用
不想维护多个会话
先把项目状态交给 Orchestrator Agent，让它判断下一步应该调用哪个 Agent。
例如：
这是当前项目状态：
- 已有 PRD
- 已有登录页面设计
- 缺少 API 设计
- 还没有测试用例
请作为 Orchestrator Agent 判断下一步该调用哪个 Agent。
它可能会建议：
下一步调用 Architect Agent 补充登录 API、用户表和鉴权方案。
然后调用 QA Agent 设计登录测试用例。
1. Orchestrator Agent
让它判断项目初始阶段和下一步。
2. Product Agent
输出 PRD、MVP、用户故事、验收标准。
3. Design Agent
输出用户流程、页面清单、页面结构。
4. Architect Agent
输出技术架构、API、数据库、ADR。
5. QA Agent
输出测试用例和验收覆盖。
6. Development Agent
按垂直切片实现第一个功能。
7. Security & Review Agent
审查代码和安全风险。
8. QA Agent
根据实现进行验证。
9. DevOps & Release Agent
部署上线并生成 Release Note。
例如开发登录功能：
1. Product Agent
输出登录功能用户故事和验收标准。
2. Design Agent
输出登录页面结构和状态。
3. Architect Agent
输出登录 API、users 表、鉴权方案。
4. QA Agent
输出登录测试用例。
5. Development Agent
实现登录页面、登录接口和测试。
6. Security & Review Agent
检查密码、token、日志、权限和测试覆盖。
7. DevOps & Release Agent
发布到测试环境或生产环境。
请以 Product Agent 的身份处理以下项目想法。
项目想法：
……
我的目标：
……
约束：
……
请输出：
- MVP 范围
- PRD
- 用户故事
- 验收标准
- 开发任务拆分
请以 Design Agent 的身份，根据以下 PRD 和用户故事输出设计规格。
PRD：
……
用户故事：
……
验收标准：
……
请输出：
- 用户流程
- 页面清单
- 页面结构
- 组件状态
- 设计验收标准
请以 Architect Agent 的身份，根据以下需求和设计规格输出技术架构。
需求：
……
设计规格：
……
约束：
……
请输出：
- 技术选型
- 系统架构
- API 设计
- 数据库设计
- 鉴权方案
- ADR
请以 Development Agent 的身份实现以下任务。
Task ID：
用户故事：
验收标准：
设计规格：
API Spec：
数据库设计：
技术栈：
当前代码结构：
请先输出：
- 需求理解
- DoR 检查
- 实现计划
- 涉及文件
- 风险点
等我确认后再开始写代码。
请以 QA Agent 的身份，根据以下用户故事和验收标准设计测试用例。
用户故事：
……
验收标准：
……
API：
……
页面：
……
请输出：
- 测试范围
- 测试用例
- 边界条件
- 异常场景
- 冒烟测试清单
- 回归测试清单
请以 Security & Review Agent 的身份 review 以下代码变更。
需求：
……
验收标准：
……
架构/API说明：
……
代码 diff：
……
测试结果：
……
请输出：
- 是否建议合并
- 阻塞问题
- 非阻塞建议
- 安全风险
- 测试缺口
- 修复建议
请以 DevOps & Release Agent 的身份，帮我判断当前版本是否可以发布。
版本：
发布范围：
技术栈：
部署平台：
构建命令：
测试命令：
QA 结果：
Review 结果：
环境变量：
数据库 migration：
已知问题：
请输出：
- 发布前检查
- 部署步骤
- 回滚方案
- 上线后验证
- Release Note
- 是否建议发布
最小质量门禁：
Lint 通过
Type Check 通过
关键测试通过
Build 成功
Code Review 通过
无高危安全问题
可回滚
如果你的项目是 Web 应用，建议至少配置：
npm run lint
npm run typecheck
npm run test
npm run build如果暂时没有自动化测试，也要保留：
手工验证步骤
冒烟测试清单
回归检查清单
推荐使用语义化版本：
v0.1.0 MVP 首次可用版本
v0.2.0 新增主要功能
v0.2.1 修复 Bug
v1.0.0 第一个稳定版本
每次发布建议记录：
版本号
发布时间
新增功能
修复问题
已知问题
关联需求
回滚说明
这套系统的核心原则是：
用轻量文档保证完整性
用垂直切片保证敏捷性
用自动化测试保证质量
用 Code Review 控制风险
用发布回滚保证稳定
用反馈闭环推动迭代
你不需要每次都完整跑完所有 Agent。
但是以下几个点不建议省略：
需求要有验收标准
开发前要过 DoR
合并前要 Review
发布前要测试
上线前要有回滚方案
上线后要有反馈闭环
错误方式：
帮我做一个完整的任务管理系统。
推荐方式：
先帮我定义 MVP。
然后拆成用户故事。
然后先实现“创建任务”这个垂直切片。
推荐让 Development Agent 先输出：
需求理解
实现计划
涉及文件
风险点
确认后再让它写代码。
推荐任务粒度：
0.5 天到 2 天能完成
能独立验证
能独立 review
最好对应一个用户故事
文档不需要很长，但必须清楚。
推荐：
一页 PRD
一页架构说明
一页 API 说明
一页测试计划
一页发布说明
这套 8 Agent 系统适合个人 AI Coding 项目。
它不是为了让流程变复杂，而是为了避免 AI Coding 失控。
最终工作方式应该是：
Orchestrator 控流程
Product 定需求
Design 定体验
Architect 定架构
Development 写代码
QA 做验证
Security & Review 控风险
DevOps & Release 管发布
最推荐的开发节奏是：
小需求
轻设计
轻架构
垂直切片开发
自动化验证
代码审查
小步发布
线上反馈
下一轮迭代