@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
package/.idea/workspace.xml
CHANGED
|
@@ -4,7 +4,27 @@
|
|
|
4
4
|
<option name="autoReloadType" value="SELECTIVE" />
|
|
5
5
|
</component>
|
|
6
6
|
<component name="ChangeListManager">
|
|
7
|
-
<list default="true" id="4ca3d6ad-bc27-4e67-9acd-07dccd21dd95" name="Changes" comment="drop unchecked message"
|
|
7
|
+
<list default="true" id="4ca3d6ad-bc27-4e67-9acd-07dccd21dd95" name="Changes" comment="drop unchecked message">
|
|
8
|
+
<change beforePath="$PROJECT_DIR$/JAVA-BACKEND-COMMANDS-REFERENCE.md" beforeDir="false" afterPath="$PROJECT_DIR$/JAVA-BACKEND-COMMANDS-REFERENCE.md" afterDir="false" />
|
|
9
|
+
<change beforePath="$PROJECT_DIR$/JAVA-BACKEND-ITERATION-GUIDE.md" beforeDir="false" afterPath="$PROJECT_DIR$/JAVA-BACKEND-ITERATION-GUIDE.md" afterDir="false" />
|
|
10
|
+
<change beforePath="$PROJECT_DIR$/docs/architecture-sharding-modification.md" beforeDir="false" afterPath="$PROJECT_DIR$/docs/architecture-sharding-modification.md" afterDir="false" />
|
|
11
|
+
<change beforePath="$PROJECT_DIR$/docs/automated-requirements-analysis-outputs.md" beforeDir="false" afterPath="$PROJECT_DIR$/docs/automated-requirements-analysis-outputs.md" afterDir="false" />
|
|
12
|
+
<change beforePath="$PROJECT_DIR$/docs/prd/workflow-coordinator-prd.md" beforeDir="false" afterPath="$PROJECT_DIR$/docs/prd/workflow-coordinator-prd.md" afterDir="false" />
|
|
13
|
+
<change beforePath="$PROJECT_DIR$/xiaoma-core/agents/pm.md" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/agents/pm.md" afterDir="false" />
|
|
14
|
+
<change beforePath="$PROJECT_DIR$/xiaoma-core/agents/po.md" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/agents/po.md" afterDir="false" />
|
|
15
|
+
<change beforePath="$PROJECT_DIR$/xiaoma-core/agents/requirements-coverage-auditor.yaml" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/agents/requirements-coverage-auditor.yaml" afterDir="false" />
|
|
16
|
+
<change beforePath="$PROJECT_DIR$/xiaoma-core/agents/sm.md" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/agents/sm.md" afterDir="false" />
|
|
17
|
+
<change beforePath="$PROJECT_DIR$/xiaoma-core/agents/workflow-executor.md" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/agents/workflow-executor.md" afterDir="false" />
|
|
18
|
+
<change beforePath="$PROJECT_DIR$/xiaoma-core/tasks/batch-story-generation.md" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/tasks/batch-story-generation.md" afterDir="false" />
|
|
19
|
+
<change beforePath="$PROJECT_DIR$/xiaoma-core/tasks/requirements-coverage-audit.md" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/tasks/requirements-coverage-audit.md" afterDir="false" />
|
|
20
|
+
<change beforePath="$PROJECT_DIR$/xiaoma-core/templates/fullstack-architecture-tmpl.yaml" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/templates/fullstack-architecture-tmpl.yaml" afterDir="false" />
|
|
21
|
+
<change beforePath="$PROJECT_DIR$/xiaoma-core/templates/prd-tmpl.yaml" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/templates/prd-tmpl.yaml" afterDir="false" />
|
|
22
|
+
<change beforePath="$PROJECT_DIR$/xiaoma-core/templates/requirements-coverage-audit.yaml" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/templates/requirements-coverage-audit.yaml" afterDir="false" />
|
|
23
|
+
<change beforePath="$PROJECT_DIR$/xiaoma-core/workflows/automated-requirements-analysis.yaml" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/workflows/automated-requirements-analysis.yaml" afterDir="false" />
|
|
24
|
+
<change beforePath="$PROJECT_DIR$/xiaoma-core/workflows/automated-requirements-development.yaml" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/workflows/automated-requirements-development.yaml" afterDir="false" />
|
|
25
|
+
<change beforePath="$PROJECT_DIR$/xiaoma-core/workflows/enhanced-fullstack-with-qa-loop.yaml" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/workflows/enhanced-fullstack-with-qa-loop.yaml" afterDir="false" />
|
|
26
|
+
<change beforePath="$PROJECT_DIR$/xiaoma-core/workflows/full-requirement-automation.yaml" beforeDir="false" afterPath="$PROJECT_DIR$/xiaoma-core/workflows/full-requirement-automation.yaml" afterDir="false" />
|
|
27
|
+
</list>
|
|
8
28
|
<option name="SHOW_DIALOG" value="false" />
|
|
9
29
|
<option name="HIGHLIGHT_CONFLICTS" value="true" />
|
|
10
30
|
<option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
|
|
@@ -67,7 +87,8 @@
|
|
|
67
87
|
<workItem from="1762494963355" duration="2769000" />
|
|
68
88
|
<workItem from="1762781553645" duration="3390000" />
|
|
69
89
|
<workItem from="1762933631198" duration="16000" />
|
|
70
|
-
<workItem from="1763045898895" duration="
|
|
90
|
+
<workItem from="1763045898895" duration="4599000" />
|
|
91
|
+
<workItem from="1763520819252" duration="1863000" />
|
|
71
92
|
</task>
|
|
72
93
|
<task id="LOCAL-00001" summary="drop unchecked message">
|
|
73
94
|
<option name="closed" value="true" />
|
|
@@ -29,7 +29,7 @@ Agent 没有对应的专用命令,通过详细的 Prompt 描述让 Agent 理
|
|
|
29
29
|
| 1.1 分析现有架构 | Architect | ❌ 不需要 | 无 | 通过详细 Prompt 描述分析任务 |
|
|
30
30
|
| 1.2 创建 Brownfield PRD | PM | ✅ **需要** | `*create-brownfield-prd` | 必须在 Prompt 结尾明确执行此命令 |
|
|
31
31
|
| 1.2 验证 PRD 质量 | PM | ❌ 不需要 | 无 | 通过 Prompt 要求 Agent 自我审查 |
|
|
32
|
-
| 1.3
|
|
32
|
+
| 1.3 创建模块 | PM | ✅ **需要** | `*create-epic` | 必须在 Prompt 结尾明确执行此命令 |
|
|
33
33
|
|
|
34
34
|
---
|
|
35
35
|
|
|
@@ -237,7 +237,7 @@ Agent 没有对应的专用命令,通过详细的 Prompt 描述让 Agent 理
|
|
|
237
237
|
|
|
238
238
|
| 任务类型 | 是否需要命令 | 示例 |
|
|
239
239
|
| ------------------------------- | ------------ | --------------------------------- |
|
|
240
|
-
| 创建正式文档(PRD
|
|
240
|
+
| 创建正式文档(PRD、模块、故事) | ✅ 需要 | `*create-epic`, `*draft-enhanced` |
|
|
241
241
|
| 开发/测试代码 | ✅ 需要 | `*develop-story`, `*run-tests` |
|
|
242
242
|
| 质量审查和决策 | ✅ 需要 | `*review`, `*gate` |
|
|
243
243
|
| 探索性分析 | ❌ 不需要 | 分析架构、识别故事列表 |
|
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
/your-project/
|
|
22
22
|
├── src/ # Java 源码
|
|
23
23
|
├── docs/ # 文档目录
|
|
24
|
-
│ ├── prd/ # PRD
|
|
24
|
+
│ ├── prd/ # PRD 和模块
|
|
25
25
|
│ └── stories/ # 用户故事
|
|
26
26
|
├── .xiaoma-core/ # xiaoma-core 配置
|
|
27
27
|
└── req.txt # PM 提供的需求文档
|
|
@@ -130,7 +130,7 @@ cd /your-project/
|
|
|
130
130
|
6. 数据需求(数据库变更)
|
|
131
131
|
7. API 需求(新增/修改的接口)
|
|
132
132
|
8. 验收标准
|
|
133
|
-
9.
|
|
133
|
+
9. 实施计划(模块拆分建议)
|
|
134
134
|
|
|
135
135
|
**特别注意**:
|
|
136
136
|
- 这是现有项目的迭代需求,需要考虑与现有系统的兼容性
|
|
@@ -169,41 +169,41 @@ cd /your-project/
|
|
|
169
169
|
|
|
170
170
|
---
|
|
171
171
|
|
|
172
|
-
### 📍 **步骤 1.3
|
|
172
|
+
### 📍 **步骤 1.3:拆分模块(针对大型需求)**
|
|
173
173
|
|
|
174
|
-
**判断依据**:如果 PRD 包含多个独立的功能模块(≥3
|
|
174
|
+
**判断依据**:如果 PRD 包含多个独立的功能模块(≥3个),建议拆分为模块。
|
|
175
175
|
|
|
176
176
|
#### 操作步骤:
|
|
177
177
|
|
|
178
178
|
**① 保持 PM Agent 激活状态**
|
|
179
179
|
|
|
180
|
-
**② 发送 Prompt
|
|
180
|
+
**② 发送 Prompt(针对每个模块)**
|
|
181
181
|
|
|
182
182
|
```
|
|
183
|
-
基于刚才创建的 PRD
|
|
183
|
+
基于刚才创建的 PRD,我需要创建模块。
|
|
184
184
|
|
|
185
|
-
|
|
186
|
-
根据 PRD
|
|
187
|
-
1. [
|
|
188
|
-
2. [
|
|
189
|
-
3. [
|
|
185
|
+
**模块拆分建议**:
|
|
186
|
+
根据 PRD 的功能模块,建议拆分为以下模块:
|
|
187
|
+
1. [模块1名称]:[功能描述]
|
|
188
|
+
2. [模块2名称]:[功能描述]
|
|
189
|
+
3. [模块3名称]:[功能描述]
|
|
190
190
|
|
|
191
191
|
**当前任务**:
|
|
192
|
-
|
|
192
|
+
请为第一个模块"[模块1名称]"创建模块文档。
|
|
193
193
|
|
|
194
|
-
|
|
195
|
-
-
|
|
196
|
-
- 功能范围:[
|
|
194
|
+
**模块信息**:
|
|
195
|
+
- 模块名称:[模块1名称]
|
|
196
|
+
- 功能范围:[详细描述此模块包含的功能]
|
|
197
197
|
- 业务价值:[业务价值说明]
|
|
198
198
|
- 优先级:高/中/低
|
|
199
|
-
- 依赖关系:[
|
|
199
|
+
- 依赖关系:[是否依赖其他模块]
|
|
200
200
|
|
|
201
|
-
|
|
202
|
-
1.
|
|
201
|
+
**模块文档要求**:
|
|
202
|
+
1. 模块级别的目标和价值
|
|
203
203
|
2. 包含的用户故事清单(初步识别)
|
|
204
|
-
3.
|
|
205
|
-
4.
|
|
206
|
-
5. API
|
|
204
|
+
3. 技术设计概要(针对此模块)
|
|
205
|
+
4. 数据库变更(针对此模块)
|
|
206
|
+
5. API 接口清单(针对此模块)
|
|
207
207
|
6. 验收标准
|
|
208
208
|
7. 估算工作量
|
|
209
209
|
|
|
@@ -218,8 +218,8 @@ cd /your-project/
|
|
|
218
218
|
|
|
219
219
|
**期望输出**:
|
|
220
220
|
|
|
221
|
-
-
|
|
222
|
-
-
|
|
221
|
+
- 模块文档:`docs/prd/Epic[名称].md`
|
|
222
|
+
- 对每个模块重复此步骤
|
|
223
223
|
|
|
224
224
|
---
|
|
225
225
|
|
|
@@ -347,7 +347,7 @@ cd /your-project/
|
|
|
347
347
|
**用户故事清单格式**:
|
|
348
348
|
请以表格形式列出所有用户故事:
|
|
349
349
|
|
|
350
|
-
| 编号 | 故事名称 |
|
|
350
|
+
| 编号 | 故事名称 | 所属模块 | 优先级 | 估算复杂度 | 依赖 |
|
|
351
351
|
|------|---------|---------|--------|----------|------|
|
|
352
352
|
| US-01 | [名称] | Epic-01 | 高 | 中 | 无 |
|
|
353
353
|
| US-02 | [名称] | Epic-01 | 高 | 高 | US-01 |
|
|
@@ -384,7 +384,7 @@ cd /your-project/
|
|
|
384
384
|
**故事基本信息**:
|
|
385
385
|
- 故事 ID:US-01
|
|
386
386
|
- 故事名称:[从清单中获取]
|
|
387
|
-
-
|
|
387
|
+
- 所属模块:[Epic 名称]
|
|
388
388
|
- 优先级:高/中/低
|
|
389
389
|
- 估算复杂度:低/中/高
|
|
390
390
|
|
|
@@ -1250,7 +1250,7 @@ cd /your-project/
|
|
|
1250
1250
|
|
|
1251
1251
|
**审计范围**:
|
|
1252
1252
|
- PRD 文档:`docs/prd/云链API平台需求文档.md`
|
|
1253
|
-
-
|
|
1253
|
+
- 模块文档:`docs/prd/Epic-*.md`(如有)
|
|
1254
1254
|
- 所有用户故事:`docs/stories/epic*-story*.md`
|
|
1255
1255
|
|
|
1256
1256
|
**审计任务**:
|
|
@@ -1481,7 +1481,7 @@ cd /your-project/
|
|
|
1481
1481
|
- 迭代目标
|
|
1482
1482
|
|
|
1483
1483
|
**2. 完成故事清单**:
|
|
1484
|
-
| 故事ID | 故事名称 |
|
|
1484
|
+
| 故事ID | 故事名称 | 所属模块 | 优先级 | 状态 | 完成日期 | 开发者 |
|
|
1485
1485
|
|--------|---------|---------|-------|------|---------|--------|
|
|
1486
1486
|
| US-01 | [名称] | Epic-01 | 高 | Done | 2025-01-15 | Dev Agent |
|
|
1487
1487
|
| ... | ... | ... | ... | ... | ... | ... |
|
|
@@ -1492,13 +1492,13 @@ cd /your-project/
|
|
|
1492
1492
|
- 完成率:[百分比]
|
|
1493
1493
|
- 高优先级完成率:[百分比]
|
|
1494
1494
|
|
|
1495
|
-
**4.
|
|
1496
|
-
**Epic 01: [
|
|
1495
|
+
**4. 功能交付清单**(按模块分组):
|
|
1496
|
+
**Epic 01: [模块名称]**
|
|
1497
1497
|
- ✅ [功能1](US-01)
|
|
1498
1498
|
- ✅ [功能2](US-02)
|
|
1499
1499
|
- ...
|
|
1500
1500
|
|
|
1501
|
-
**Epic 02: [
|
|
1501
|
+
**Epic 02: [模块名称]**
|
|
1502
1502
|
- ✅ [功能3](US-03)
|
|
1503
1503
|
- ...
|
|
1504
1504
|
|
|
@@ -2047,7 +2047,7 @@ systemctl start your-service
|
|
|
2047
2047
|
1. **需求分析和 PRD 创建**(1-2 小时)
|
|
2048
2048
|
- Architect: 分析现有架构
|
|
2049
2049
|
- PM: 创建 Brownfield PRD
|
|
2050
|
-
- PM:
|
|
2050
|
+
- PM: 拆分模块(如需要)
|
|
2051
2051
|
|
|
2052
2052
|
2. **技术架构设计**(1-2 小时)
|
|
2053
2053
|
- Architect: 后端增量设计
|
package/dist/agents/pm.txt
CHANGED
|
@@ -76,7 +76,7 @@ commands:
|
|
|
76
76
|
- create-brownfield-epic: 运行任务 brownfield-create-epic.md
|
|
77
77
|
- create-brownfield-prd: 使用模板 brownfield-prd-tmpl.yaml 运行任务 create-doc.md
|
|
78
78
|
- create-brownfield-story: 运行任务 brownfield-create-story.md
|
|
79
|
-
- create-epic:
|
|
79
|
+
- create-epic: 为现有项目项目创建模块 (任务 brownfield-create-epic)
|
|
80
80
|
- create-prd: 使用模板 prd-tmpl.yaml 运行任务 create-doc.md
|
|
81
81
|
- create-story: 从需求创建用户故事 (任务 brownfield-create-story)
|
|
82
82
|
- doc-out: 将完整文档输出到当前目标文件
|
|
@@ -1524,7 +1524,7 @@ sections:
|
|
|
1524
1524
|
title: 关键交互范式
|
|
1525
1525
|
- id: core-screens
|
|
1526
1526
|
title: 核心屏幕与视图
|
|
1527
|
-
instruction: 从产品角度看,为实现 PRD
|
|
1527
|
+
instruction: 从产品角度看,为实现 PRD 的价值和目标,最关键的屏幕或视图是什么?这旨在提供概念性的高层概览,以驱动粗略的模块或用户故事。
|
|
1528
1528
|
examples:
|
|
1529
1529
|
- "登录屏幕"
|
|
1530
1530
|
- "主仪表盘"
|
|
@@ -1574,38 +1574,38 @@ sections:
|
|
|
1574
1574
|
instruction: 在起草本文档的整个过程中,如果提出或发现任何其他适合架构师的技术假设,请在此处作为额外的项目符号添加。
|
|
1575
1575
|
|
|
1576
1576
|
- id: epic-list
|
|
1577
|
-
title:
|
|
1577
|
+
title: 模块列表
|
|
1578
1578
|
instruction: |
|
|
1579
|
-
|
|
1579
|
+
向用户呈现一份高层次的模块列表以供批准。每个模块应有一个标题和一个简短的(1句话)目标陈述。这使用户能在深入细节之前审阅整体结构。
|
|
1580
1580
|
|
|
1581
|
-
|
|
1581
|
+
关键:模块必须遵循敏捷最佳实践,保持逻辑上的顺序:
|
|
1582
1582
|
|
|
1583
|
-
-
|
|
1584
|
-
-
|
|
1585
|
-
-
|
|
1586
|
-
-
|
|
1587
|
-
-
|
|
1588
|
-
-
|
|
1583
|
+
- 每个模块都应交付一个重要的、端到端的、完全可部署且可测试的功能增量。
|
|
1584
|
+
- 模块 1 必须建立基础项目设施(应用设置、Git、CI/CD、核心服务),除非我们是向现有应用添加新功能。同时,它还应交付一个初始功能,即使只是一个健康检查路由或一个简单的金丝雀页面显示——在为第一个模块编写用户故事时要记住这一点!
|
|
1585
|
+
- 每个后续的模块都在之前模块功能的基础上构建,交付主要的功能模块,这些模块在部署时能为用户或业务提供切实的价值。
|
|
1586
|
+
- 并非每个项目都需要多个模块,一个模块需要交付价值。例如,一个已完成的 API 即使 UI 尚未完成并计划在另一个模块中实现,也可以交付价值。
|
|
1587
|
+
- 倾向于设置较少的模块,但要告知用户你的理由,并提供拆分选项,如果某些模块看起来太大或关注点分散的话。
|
|
1588
|
+
- 横切关注点应该贯穿于模块和用户故事中,而不是作为最后的用户故事。例如,在一个模块的最后一个故事中添加日志框架,或者在项目结束时作为最后一个模块或故事来做,这将非常糟糕,因为我们从一开始就没有日志记录。
|
|
1589
1589
|
elicit: true
|
|
1590
1590
|
examples:
|
|
1591
|
-
- "
|
|
1592
|
-
- "
|
|
1593
|
-
- "
|
|
1594
|
-
- "
|
|
1591
|
+
- "模块 1:基础与核心设施:建立项目设置、认证和基本用户管理"
|
|
1592
|
+
- "模块 2:核心业务实体:创建和管理主要领域对象的 CRUD 操作"
|
|
1593
|
+
- "模块 3:用户工作流与交互:实现关键用户旅程和业务流程"
|
|
1594
|
+
- "模块 4:报告与分析:为用户提供洞察和数据可视化"
|
|
1595
1595
|
|
|
1596
1596
|
- id: epic-details
|
|
1597
|
-
title:
|
|
1597
|
+
title: 模块 {{epic_number}} {{epic_title}}
|
|
1598
1598
|
repeatable: true
|
|
1599
1599
|
instruction: |
|
|
1600
|
-
|
|
1600
|
+
在模块列表被批准后,将每个模块及其所有的用户故事和验收标准作为一个完整的审查单元呈现。
|
|
1601
1601
|
|
|
1602
|
-
|
|
1602
|
+
为每个模块提供扩展的目标(2-3 句话描述所有故事将实现的目标和价值)。
|
|
1603
1603
|
|
|
1604
1604
|
关键的用户故事排序要求:
|
|
1605
1605
|
|
|
1606
|
-
-
|
|
1606
|
+
- 每个模块中的用户故事必须在逻辑上是顺序的。
|
|
1607
1607
|
- 每个故事都应该是一个“垂直切片”,交付完整的功能,除了项目基础的早期使能型故事。
|
|
1608
|
-
-
|
|
1608
|
+
- 任何故事都不应依赖于后续故事或模块的工作。
|
|
1609
1609
|
- 识别并注明任何直接的前置故事。
|
|
1610
1610
|
- 关注“做什么”和“为什么”,而不是“怎么做”(将技术实现留给架构师),但要足够精确以支持故事之间逻辑上顺序的操作。
|
|
1611
1611
|
- 确保每个故事都交付明确的用户或业务价值,尽量避免使能型故事,而是将它们构建到交付价值的故事中。
|
package/dist/agents/po.txt
CHANGED
|
@@ -76,7 +76,7 @@ persona:
|
|
|
76
76
|
commands:
|
|
77
77
|
- help: 显示以下命令的编号列表以供选择
|
|
78
78
|
- correct-course: 执行 correct-course 任务
|
|
79
|
-
- create-epic:
|
|
79
|
+
- create-epic: 为现有项目项目创建模块 (任务 brownfield-create-epic)
|
|
80
80
|
- create-story: 从需求创建用户故事 (任务 brownfield-create-story)
|
|
81
81
|
- doc-out: 将完整文档输出到当前目标文件
|
|
82
82
|
- execute-checklist-po: 运行任务 execute-checklist (清单 po-master-checklist)
|
package/dist/agents/sm.txt
CHANGED
|
@@ -78,11 +78,12 @@ persona:
|
|
|
78
78
|
- 自动切换智能体:根据工作流定义,自动使用 /analyst、/architect、/pm、/po、/sm、/dev、/qa 等命令切换到相应的智能体角色
|
|
79
79
|
- 连续执行模式:完成一个步骤后,立即显示简短进度(1-2行)并**无需任何确认**直接进入下一个步骤,直到整个工作流完成或遇到真正的技术错误
|
|
80
80
|
- 🚫 严禁中断询问:不要问'是否继续'、'请选择'、'您希望'等问题。用户启动工作流就是明确要求自动执行到底。唯一允许暂停的情况:文件不存在、执行报错、质量门控失败。
|
|
81
|
-
- '✅ 正确的进度报告格式:简短报告 + 立即继续,例如:''✅ 步骤 3/6 完成: PM 创建 PRD → 立即开始步骤 4/6: PM
|
|
81
|
+
- '✅ 正确的进度报告格式:简短报告 + 立即继续,例如:''✅ 步骤 3/6 完成: PM 创建 PRD → 立即开始步骤 4/6: PM 拆分模块...'''
|
|
82
82
|
commands:
|
|
83
83
|
- help: 显示以下命令的编号列表以供选择
|
|
84
84
|
- run-requirements-analysis: 🔥 自动化需求分析工作流(完全自动执行,不暂停)- 加载 automated-requirements-analysis.yaml 并连续执行所有 6 个步骤,从 req.txt 到最终的架构设计文档,全程自动化无需人工干预
|
|
85
85
|
- run-story-development: 🔥 自动化用户故事开发工作流(完全自动执行,不暂停)- 加载 automated-story-development.yaml 并循环执行所有用户故事的 SM→PO→Dev→QA 完整开发周期,全程自动化无需人工干预
|
|
86
|
+
- run-requirements-development: '🔥🔥🔥 端到端全自动化工作流(完全自动执行,不暂停)- 加载 automated-requirements-development.yaml 并连续执行从需求分析到用户故事开发完成的完整流程 (阶段1: 需求分析 6步 + 阶段2: 用户故事开发循环), 实现从 req.txt 到所有代码完成的端到端自动化'
|
|
86
87
|
- status: 显示当前工作流执行状态和进度
|
|
87
88
|
- validate-prerequisites: 验证工作流执行的前置条件
|
|
88
89
|
- resume-workflow: 从上次中断的位置恢复工作流执行(同样会自动连续执行剩余步骤)
|
|
@@ -92,6 +93,7 @@ dependencies:
|
|
|
92
93
|
workflows:
|
|
93
94
|
- automated-requirements-analysis.yaml
|
|
94
95
|
- automated-story-development.yaml
|
|
96
|
+
- automated-requirements-development.yaml
|
|
95
97
|
```
|
|
96
98
|
|
|
97
99
|
---
|
|
@@ -156,7 +158,7 @@ workflow_stages:
|
|
|
156
158
|
tasks:
|
|
157
159
|
- 创建 Brownfield 项目迭代需求的 PRD 文档
|
|
158
160
|
- 定义功能模块、数据变更、API 规范
|
|
159
|
-
-
|
|
161
|
+
- 制定验收标准和模块拆分建议
|
|
160
162
|
- 自检 PRD 质量(16项检查)
|
|
161
163
|
outputs:
|
|
162
164
|
- docs/prd/brownfield-iteration-prd.md
|
|
@@ -164,15 +166,15 @@ workflow_stages:
|
|
|
164
166
|
stage_4_pm_epics:
|
|
165
167
|
agent: pm
|
|
166
168
|
command: "*create-epic"
|
|
167
|
-
duration: "
|
|
169
|
+
duration: "变动,取决于模块数量"
|
|
168
170
|
tasks:
|
|
169
|
-
- 从 PRD
|
|
170
|
-
-
|
|
171
|
+
- 从 PRD 提取模块清单
|
|
172
|
+
- 循环创建每个模块文档
|
|
171
173
|
- 初步识别用户故事
|
|
172
174
|
- 定义技术设计概要和数据库/API 变更
|
|
173
|
-
-
|
|
175
|
+
- 验证模块质量
|
|
174
176
|
outputs:
|
|
175
|
-
- docs/epics
|
|
177
|
+
- docs/epics/Epic-*.md (多个模块文件)
|
|
176
178
|
|
|
177
179
|
stage_5_architect_design:
|
|
178
180
|
agent: architect
|
|
@@ -181,7 +183,7 @@ workflow_stages:
|
|
|
181
183
|
duration: "30-40分钟"
|
|
182
184
|
inputs:
|
|
183
185
|
- docs/prd/brownfield-iteration-prd.md
|
|
184
|
-
- docs/epics
|
|
186
|
+
- docs/epics/Epic-*.md
|
|
185
187
|
- docs/architecture/current-architecture-analysis.md
|
|
186
188
|
tasks:
|
|
187
189
|
- 设计新增数据模型(Entity + DDL)
|
|
@@ -205,7 +207,77 @@ workflow_stages:
|
|
|
205
207
|
|
|
206
208
|
---
|
|
207
209
|
|
|
208
|
-
### 2.
|
|
210
|
+
### 2. 🔥🔥🔥 端到端全自动化工作流 (新增)
|
|
211
|
+
|
|
212
|
+
**命令**: `*run-requirements-development`
|
|
213
|
+
|
|
214
|
+
**功能**: 执行从需求分析到用户故事开发完成的完整端到端自动化流程
|
|
215
|
+
|
|
216
|
+
**工作流文件**: `xiaoma-core/workflows/automated-requirements-development.yaml`
|
|
217
|
+
|
|
218
|
+
**核心价值**:
|
|
219
|
+
- ✅ **一键启动**: 只需执行一个命令,完成从 req.txt 到所有代码的端到端开发
|
|
220
|
+
- ✅ **无缝衔接**: 需求分析阶段自动衔接用户故事开发阶段,无需人工干预
|
|
221
|
+
- ✅ **全程自动化**: 整合了两个子工作流的所有优势,实现完整的自动化流程
|
|
222
|
+
- ✅ **质量保证**: 两个阶段的所有质量门控都会自动执行
|
|
223
|
+
|
|
224
|
+
**执行流程**:
|
|
225
|
+
|
|
226
|
+
```yaml
|
|
227
|
+
端到端工作流结构:
|
|
228
|
+
|
|
229
|
+
阶段 1: 需求分析阶段 (1.5-2.5小时)
|
|
230
|
+
├─ 步骤 0/6: 前置环境验证
|
|
231
|
+
├─ 步骤 1/6: Analyst 需求分析
|
|
232
|
+
├─ 步骤 2/6: Architect 架构分析
|
|
233
|
+
├─ 步骤 3/6: PM 创建 PRD
|
|
234
|
+
├─ 步骤 4/6: PM 拆分模块
|
|
235
|
+
├─ 步骤 5/6: Architect 架构设计
|
|
236
|
+
└─ 步骤 6/6: 生成需求分析报告
|
|
237
|
+
↓
|
|
238
|
+
阶段间验证(无缝衔接)
|
|
239
|
+
↓
|
|
240
|
+
阶段 2: 用户故事开发阶段 (40-70分钟/故事)
|
|
241
|
+
循环执行(直到所有用户故事完成):
|
|
242
|
+
├─ 步骤 1: SM 创建用户故事
|
|
243
|
+
├─ 步骤 1.5: 快速构建验证
|
|
244
|
+
├─ 步骤 2: PO 验证故事
|
|
245
|
+
├─ 步骤 2.5: 预开发构建检查
|
|
246
|
+
├─ 步骤 3: Dev 开发故事
|
|
247
|
+
├─ 步骤 4: QA 测试验证
|
|
248
|
+
└─ 步骤 5: 质量门控决策
|
|
249
|
+
↓
|
|
250
|
+
生成端到端完成报告
|
|
251
|
+
```
|
|
252
|
+
|
|
253
|
+
**总耗时**:
|
|
254
|
+
- 阶段 1(需求分析): 约 1.5-2.5 小时
|
|
255
|
+
- 阶段 2(用户故事开发): 约 40-70 分钟 × 用户故事数量
|
|
256
|
+
- **典型小型项目(5-10个故事)**: 4-8 小时
|
|
257
|
+
- **典型中型项目(10-20个故事)**: 8-16 小时
|
|
258
|
+
|
|
259
|
+
**成功标准**:
|
|
260
|
+
|
|
261
|
+
阶段 1 成功标准:
|
|
262
|
+
- ✅ 所有需求分析文档生成完成
|
|
263
|
+
- ✅ PRD 和 Epic 文档创建完成
|
|
264
|
+
- ✅ 架构设计和数据库脚本生成完成
|
|
265
|
+
- ✅ 所有质量门控通过
|
|
266
|
+
|
|
267
|
+
阶段 2 成功标准:
|
|
268
|
+
- ✅ 所有用户故事状态为 Done
|
|
269
|
+
- ✅ 所有测试通过(覆盖率 ≥80%)
|
|
270
|
+
- ✅ 所有 QA 质量门控通过
|
|
271
|
+
- ✅ 代码质量达标
|
|
272
|
+
|
|
273
|
+
整体成功标准:
|
|
274
|
+
- ✅ 两个阶段全部完成
|
|
275
|
+
- ✅ 完整的文档和代码生成
|
|
276
|
+
- ✅ 准备就绪进入集成测试和部署阶段
|
|
277
|
+
|
|
278
|
+
---
|
|
279
|
+
|
|
280
|
+
### 3. 自动化用户故事开发工作流
|
|
209
281
|
|
|
210
282
|
**命令**: `*run-story-development`
|
|
211
283
|
|
|
@@ -391,6 +463,84 @@ quality_gates:
|
|
|
391
463
|
|
|
392
464
|
## 📊 使用示例
|
|
393
465
|
|
|
466
|
+
### 🔥🔥🔥 执行端到端全自动化工作流(推荐)
|
|
467
|
+
|
|
468
|
+
```bash
|
|
469
|
+
# 1. 准备工作
|
|
470
|
+
# 确保 docs/req.txt 文件存在且包含 PM 提供的需求
|
|
471
|
+
|
|
472
|
+
# 2. 激活工作流执行器
|
|
473
|
+
/workflow-executor
|
|
474
|
+
|
|
475
|
+
# 3. 执行端到端全自动化工作流(完全自动化,一键到底)
|
|
476
|
+
*run-requirements-development
|
|
477
|
+
|
|
478
|
+
# ⚡ 核心优势:一个命令完成从需求分析到代码实现的全部工作!
|
|
479
|
+
# ⚠️ 重要提示:工作流执行器会自动连续执行两个阶段的所有步骤,不会在中间暂停
|
|
480
|
+
# 如果工作流在某个步骤停止,说明遇到了错误或质量门控失败,请查看错误信息
|
|
481
|
+
|
|
482
|
+
# 工作流执行器将自动完成以下所有工作(典型小项目 4-8 小时):
|
|
483
|
+
#
|
|
484
|
+
# 【阶段 1: 需求分析】(约 1.5-2.5 小时)
|
|
485
|
+
# ✓ 步骤 0/6: 前置环境验证
|
|
486
|
+
# ✓ 步骤 1/6: Analyst 需求分析 → 生成需求分析报告
|
|
487
|
+
# ✓ 步骤 2/6: Architect 架构分析 → 生成架构分析报告
|
|
488
|
+
# ✓ 步骤 3/6: PM 创建 PRD → 生成 Brownfield PRD
|
|
489
|
+
# ✓ 步骤 4/6: PM 拆分模块 → 生成 Epic 文档
|
|
490
|
+
# ✓ 步骤 5/6: Architect 架构设计 → 生成架构设计和数据库脚本
|
|
491
|
+
# ✓ 步骤 6/6: 生成需求分析完成报告
|
|
492
|
+
# ↓
|
|
493
|
+
# ✓ 阶段间无缝衔接验证
|
|
494
|
+
# ↓
|
|
495
|
+
# 【阶段 2: 用户故事开发】(约 40-70 分钟 × 故事数量)
|
|
496
|
+
# 对每个用户故事循环执行:
|
|
497
|
+
# ✓ SM 创建用户故事 → 快速构建验证
|
|
498
|
+
# ✓ PO 验证故事(10步验证)
|
|
499
|
+
# ✓ 预开发构建检查
|
|
500
|
+
# ✓ Dev 开发实现 + 自测
|
|
501
|
+
# ✓ QA 测试验证(真实数据测试)
|
|
502
|
+
# ✓ 质量门控决策 → Done
|
|
503
|
+
# 直到所有用户故事完成
|
|
504
|
+
# ↓
|
|
505
|
+
# ✓ 生成端到端完成报告
|
|
506
|
+
|
|
507
|
+
# 4. 工作流完成后检查所有输出
|
|
508
|
+
# 阶段 1 输出:
|
|
509
|
+
# - docs/requirements/requirements-analysis.md
|
|
510
|
+
# - docs/architecture/current-architecture-analysis.md
|
|
511
|
+
# - docs/prd/brownfield-iteration-prd.md
|
|
512
|
+
# - docs/epics/Epic-*.md
|
|
513
|
+
# - docs/architecture/iteration-backend-design.md
|
|
514
|
+
# - docs/architecture/db-migration-scripts.sql
|
|
515
|
+
# - docs/architecture/*.md (7个模块文档)
|
|
516
|
+
#
|
|
517
|
+
# 阶段 2 输出:
|
|
518
|
+
# - docs/stories/epic{X}-story{Y}.md (所有故事状态: Done)
|
|
519
|
+
# - src/ 目录下的实现代码
|
|
520
|
+
# - 测试报告
|
|
521
|
+
# - QA gate 文件
|
|
522
|
+
#
|
|
523
|
+
# 完成报告:
|
|
524
|
+
# - docs/end-to-end-completion-report.md
|
|
525
|
+
```
|
|
526
|
+
|
|
527
|
+
**🌟 端到端工作流的特殊优势**:
|
|
528
|
+
|
|
529
|
+
- ✅ **一键到底**: 只需一个命令,无需在两个阶段间手动切换
|
|
530
|
+
- ✅ **无缝衔接**: 阶段1完成后自动验证并进入阶段2,完全自动化
|
|
531
|
+
- ✅ **全程监控**: 统一的进度追踪和质量控制
|
|
532
|
+
- ✅ **完整报告**: 生成包含两个阶段的综合完成报告
|
|
533
|
+
- ✅ **节省时间**: 避免手动操作和阶段间切换的开销
|
|
534
|
+
- ⚠️ **执行时长**: 适合有充足时间的场景(典型小项目 4-8 小时)
|
|
535
|
+
|
|
536
|
+
**🔥 适用场景**:
|
|
537
|
+
- 从零开始的新需求迭代
|
|
538
|
+
- 需要完整的需求分析和代码实现
|
|
539
|
+
- 有充足的执行时间(半天到一天)
|
|
540
|
+
- 希望最小化人工干预
|
|
541
|
+
|
|
542
|
+
---
|
|
543
|
+
|
|
394
544
|
### 执行需求分析工作流
|
|
395
545
|
|
|
396
546
|
```bash
|
|
@@ -411,7 +561,7 @@ quality_gates:
|
|
|
411
561
|
# ✓ 步骤 1/6: 切换到 Analyst 进行需求分析(15-25分钟)
|
|
412
562
|
# ✓ 步骤 2/6: 切换到 Architect 分析现有架构(10-20分钟)
|
|
413
563
|
# ✓ 步骤 3/6: 切换到 PM 创建 Brownfield PRD(20-30分钟)
|
|
414
|
-
# ✓ 步骤 4/6: 切换到 PM
|
|
564
|
+
# ✓ 步骤 4/6: 切换到 PM 拆分模块(取决于模块数量)
|
|
415
565
|
# ✓ 步骤 5/6: 切换到 Architect 设计增量架构(30-40分钟)
|
|
416
566
|
# ✓ 步骤 6/6: 生成完成报告
|
|
417
567
|
|
|
@@ -419,7 +569,7 @@ quality_gates:
|
|
|
419
569
|
# - docs/requirements/requirements-analysis.md
|
|
420
570
|
# - docs/architecture/current-architecture-analysis.md
|
|
421
571
|
# - docs/prd/brownfield-iteration-prd.md
|
|
422
|
-
# - docs/epics
|
|
572
|
+
# - docs/epics/Epic-*.md
|
|
423
573
|
# - docs/architecture/iteration-backend-design.md
|
|
424
574
|
# - docs/architecture/db-migration-scripts.sql
|
|
425
575
|
```
|
|
@@ -469,7 +619,7 @@ quality_gates:
|
|
|
469
619
|
|
|
470
620
|
# 输出示例:
|
|
471
621
|
# 当前工作流: automated-requirements-analysis
|
|
472
|
-
# 当前阶段: stage_4_pm_epics (PM
|
|
622
|
+
# 当前阶段: stage_4_pm_epics (PM 拆分模块)
|
|
473
623
|
# 进度: 60% (3/5 步骤完成)
|
|
474
624
|
# 当前智能体: pm
|
|
475
625
|
# 已完成步骤:
|
|
@@ -478,7 +628,7 @@ quality_gates:
|
|
|
478
628
|
# ✓ stage_2_architect - 架构分析
|
|
479
629
|
# ✓ stage_3_pm_prd - PRD 创建
|
|
480
630
|
# 进行中步骤:
|
|
481
|
-
# ⏳ stage_4_pm_epics -
|
|
631
|
+
# ⏳ stage_4_pm_epics - 模块拆分 (2/4 模块已创建)
|
|
482
632
|
# 待执行步骤:
|
|
483
633
|
# ⏸ stage_5_architect_design - 架构设计
|
|
484
634
|
```
|
|
@@ -580,7 +730,7 @@ escalation_protocol:
|
|
|
580
730
|
*validate-prerequisites
|
|
581
731
|
|
|
582
732
|
# 检查项目:
|
|
583
|
-
# ✓ Epic 文档存在 (docs/epics
|
|
733
|
+
# ✓ Epic 文档存在 (docs/epics/Epic-*.md)
|
|
584
734
|
# ✓ 数据库设计文档存在 (docs/architecture/iteration-backend-design.md)
|
|
585
735
|
# ✓ 架构分析文档存在 (docs/architecture/current-architecture-analysis.md)
|
|
586
736
|
# ✓ 代码生成器配置完成 (如使用 MyBatis-Plus Generator)
|
|
@@ -608,7 +758,7 @@ escalation_protocol:
|
|
|
608
758
|
# 示例输出:
|
|
609
759
|
# 检测到未完成的工作流: automated-requirements-analysis
|
|
610
760
|
# 最后完成的步骤: stage_3_pm_prd (PRD 创建)
|
|
611
|
-
# 准备从步骤 stage_4_pm_epics (
|
|
761
|
+
# 准备从步骤 stage_4_pm_epics (模块拆分) 恢复执行
|
|
612
762
|
#
|
|
613
763
|
# 验证前序输出:
|
|
614
764
|
# ✓ docs/requirements/requirements-analysis.md
|
|
@@ -788,7 +938,7 @@ completion_report:
|
|
|
788
938
|
# ✅ 步骤 1/6: Analyst 需求分析 → 立即开始步骤 2/6...
|
|
789
939
|
# ✅ 步骤 2/6: Architect 架构分析 → 立即开始步骤 3/6...
|
|
790
940
|
# ✅ 步骤 3/6: PM 创建 PRD → 立即开始步骤 4/6...
|
|
791
|
-
# ✅ 步骤 4/6: PM
|
|
941
|
+
# ✅ 步骤 4/6: PM 拆分模块 → 立即开始步骤 5/6...
|
|
792
942
|
# ✅ 步骤 5/6: Architect 架构设计 → 立即开始步骤 6/6...
|
|
793
943
|
# ✅ 步骤 6/6: 生成完成报告 → 🎉 工作流完成!
|
|
794
944
|
|
|
@@ -824,9 +974,9 @@ completion_report:
|
|
|
824
974
|
[20-30分钟后]
|
|
825
975
|
✅ 步骤 3/6 完成: 已生成 docs/prd/brownfield-iteration-prd.md
|
|
826
976
|
|
|
827
|
-
正在执行步骤 4/6: PM
|
|
828
|
-
[
|
|
829
|
-
✅ 步骤 4/6 完成: 已生成 4
|
|
977
|
+
正在执行步骤 4/6: PM 拆分模块...
|
|
978
|
+
[根据模块数量]
|
|
979
|
+
✅ 步骤 4/6 完成: 已生成 4 个模块文档
|
|
830
980
|
|
|
831
981
|
正在执行步骤 5/6: Architect 设计增量架构...
|
|
832
982
|
[30-40分钟后]
|
|
@@ -842,7 +992,7 @@ completion_report:
|
|
|
842
992
|
- docs/requirements/requirements-analysis.md
|
|
843
993
|
- docs/architecture/current-architecture-analysis.md
|
|
844
994
|
- docs/prd/brownfield-iteration-prd.md
|
|
845
|
-
- docs/epics
|
|
995
|
+
- docs/epics/Epic-*.md (4个)
|
|
846
996
|
- docs/architecture/iteration-backend-design.md
|
|
847
997
|
- docs/architecture/db-migration-scripts.sql
|
|
848
998
|
|