@zeyue0329/xiaoma-cli 1.0.41 → 1.0.43
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.idea/workspace.xml +23 -2
- package/JAVA-BACKEND-COMMANDS-REFERENCE.md +2 -2
- package/JAVA-BACKEND-ITERATION-GUIDE.md +31 -31
- package/dist/agents/architect.txt +1 -1
- package/dist/agents/pm.txt +20 -20
- package/dist/agents/po.txt +1 -1
- package/dist/agents/sm.txt +1 -1
- package/dist/agents/workflow-executor.txt +170 -20
- package/dist/agents/xiaoma-master.txt +20 -20
- package/dist/teams/team-all.txt +193 -43
- package/dist/teams/team-fullstack-with-database.txt +24 -24
- package/dist/teams/team-fullstack.txt +22 -22
- package/dist/teams/team-ide-minimal.txt +2 -2
- package/dist/teams/team-no-ui.txt +22 -22
- package/docs/architecture-sharding-modification.md +4 -4
- package/docs/automated-requirements-analysis-outputs.md +29 -29
- package/docs/prd/workflow-coordinator-prd.md +2 -2
- package/package.json +6 -1
- package/tools/api-server.js +367 -0
- package/xiaoma-core/agents/pm.md +1 -1
- package/xiaoma-core/agents/po.md +1 -1
- package/xiaoma-core/agents/requirements-coverage-auditor.yaml +1 -1
- package/xiaoma-core/agents/sm.md +1 -1
- package/xiaoma-core/agents/workflow-executor.md +174 -20
- package/xiaoma-core/tasks/batch-story-generation.md +1 -1
- package/xiaoma-core/tasks/requirements-coverage-audit.md +5 -5
- package/xiaoma-core/templates/fullstack-architecture-tmpl.yaml +1 -1
- package/xiaoma-core/templates/prd-tmpl.yaml +19 -19
- package/xiaoma-core/templates/requirements-coverage-audit.yaml +6 -6
- package/xiaoma-core/workflows/automated-requirements-analysis.yaml +90 -90
- package/xiaoma-core/workflows/automated-requirements-development.yaml +739 -0
- package/xiaoma-core/workflows/enhanced-fullstack-with-qa-loop.yaml +1 -1
- package/xiaoma-core/workflows/full-requirement-automation.yaml +1 -1
|
@@ -4879,7 +4879,7 @@ sections:
|
|
|
4879
4879
|
1. 如果是 REST API, 创建一个 OpenAPI 3.0 规范
|
|
4880
4880
|
2. 如果是 GraphQL, 提供 GraphQL 模式
|
|
4881
4881
|
3. 如果是 tRPC, 展示路由定义
|
|
4882
|
-
4.
|
|
4882
|
+
4. 包括来自模块/故事的所有端点
|
|
4883
4883
|
5. 基于数据模型定义请求/响应模式
|
|
4884
4884
|
6. 记录认证要求
|
|
4885
4885
|
7. 包括请求/响应示例
|
|
@@ -5795,7 +5795,7 @@ sections:
|
|
|
5795
5795
|
title: 关键交互范式
|
|
5796
5796
|
- id: core-screens
|
|
5797
5797
|
title: 核心屏幕与视图
|
|
5798
|
-
instruction: 从产品角度看,为实现 PRD
|
|
5798
|
+
instruction: 从产品角度看,为实现 PRD 的价值和目标,最关键的屏幕或视图是什么?这旨在提供概念性的高层概览,以驱动粗略的模块或用户故事。
|
|
5799
5799
|
examples:
|
|
5800
5800
|
- "登录屏幕"
|
|
5801
5801
|
- "主仪表盘"
|
|
@@ -5845,38 +5845,38 @@ sections:
|
|
|
5845
5845
|
instruction: 在起草本文档的整个过程中,如果提出或发现任何其他适合架构师的技术假设,请在此处作为额外的项目符号添加。
|
|
5846
5846
|
|
|
5847
5847
|
- id: epic-list
|
|
5848
|
-
title:
|
|
5848
|
+
title: 模块列表
|
|
5849
5849
|
instruction: |
|
|
5850
|
-
|
|
5850
|
+
向用户呈现一份高层次的模块列表以供批准。每个模块应有一个标题和一个简短的(1句话)目标陈述。这使用户能在深入细节之前审阅整体结构。
|
|
5851
5851
|
|
|
5852
|
-
|
|
5852
|
+
关键:模块必须遵循敏捷最佳实践,保持逻辑上的顺序:
|
|
5853
5853
|
|
|
5854
|
-
-
|
|
5855
|
-
-
|
|
5856
|
-
-
|
|
5857
|
-
-
|
|
5858
|
-
-
|
|
5859
|
-
-
|
|
5854
|
+
- 每个模块都应交付一个重要的、端到端的、完全可部署且可测试的功能增量。
|
|
5855
|
+
- 模块 1 必须建立基础项目设施(应用设置、Git、CI/CD、核心服务),除非我们是向现有应用添加新功能。同时,它还应交付一个初始功能,即使只是一个健康检查路由或一个简单的金丝雀页面显示——在为第一个模块编写用户故事时要记住这一点!
|
|
5856
|
+
- 每个后续的模块都在之前模块功能的基础上构建,交付主要的功能模块,这些模块在部署时能为用户或业务提供切实的价值。
|
|
5857
|
+
- 并非每个项目都需要多个模块,一个模块需要交付价值。例如,一个已完成的 API 即使 UI 尚未完成并计划在另一个模块中实现,也可以交付价值。
|
|
5858
|
+
- 倾向于设置较少的模块,但要告知用户你的理由,并提供拆分选项,如果某些模块看起来太大或关注点分散的话。
|
|
5859
|
+
- 横切关注点应该贯穿于模块和用户故事中,而不是作为最后的用户故事。例如,在一个模块的最后一个故事中添加日志框架,或者在项目结束时作为最后一个模块或故事来做,这将非常糟糕,因为我们从一开始就没有日志记录。
|
|
5860
5860
|
elicit: true
|
|
5861
5861
|
examples:
|
|
5862
|
-
- "
|
|
5863
|
-
- "
|
|
5864
|
-
- "
|
|
5865
|
-
- "
|
|
5862
|
+
- "模块 1:基础与核心设施:建立项目设置、认证和基本用户管理"
|
|
5863
|
+
- "模块 2:核心业务实体:创建和管理主要领域对象的 CRUD 操作"
|
|
5864
|
+
- "模块 3:用户工作流与交互:实现关键用户旅程和业务流程"
|
|
5865
|
+
- "模块 4:报告与分析:为用户提供洞察和数据可视化"
|
|
5866
5866
|
|
|
5867
5867
|
- id: epic-details
|
|
5868
|
-
title:
|
|
5868
|
+
title: 模块 {{epic_number}} {{epic_title}}
|
|
5869
5869
|
repeatable: true
|
|
5870
5870
|
instruction: |
|
|
5871
|
-
|
|
5871
|
+
在模块列表被批准后,将每个模块及其所有的用户故事和验收标准作为一个完整的审查单元呈现。
|
|
5872
5872
|
|
|
5873
|
-
|
|
5873
|
+
为每个模块提供扩展的目标(2-3 句话描述所有故事将实现的目标和价值)。
|
|
5874
5874
|
|
|
5875
5875
|
关键的用户故事排序要求:
|
|
5876
5876
|
|
|
5877
|
-
-
|
|
5877
|
+
- 每个模块中的用户故事必须在逻辑上是顺序的。
|
|
5878
5878
|
- 每个故事都应该是一个“垂直切片”,交付完整的功能,除了项目基础的早期使能型故事。
|
|
5879
|
-
-
|
|
5879
|
+
- 任何故事都不应依赖于后续故事或模块的工作。
|
|
5880
5880
|
- 识别并注明任何直接的前置故事。
|
|
5881
5881
|
- 关注“做什么”和“为什么”,而不是“怎么做”(将技术实现留给架构师),但要足够精确以支持故事之间逻辑上顺序的操作。
|
|
5882
5882
|
- 确保每个故事都交付明确的用户或业务价值,尽量避免使能型故事,而是将它们构建到交付价值的故事中。
|
package/dist/teams/team-all.txt
CHANGED
|
@@ -1230,7 +1230,7 @@ commands:
|
|
|
1230
1230
|
- create-brownfield-epic: 运行任务 brownfield-create-epic.md
|
|
1231
1231
|
- create-brownfield-prd: 使用模板 brownfield-prd-tmpl.yaml 运行任务 create-doc.md
|
|
1232
1232
|
- create-brownfield-story: 运行任务 brownfield-create-story.md
|
|
1233
|
-
- create-epic:
|
|
1233
|
+
- create-epic: 为现有项目项目创建模块 (任务 brownfield-create-epic)
|
|
1234
1234
|
- create-prd: 使用模板 prd-tmpl.yaml 运行任务 create-doc.md
|
|
1235
1235
|
- create-story: 从需求创建用户故事 (任务 brownfield-create-story)
|
|
1236
1236
|
- doc-out: 将完整文档输出到当前目标文件
|
|
@@ -1294,7 +1294,7 @@ persona:
|
|
|
1294
1294
|
commands:
|
|
1295
1295
|
- help: 显示以下命令的编号列表以供选择
|
|
1296
1296
|
- correct-course: 执行 correct-course 任务
|
|
1297
|
-
- create-epic:
|
|
1297
|
+
- create-epic: 为现有项目项目创建模块 (任务 brownfield-create-epic)
|
|
1298
1298
|
- create-story: 从需求创建用户故事 (任务 brownfield-create-story)
|
|
1299
1299
|
- doc-out: 将完整文档输出到当前目标文件
|
|
1300
1300
|
- execute-checklist-po: 运行任务 execute-checklist (清单 po-master-checklist)
|
|
@@ -1402,7 +1402,7 @@ agent:
|
|
|
1402
1402
|
id: sm
|
|
1403
1403
|
title: Scrum Master
|
|
1404
1404
|
icon: 🏃
|
|
1405
|
-
whenToUse:
|
|
1405
|
+
whenToUse: 用于创建故事、模块管理、在派对模式下进行回顾以及敏捷流程指导
|
|
1406
1406
|
customization: null
|
|
1407
1407
|
persona:
|
|
1408
1408
|
role: 技术 Scrum Master - 故事准备专家
|
|
@@ -1523,11 +1523,12 @@ persona:
|
|
|
1523
1523
|
- 自动切换智能体:根据工作流定义,自动使用 /analyst、/architect、/pm、/po、/sm、/dev、/qa 等命令切换到相应的智能体角色
|
|
1524
1524
|
- 连续执行模式:完成一个步骤后,立即显示简短进度(1-2行)并**无需任何确认**直接进入下一个步骤,直到整个工作流完成或遇到真正的技术错误
|
|
1525
1525
|
- 🚫 严禁中断询问:不要问'是否继续'、'请选择'、'您希望'等问题。用户启动工作流就是明确要求自动执行到底。唯一允许暂停的情况:文件不存在、执行报错、质量门控失败。
|
|
1526
|
-
- '✅ 正确的进度报告格式:简短报告 + 立即继续,例如:''✅ 步骤 3/6 完成: PM 创建 PRD → 立即开始步骤 4/6: PM
|
|
1526
|
+
- '✅ 正确的进度报告格式:简短报告 + 立即继续,例如:''✅ 步骤 3/6 完成: PM 创建 PRD → 立即开始步骤 4/6: PM 拆分模块...'''
|
|
1527
1527
|
commands:
|
|
1528
1528
|
- help: 显示以下命令的编号列表以供选择
|
|
1529
1529
|
- run-requirements-analysis: 🔥 自动化需求分析工作流(完全自动执行,不暂停)- 加载 automated-requirements-analysis.yaml 并连续执行所有 6 个步骤,从 req.txt 到最终的架构设计文档,全程自动化无需人工干预
|
|
1530
1530
|
- run-story-development: 🔥 自动化用户故事开发工作流(完全自动执行,不暂停)- 加载 automated-story-development.yaml 并循环执行所有用户故事的 SM→PO→Dev→QA 完整开发周期,全程自动化无需人工干预
|
|
1531
|
+
- run-requirements-development: '🔥🔥🔥 端到端全自动化工作流(完全自动执行,不暂停)- 加载 automated-requirements-development.yaml 并连续执行从需求分析到用户故事开发完成的完整流程 (阶段1: 需求分析 6步 + 阶段2: 用户故事开发循环), 实现从 req.txt 到所有代码完成的端到端自动化'
|
|
1531
1532
|
- status: 显示当前工作流执行状态和进度
|
|
1532
1533
|
- validate-prerequisites: 验证工作流执行的前置条件
|
|
1533
1534
|
- resume-workflow: 从上次中断的位置恢复工作流执行(同样会自动连续执行剩余步骤)
|
|
@@ -1537,6 +1538,7 @@ dependencies:
|
|
|
1537
1538
|
workflows:
|
|
1538
1539
|
- automated-requirements-analysis.yaml
|
|
1539
1540
|
- automated-story-development.yaml
|
|
1541
|
+
- automated-requirements-development.yaml
|
|
1540
1542
|
```
|
|
1541
1543
|
|
|
1542
1544
|
---
|
|
@@ -1601,7 +1603,7 @@ workflow_stages:
|
|
|
1601
1603
|
tasks:
|
|
1602
1604
|
- 创建 Brownfield 项目迭代需求的 PRD 文档
|
|
1603
1605
|
- 定义功能模块、数据变更、API 规范
|
|
1604
|
-
-
|
|
1606
|
+
- 制定验收标准和模块拆分建议
|
|
1605
1607
|
- 自检 PRD 质量(16项检查)
|
|
1606
1608
|
outputs:
|
|
1607
1609
|
- docs/prd/brownfield-iteration-prd.md
|
|
@@ -1609,15 +1611,15 @@ workflow_stages:
|
|
|
1609
1611
|
stage_4_pm_epics:
|
|
1610
1612
|
agent: pm
|
|
1611
1613
|
command: "*create-epic"
|
|
1612
|
-
duration: "
|
|
1614
|
+
duration: "变动,取决于模块数量"
|
|
1613
1615
|
tasks:
|
|
1614
|
-
- 从 PRD
|
|
1615
|
-
-
|
|
1616
|
+
- 从 PRD 提取模块清单
|
|
1617
|
+
- 循环创建每个模块文档
|
|
1616
1618
|
- 初步识别用户故事
|
|
1617
1619
|
- 定义技术设计概要和数据库/API 变更
|
|
1618
|
-
-
|
|
1620
|
+
- 验证模块质量
|
|
1619
1621
|
outputs:
|
|
1620
|
-
- docs/epics
|
|
1622
|
+
- docs/epics/Epic-*.md (多个模块文件)
|
|
1621
1623
|
|
|
1622
1624
|
stage_5_architect_design:
|
|
1623
1625
|
agent: architect
|
|
@@ -1626,7 +1628,7 @@ workflow_stages:
|
|
|
1626
1628
|
duration: "30-40分钟"
|
|
1627
1629
|
inputs:
|
|
1628
1630
|
- docs/prd/brownfield-iteration-prd.md
|
|
1629
|
-
- docs/epics
|
|
1631
|
+
- docs/epics/Epic-*.md
|
|
1630
1632
|
- docs/architecture/current-architecture-analysis.md
|
|
1631
1633
|
tasks:
|
|
1632
1634
|
- 设计新增数据模型(Entity + DDL)
|
|
@@ -1650,7 +1652,77 @@ workflow_stages:
|
|
|
1650
1652
|
|
|
1651
1653
|
---
|
|
1652
1654
|
|
|
1653
|
-
### 2.
|
|
1655
|
+
### 2. 🔥🔥🔥 端到端全自动化工作流 (新增)
|
|
1656
|
+
|
|
1657
|
+
**命令**: `*run-requirements-development`
|
|
1658
|
+
|
|
1659
|
+
**功能**: 执行从需求分析到用户故事开发完成的完整端到端自动化流程
|
|
1660
|
+
|
|
1661
|
+
**工作流文件**: `xiaoma-core/workflows/automated-requirements-development.yaml`
|
|
1662
|
+
|
|
1663
|
+
**核心价值**:
|
|
1664
|
+
- ✅ **一键启动**: 只需执行一个命令,完成从 req.txt 到所有代码的端到端开发
|
|
1665
|
+
- ✅ **无缝衔接**: 需求分析阶段自动衔接用户故事开发阶段,无需人工干预
|
|
1666
|
+
- ✅ **全程自动化**: 整合了两个子工作流的所有优势,实现完整的自动化流程
|
|
1667
|
+
- ✅ **质量保证**: 两个阶段的所有质量门控都会自动执行
|
|
1668
|
+
|
|
1669
|
+
**执行流程**:
|
|
1670
|
+
|
|
1671
|
+
```yaml
|
|
1672
|
+
端到端工作流结构:
|
|
1673
|
+
|
|
1674
|
+
阶段 1: 需求分析阶段 (1.5-2.5小时)
|
|
1675
|
+
├─ 步骤 0/6: 前置环境验证
|
|
1676
|
+
├─ 步骤 1/6: Analyst 需求分析
|
|
1677
|
+
├─ 步骤 2/6: Architect 架构分析
|
|
1678
|
+
├─ 步骤 3/6: PM 创建 PRD
|
|
1679
|
+
├─ 步骤 4/6: PM 拆分模块
|
|
1680
|
+
├─ 步骤 5/6: Architect 架构设计
|
|
1681
|
+
└─ 步骤 6/6: 生成需求分析报告
|
|
1682
|
+
↓
|
|
1683
|
+
阶段间验证(无缝衔接)
|
|
1684
|
+
↓
|
|
1685
|
+
阶段 2: 用户故事开发阶段 (40-70分钟/故事)
|
|
1686
|
+
循环执行(直到所有用户故事完成):
|
|
1687
|
+
├─ 步骤 1: SM 创建用户故事
|
|
1688
|
+
├─ 步骤 1.5: 快速构建验证
|
|
1689
|
+
├─ 步骤 2: PO 验证故事
|
|
1690
|
+
├─ 步骤 2.5: 预开发构建检查
|
|
1691
|
+
├─ 步骤 3: Dev 开发故事
|
|
1692
|
+
├─ 步骤 4: QA 测试验证
|
|
1693
|
+
└─ 步骤 5: 质量门控决策
|
|
1694
|
+
↓
|
|
1695
|
+
生成端到端完成报告
|
|
1696
|
+
```
|
|
1697
|
+
|
|
1698
|
+
**总耗时**:
|
|
1699
|
+
- 阶段 1(需求分析): 约 1.5-2.5 小时
|
|
1700
|
+
- 阶段 2(用户故事开发): 约 40-70 分钟 × 用户故事数量
|
|
1701
|
+
- **典型小型项目(5-10个故事)**: 4-8 小时
|
|
1702
|
+
- **典型中型项目(10-20个故事)**: 8-16 小时
|
|
1703
|
+
|
|
1704
|
+
**成功标准**:
|
|
1705
|
+
|
|
1706
|
+
阶段 1 成功标准:
|
|
1707
|
+
- ✅ 所有需求分析文档生成完成
|
|
1708
|
+
- ✅ PRD 和 Epic 文档创建完成
|
|
1709
|
+
- ✅ 架构设计和数据库脚本生成完成
|
|
1710
|
+
- ✅ 所有质量门控通过
|
|
1711
|
+
|
|
1712
|
+
阶段 2 成功标准:
|
|
1713
|
+
- ✅ 所有用户故事状态为 Done
|
|
1714
|
+
- ✅ 所有测试通过(覆盖率 ≥80%)
|
|
1715
|
+
- ✅ 所有 QA 质量门控通过
|
|
1716
|
+
- ✅ 代码质量达标
|
|
1717
|
+
|
|
1718
|
+
整体成功标准:
|
|
1719
|
+
- ✅ 两个阶段全部完成
|
|
1720
|
+
- ✅ 完整的文档和代码生成
|
|
1721
|
+
- ✅ 准备就绪进入集成测试和部署阶段
|
|
1722
|
+
|
|
1723
|
+
---
|
|
1724
|
+
|
|
1725
|
+
### 3. 自动化用户故事开发工作流
|
|
1654
1726
|
|
|
1655
1727
|
**命令**: `*run-story-development`
|
|
1656
1728
|
|
|
@@ -1836,6 +1908,84 @@ quality_gates:
|
|
|
1836
1908
|
|
|
1837
1909
|
## 📊 使用示例
|
|
1838
1910
|
|
|
1911
|
+
### 🔥🔥🔥 执行端到端全自动化工作流(推荐)
|
|
1912
|
+
|
|
1913
|
+
```bash
|
|
1914
|
+
# 1. 准备工作
|
|
1915
|
+
# 确保 docs/req.txt 文件存在且包含 PM 提供的需求
|
|
1916
|
+
|
|
1917
|
+
# 2. 激活工作流执行器
|
|
1918
|
+
/workflow-executor
|
|
1919
|
+
|
|
1920
|
+
# 3. 执行端到端全自动化工作流(完全自动化,一键到底)
|
|
1921
|
+
*run-requirements-development
|
|
1922
|
+
|
|
1923
|
+
# ⚡ 核心优势:一个命令完成从需求分析到代码实现的全部工作!
|
|
1924
|
+
# ⚠️ 重要提示:工作流执行器会自动连续执行两个阶段的所有步骤,不会在中间暂停
|
|
1925
|
+
# 如果工作流在某个步骤停止,说明遇到了错误或质量门控失败,请查看错误信息
|
|
1926
|
+
|
|
1927
|
+
# 工作流执行器将自动完成以下所有工作(典型小项目 4-8 小时):
|
|
1928
|
+
#
|
|
1929
|
+
# 【阶段 1: 需求分析】(约 1.5-2.5 小时)
|
|
1930
|
+
# ✓ 步骤 0/6: 前置环境验证
|
|
1931
|
+
# ✓ 步骤 1/6: Analyst 需求分析 → 生成需求分析报告
|
|
1932
|
+
# ✓ 步骤 2/6: Architect 架构分析 → 生成架构分析报告
|
|
1933
|
+
# ✓ 步骤 3/6: PM 创建 PRD → 生成 Brownfield PRD
|
|
1934
|
+
# ✓ 步骤 4/6: PM 拆分模块 → 生成 Epic 文档
|
|
1935
|
+
# ✓ 步骤 5/6: Architect 架构设计 → 生成架构设计和数据库脚本
|
|
1936
|
+
# ✓ 步骤 6/6: 生成需求分析完成报告
|
|
1937
|
+
# ↓
|
|
1938
|
+
# ✓ 阶段间无缝衔接验证
|
|
1939
|
+
# ↓
|
|
1940
|
+
# 【阶段 2: 用户故事开发】(约 40-70 分钟 × 故事数量)
|
|
1941
|
+
# 对每个用户故事循环执行:
|
|
1942
|
+
# ✓ SM 创建用户故事 → 快速构建验证
|
|
1943
|
+
# ✓ PO 验证故事(10步验证)
|
|
1944
|
+
# ✓ 预开发构建检查
|
|
1945
|
+
# ✓ Dev 开发实现 + 自测
|
|
1946
|
+
# ✓ QA 测试验证(真实数据测试)
|
|
1947
|
+
# ✓ 质量门控决策 → Done
|
|
1948
|
+
# 直到所有用户故事完成
|
|
1949
|
+
# ↓
|
|
1950
|
+
# ✓ 生成端到端完成报告
|
|
1951
|
+
|
|
1952
|
+
# 4. 工作流完成后检查所有输出
|
|
1953
|
+
# 阶段 1 输出:
|
|
1954
|
+
# - docs/requirements/requirements-analysis.md
|
|
1955
|
+
# - docs/architecture/current-architecture-analysis.md
|
|
1956
|
+
# - docs/prd/brownfield-iteration-prd.md
|
|
1957
|
+
# - docs/epics/Epic-*.md
|
|
1958
|
+
# - docs/architecture/iteration-backend-design.md
|
|
1959
|
+
# - docs/architecture/db-migration-scripts.sql
|
|
1960
|
+
# - docs/architecture/*.md (7个模块文档)
|
|
1961
|
+
#
|
|
1962
|
+
# 阶段 2 输出:
|
|
1963
|
+
# - docs/stories/epic{X}-story{Y}.md (所有故事状态: Done)
|
|
1964
|
+
# - src/ 目录下的实现代码
|
|
1965
|
+
# - 测试报告
|
|
1966
|
+
# - QA gate 文件
|
|
1967
|
+
#
|
|
1968
|
+
# 完成报告:
|
|
1969
|
+
# - docs/end-to-end-completion-report.md
|
|
1970
|
+
```
|
|
1971
|
+
|
|
1972
|
+
**🌟 端到端工作流的特殊优势**:
|
|
1973
|
+
|
|
1974
|
+
- ✅ **一键到底**: 只需一个命令,无需在两个阶段间手动切换
|
|
1975
|
+
- ✅ **无缝衔接**: 阶段1完成后自动验证并进入阶段2,完全自动化
|
|
1976
|
+
- ✅ **全程监控**: 统一的进度追踪和质量控制
|
|
1977
|
+
- ✅ **完整报告**: 生成包含两个阶段的综合完成报告
|
|
1978
|
+
- ✅ **节省时间**: 避免手动操作和阶段间切换的开销
|
|
1979
|
+
- ⚠️ **执行时长**: 适合有充足时间的场景(典型小项目 4-8 小时)
|
|
1980
|
+
|
|
1981
|
+
**🔥 适用场景**:
|
|
1982
|
+
- 从零开始的新需求迭代
|
|
1983
|
+
- 需要完整的需求分析和代码实现
|
|
1984
|
+
- 有充足的执行时间(半天到一天)
|
|
1985
|
+
- 希望最小化人工干预
|
|
1986
|
+
|
|
1987
|
+
---
|
|
1988
|
+
|
|
1839
1989
|
### 执行需求分析工作流
|
|
1840
1990
|
|
|
1841
1991
|
```bash
|
|
@@ -1856,7 +2006,7 @@ quality_gates:
|
|
|
1856
2006
|
# ✓ 步骤 1/6: 切换到 Analyst 进行需求分析(15-25分钟)
|
|
1857
2007
|
# ✓ 步骤 2/6: 切换到 Architect 分析现有架构(10-20分钟)
|
|
1858
2008
|
# ✓ 步骤 3/6: 切换到 PM 创建 Brownfield PRD(20-30分钟)
|
|
1859
|
-
# ✓ 步骤 4/6: 切换到 PM
|
|
2009
|
+
# ✓ 步骤 4/6: 切换到 PM 拆分模块(取决于模块数量)
|
|
1860
2010
|
# ✓ 步骤 5/6: 切换到 Architect 设计增量架构(30-40分钟)
|
|
1861
2011
|
# ✓ 步骤 6/6: 生成完成报告
|
|
1862
2012
|
|
|
@@ -1864,7 +2014,7 @@ quality_gates:
|
|
|
1864
2014
|
# - docs/requirements/requirements-analysis.md
|
|
1865
2015
|
# - docs/architecture/current-architecture-analysis.md
|
|
1866
2016
|
# - docs/prd/brownfield-iteration-prd.md
|
|
1867
|
-
# - docs/epics
|
|
2017
|
+
# - docs/epics/Epic-*.md
|
|
1868
2018
|
# - docs/architecture/iteration-backend-design.md
|
|
1869
2019
|
# - docs/architecture/db-migration-scripts.sql
|
|
1870
2020
|
```
|
|
@@ -1914,7 +2064,7 @@ quality_gates:
|
|
|
1914
2064
|
|
|
1915
2065
|
# 输出示例:
|
|
1916
2066
|
# 当前工作流: automated-requirements-analysis
|
|
1917
|
-
# 当前阶段: stage_4_pm_epics (PM
|
|
2067
|
+
# 当前阶段: stage_4_pm_epics (PM 拆分模块)
|
|
1918
2068
|
# 进度: 60% (3/5 步骤完成)
|
|
1919
2069
|
# 当前智能体: pm
|
|
1920
2070
|
# 已完成步骤:
|
|
@@ -1923,7 +2073,7 @@ quality_gates:
|
|
|
1923
2073
|
# ✓ stage_2_architect - 架构分析
|
|
1924
2074
|
# ✓ stage_3_pm_prd - PRD 创建
|
|
1925
2075
|
# 进行中步骤:
|
|
1926
|
-
# ⏳ stage_4_pm_epics -
|
|
2076
|
+
# ⏳ stage_4_pm_epics - 模块拆分 (2/4 模块已创建)
|
|
1927
2077
|
# 待执行步骤:
|
|
1928
2078
|
# ⏸ stage_5_architect_design - 架构设计
|
|
1929
2079
|
```
|
|
@@ -2025,7 +2175,7 @@ escalation_protocol:
|
|
|
2025
2175
|
*validate-prerequisites
|
|
2026
2176
|
|
|
2027
2177
|
# 检查项目:
|
|
2028
|
-
# ✓ Epic 文档存在 (docs/epics
|
|
2178
|
+
# ✓ Epic 文档存在 (docs/epics/Epic-*.md)
|
|
2029
2179
|
# ✓ 数据库设计文档存在 (docs/architecture/iteration-backend-design.md)
|
|
2030
2180
|
# ✓ 架构分析文档存在 (docs/architecture/current-architecture-analysis.md)
|
|
2031
2181
|
# ✓ 代码生成器配置完成 (如使用 MyBatis-Plus Generator)
|
|
@@ -2053,7 +2203,7 @@ escalation_protocol:
|
|
|
2053
2203
|
# 示例输出:
|
|
2054
2204
|
# 检测到未完成的工作流: automated-requirements-analysis
|
|
2055
2205
|
# 最后完成的步骤: stage_3_pm_prd (PRD 创建)
|
|
2056
|
-
# 准备从步骤 stage_4_pm_epics (
|
|
2206
|
+
# 准备从步骤 stage_4_pm_epics (模块拆分) 恢复执行
|
|
2057
2207
|
#
|
|
2058
2208
|
# 验证前序输出:
|
|
2059
2209
|
# ✓ docs/requirements/requirements-analysis.md
|
|
@@ -2233,7 +2383,7 @@ completion_report:
|
|
|
2233
2383
|
# ✅ 步骤 1/6: Analyst 需求分析 → 立即开始步骤 2/6...
|
|
2234
2384
|
# ✅ 步骤 2/6: Architect 架构分析 → 立即开始步骤 3/6...
|
|
2235
2385
|
# ✅ 步骤 3/6: PM 创建 PRD → 立即开始步骤 4/6...
|
|
2236
|
-
# ✅ 步骤 4/6: PM
|
|
2386
|
+
# ✅ 步骤 4/6: PM 拆分模块 → 立即开始步骤 5/6...
|
|
2237
2387
|
# ✅ 步骤 5/6: Architect 架构设计 → 立即开始步骤 6/6...
|
|
2238
2388
|
# ✅ 步骤 6/6: 生成完成报告 → 🎉 工作流完成!
|
|
2239
2389
|
|
|
@@ -2269,9 +2419,9 @@ completion_report:
|
|
|
2269
2419
|
[20-30分钟后]
|
|
2270
2420
|
✅ 步骤 3/6 完成: 已生成 docs/prd/brownfield-iteration-prd.md
|
|
2271
2421
|
|
|
2272
|
-
正在执行步骤 4/6: PM
|
|
2273
|
-
[
|
|
2274
|
-
✅ 步骤 4/6 完成: 已生成 4
|
|
2422
|
+
正在执行步骤 4/6: PM 拆分模块...
|
|
2423
|
+
[根据模块数量]
|
|
2424
|
+
✅ 步骤 4/6 完成: 已生成 4 个模块文档
|
|
2275
2425
|
|
|
2276
2426
|
正在执行步骤 5/6: Architect 设计增量架构...
|
|
2277
2427
|
[30-40分钟后]
|
|
@@ -2287,7 +2437,7 @@ completion_report:
|
|
|
2287
2437
|
- docs/requirements/requirements-analysis.md
|
|
2288
2438
|
- docs/architecture/current-architecture-analysis.md
|
|
2289
2439
|
- docs/prd/brownfield-iteration-prd.md
|
|
2290
|
-
- docs/epics
|
|
2440
|
+
- docs/epics/Epic-*.md (4个)
|
|
2291
2441
|
- docs/architecture/iteration-backend-design.md
|
|
2292
2442
|
- docs/architecture/db-migration-scripts.sql
|
|
2293
2443
|
|
|
@@ -7550,7 +7700,7 @@ sections:
|
|
|
7550
7700
|
1. 如果是 REST API, 创建一个 OpenAPI 3.0 规范
|
|
7551
7701
|
2. 如果是 GraphQL, 提供 GraphQL 模式
|
|
7552
7702
|
3. 如果是 tRPC, 展示路由定义
|
|
7553
|
-
4.
|
|
7703
|
+
4. 包括来自模块/故事的所有端点
|
|
7554
7704
|
5. 基于数据模型定义请求/响应模式
|
|
7555
7705
|
6. 记录认证要求
|
|
7556
7706
|
7. 包括请求/响应示例
|
|
@@ -9728,7 +9878,7 @@ sections:
|
|
|
9728
9878
|
title: 关键交互范式
|
|
9729
9879
|
- id: core-screens
|
|
9730
9880
|
title: 核心屏幕与视图
|
|
9731
|
-
instruction: 从产品角度看,为实现 PRD
|
|
9881
|
+
instruction: 从产品角度看,为实现 PRD 的价值和目标,最关键的屏幕或视图是什么?这旨在提供概念性的高层概览,以驱动粗略的模块或用户故事。
|
|
9732
9882
|
examples:
|
|
9733
9883
|
- "登录屏幕"
|
|
9734
9884
|
- "主仪表盘"
|
|
@@ -9778,38 +9928,38 @@ sections:
|
|
|
9778
9928
|
instruction: 在起草本文档的整个过程中,如果提出或发现任何其他适合架构师的技术假设,请在此处作为额外的项目符号添加。
|
|
9779
9929
|
|
|
9780
9930
|
- id: epic-list
|
|
9781
|
-
title:
|
|
9931
|
+
title: 模块列表
|
|
9782
9932
|
instruction: |
|
|
9783
|
-
|
|
9933
|
+
向用户呈现一份高层次的模块列表以供批准。每个模块应有一个标题和一个简短的(1句话)目标陈述。这使用户能在深入细节之前审阅整体结构。
|
|
9784
9934
|
|
|
9785
|
-
|
|
9935
|
+
关键:模块必须遵循敏捷最佳实践,保持逻辑上的顺序:
|
|
9786
9936
|
|
|
9787
|
-
-
|
|
9788
|
-
-
|
|
9789
|
-
-
|
|
9790
|
-
-
|
|
9791
|
-
-
|
|
9792
|
-
-
|
|
9937
|
+
- 每个模块都应交付一个重要的、端到端的、完全可部署且可测试的功能增量。
|
|
9938
|
+
- 模块 1 必须建立基础项目设施(应用设置、Git、CI/CD、核心服务),除非我们是向现有应用添加新功能。同时,它还应交付一个初始功能,即使只是一个健康检查路由或一个简单的金丝雀页面显示——在为第一个模块编写用户故事时要记住这一点!
|
|
9939
|
+
- 每个后续的模块都在之前模块功能的基础上构建,交付主要的功能模块,这些模块在部署时能为用户或业务提供切实的价值。
|
|
9940
|
+
- 并非每个项目都需要多个模块,一个模块需要交付价值。例如,一个已完成的 API 即使 UI 尚未完成并计划在另一个模块中实现,也可以交付价值。
|
|
9941
|
+
- 倾向于设置较少的模块,但要告知用户你的理由,并提供拆分选项,如果某些模块看起来太大或关注点分散的话。
|
|
9942
|
+
- 横切关注点应该贯穿于模块和用户故事中,而不是作为最后的用户故事。例如,在一个模块的最后一个故事中添加日志框架,或者在项目结束时作为最后一个模块或故事来做,这将非常糟糕,因为我们从一开始就没有日志记录。
|
|
9793
9943
|
elicit: true
|
|
9794
9944
|
examples:
|
|
9795
|
-
- "
|
|
9796
|
-
- "
|
|
9797
|
-
- "
|
|
9798
|
-
- "
|
|
9945
|
+
- "模块 1:基础与核心设施:建立项目设置、认证和基本用户管理"
|
|
9946
|
+
- "模块 2:核心业务实体:创建和管理主要领域对象的 CRUD 操作"
|
|
9947
|
+
- "模块 3:用户工作流与交互:实现关键用户旅程和业务流程"
|
|
9948
|
+
- "模块 4:报告与分析:为用户提供洞察和数据可视化"
|
|
9799
9949
|
|
|
9800
9950
|
- id: epic-details
|
|
9801
|
-
title:
|
|
9951
|
+
title: 模块 {{epic_number}} {{epic_title}}
|
|
9802
9952
|
repeatable: true
|
|
9803
9953
|
instruction: |
|
|
9804
|
-
|
|
9954
|
+
在模块列表被批准后,将每个模块及其所有的用户故事和验收标准作为一个完整的审查单元呈现。
|
|
9805
9955
|
|
|
9806
|
-
|
|
9956
|
+
为每个模块提供扩展的目标(2-3 句话描述所有故事将实现的目标和价值)。
|
|
9807
9957
|
|
|
9808
9958
|
关键的用户故事排序要求:
|
|
9809
9959
|
|
|
9810
|
-
-
|
|
9960
|
+
- 每个模块中的用户故事必须在逻辑上是顺序的。
|
|
9811
9961
|
- 每个故事都应该是一个“垂直切片”,交付完整的功能,除了项目基础的早期使能型故事。
|
|
9812
|
-
-
|
|
9962
|
+
- 任何故事都不应依赖于后续故事或模块的工作。
|
|
9813
9963
|
- 识别并注明任何直接的前置故事。
|
|
9814
9964
|
- 关注“做什么”和“为什么”,而不是“怎么做”(将技术实现留给架构师),但要足够精确以支持故事之间逻辑上顺序的操作。
|
|
9815
9965
|
- 确保每个故事都交付明确的用户或业务价值,尽量避免使能型故事,而是将它们构建到交付价值的故事中。
|
|
@@ -1121,7 +1121,7 @@ commands:
|
|
|
1121
1121
|
- create-brownfield-epic: 运行任务 brownfield-create-epic.md
|
|
1122
1122
|
- create-brownfield-prd: 使用模板 brownfield-prd-tmpl.yaml 运行任务 create-doc.md
|
|
1123
1123
|
- create-brownfield-story: 运行任务 brownfield-create-story.md
|
|
1124
|
-
- create-epic:
|
|
1124
|
+
- create-epic: 为现有项目项目创建模块 (任务 brownfield-create-epic)
|
|
1125
1125
|
- create-prd: 使用模板 prd-tmpl.yaml 运行任务 create-doc.md
|
|
1126
1126
|
- create-story: 从需求创建用户故事 (任务 brownfield-create-story)
|
|
1127
1127
|
- doc-out: 将完整文档输出到当前目标文件
|
|
@@ -1301,7 +1301,7 @@ persona:
|
|
|
1301
1301
|
commands:
|
|
1302
1302
|
- help: 显示以下命令的编号列表以供选择
|
|
1303
1303
|
- correct-course: 执行 correct-course 任务
|
|
1304
|
-
- create-epic:
|
|
1304
|
+
- create-epic: 为现有项目项目创建模块 (任务 brownfield-create-epic)
|
|
1305
1305
|
- create-story: 从需求创建用户故事 (任务 brownfield-create-story)
|
|
1306
1306
|
- doc-out: 将完整文档输出到当前目标文件
|
|
1307
1307
|
- execute-checklist-po: 运行任务 execute-checklist (清单 po-master-checklist)
|
|
@@ -1339,7 +1339,7 @@ agent:
|
|
|
1339
1339
|
id: sm
|
|
1340
1340
|
title: Scrum Master
|
|
1341
1341
|
icon: 🏃
|
|
1342
|
-
whenToUse:
|
|
1342
|
+
whenToUse: 用于创建故事、模块管理、在派对模式下进行回顾以及敏捷流程指导
|
|
1343
1343
|
customization: null
|
|
1344
1344
|
persona:
|
|
1345
1345
|
role: 技术 Scrum Master - 故事准备专家
|
|
@@ -5671,7 +5671,7 @@ sections:
|
|
|
5671
5671
|
title: 关键交互范式
|
|
5672
5672
|
- id: core-screens
|
|
5673
5673
|
title: 核心屏幕与视图
|
|
5674
|
-
instruction: 从产品角度看,为实现 PRD
|
|
5674
|
+
instruction: 从产品角度看,为实现 PRD 的价值和目标,最关键的屏幕或视图是什么?这旨在提供概念性的高层概览,以驱动粗略的模块或用户故事。
|
|
5675
5675
|
examples:
|
|
5676
5676
|
- "登录屏幕"
|
|
5677
5677
|
- "主仪表盘"
|
|
@@ -5721,38 +5721,38 @@ sections:
|
|
|
5721
5721
|
instruction: 在起草本文档的整个过程中,如果提出或发现任何其他适合架构师的技术假设,请在此处作为额外的项目符号添加。
|
|
5722
5722
|
|
|
5723
5723
|
- id: epic-list
|
|
5724
|
-
title:
|
|
5724
|
+
title: 模块列表
|
|
5725
5725
|
instruction: |
|
|
5726
|
-
|
|
5726
|
+
向用户呈现一份高层次的模块列表以供批准。每个模块应有一个标题和一个简短的(1句话)目标陈述。这使用户能在深入细节之前审阅整体结构。
|
|
5727
5727
|
|
|
5728
|
-
|
|
5728
|
+
关键:模块必须遵循敏捷最佳实践,保持逻辑上的顺序:
|
|
5729
5729
|
|
|
5730
|
-
-
|
|
5731
|
-
-
|
|
5732
|
-
-
|
|
5733
|
-
-
|
|
5734
|
-
-
|
|
5735
|
-
-
|
|
5730
|
+
- 每个模块都应交付一个重要的、端到端的、完全可部署且可测试的功能增量。
|
|
5731
|
+
- 模块 1 必须建立基础项目设施(应用设置、Git、CI/CD、核心服务),除非我们是向现有应用添加新功能。同时,它还应交付一个初始功能,即使只是一个健康检查路由或一个简单的金丝雀页面显示——在为第一个模块编写用户故事时要记住这一点!
|
|
5732
|
+
- 每个后续的模块都在之前模块功能的基础上构建,交付主要的功能模块,这些模块在部署时能为用户或业务提供切实的价值。
|
|
5733
|
+
- 并非每个项目都需要多个模块,一个模块需要交付价值。例如,一个已完成的 API 即使 UI 尚未完成并计划在另一个模块中实现,也可以交付价值。
|
|
5734
|
+
- 倾向于设置较少的模块,但要告知用户你的理由,并提供拆分选项,如果某些模块看起来太大或关注点分散的话。
|
|
5735
|
+
- 横切关注点应该贯穿于模块和用户故事中,而不是作为最后的用户故事。例如,在一个模块的最后一个故事中添加日志框架,或者在项目结束时作为最后一个模块或故事来做,这将非常糟糕,因为我们从一开始就没有日志记录。
|
|
5736
5736
|
elicit: true
|
|
5737
5737
|
examples:
|
|
5738
|
-
- "
|
|
5739
|
-
- "
|
|
5740
|
-
- "
|
|
5741
|
-
- "
|
|
5738
|
+
- "模块 1:基础与核心设施:建立项目设置、认证和基本用户管理"
|
|
5739
|
+
- "模块 2:核心业务实体:创建和管理主要领域对象的 CRUD 操作"
|
|
5740
|
+
- "模块 3:用户工作流与交互:实现关键用户旅程和业务流程"
|
|
5741
|
+
- "模块 4:报告与分析:为用户提供洞察和数据可视化"
|
|
5742
5742
|
|
|
5743
5743
|
- id: epic-details
|
|
5744
|
-
title:
|
|
5744
|
+
title: 模块 {{epic_number}} {{epic_title}}
|
|
5745
5745
|
repeatable: true
|
|
5746
5746
|
instruction: |
|
|
5747
|
-
|
|
5747
|
+
在模块列表被批准后,将每个模块及其所有的用户故事和验收标准作为一个完整的审查单元呈现。
|
|
5748
5748
|
|
|
5749
|
-
|
|
5749
|
+
为每个模块提供扩展的目标(2-3 句话描述所有故事将实现的目标和价值)。
|
|
5750
5750
|
|
|
5751
5751
|
关键的用户故事排序要求:
|
|
5752
5752
|
|
|
5753
|
-
-
|
|
5753
|
+
- 每个模块中的用户故事必须在逻辑上是顺序的。
|
|
5754
5754
|
- 每个故事都应该是一个“垂直切片”,交付完整的功能,除了项目基础的早期使能型故事。
|
|
5755
|
-
-
|
|
5755
|
+
- 任何故事都不应依赖于后续故事或模块的工作。
|
|
5756
5756
|
- 识别并注明任何直接的前置故事。
|
|
5757
5757
|
- 关注“做什么”和“为什么”,而不是“怎么做”(将技术实现留给架构师),但要足够精确以支持故事之间逻辑上顺序的操作。
|
|
5758
5758
|
- 确保每个故事都交付明确的用户或业务价值,尽量避免使能型故事,而是将它们构建到交付价值的故事中。
|
|
@@ -8533,7 +8533,7 @@ sections:
|
|
|
8533
8533
|
1. 如果是 REST API, 创建一个 OpenAPI 3.0 规范
|
|
8534
8534
|
2. 如果是 GraphQL, 提供 GraphQL 模式
|
|
8535
8535
|
3. 如果是 tRPC, 展示路由定义
|
|
8536
|
-
4.
|
|
8536
|
+
4. 包括来自模块/故事的所有端点
|
|
8537
8537
|
5. 基于数据模型定义请求/响应模式
|
|
8538
8538
|
6. 记录认证要求
|
|
8539
8539
|
7. 包括请求/响应示例
|
|
@@ -14340,7 +14340,7 @@ ultimate_sequence:
|
|
|
14340
14340
|
- ai_guided_improvement
|
|
14341
14341
|
timeout: 3600
|
|
14342
14342
|
retry: 3
|
|
14343
|
-
notes: "企业级增强用户故事创建 -
|
|
14343
|
+
notes: "企业级增强用户故事创建 - 每个模块依次完成"
|
|
14344
14344
|
|
|
14345
14345
|
# 3.3 串行开发实现
|
|
14346
14346
|
- step: sequential_development
|