@zeyue0329/xiaoma-cli 1.0.42 → 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 +20 -5
- 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 +22 -22
- package/dist/agents/xiaoma-master.txt +20 -20
- package/dist/teams/team-all.txt +45 -45
- 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 +1 -1
- 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 +22 -22
- 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 +10 -10
- 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
|
@@ -5,11 +5,25 @@
|
|
|
5
5
|
</component>
|
|
6
6
|
<component name="ChangeListManager">
|
|
7
7
|
<list default="true" id="4ca3d6ad-bc27-4e67-9acd-07dccd21dd95" name="Changes" comment="drop unchecked message">
|
|
8
|
-
<change beforePath="$PROJECT_DIR$/
|
|
9
|
-
<change beforePath="$PROJECT_DIR$/
|
|
10
|
-
<change beforePath="$PROJECT_DIR$/
|
|
11
|
-
<change beforePath="$PROJECT_DIR$/
|
|
12
|
-
<change beforePath="$PROJECT_DIR$/
|
|
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" />
|
|
13
27
|
</list>
|
|
14
28
|
<option name="SHOW_DIALOG" value="false" />
|
|
15
29
|
<option name="HIGHLIGHT_CONFLICTS" value="true" />
|
|
@@ -74,6 +88,7 @@
|
|
|
74
88
|
<workItem from="1762781553645" duration="3390000" />
|
|
75
89
|
<workItem from="1762933631198" duration="16000" />
|
|
76
90
|
<workItem from="1763045898895" duration="4599000" />
|
|
91
|
+
<workItem from="1763520819252" duration="1863000" />
|
|
77
92
|
</task>
|
|
78
93
|
<task id="LOCAL-00001" summary="drop unchecked message">
|
|
79
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,7 +78,7 @@ 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 到最终的架构设计文档,全程自动化无需人工干预
|
|
@@ -158,7 +158,7 @@ workflow_stages:
|
|
|
158
158
|
tasks:
|
|
159
159
|
- 创建 Brownfield 项目迭代需求的 PRD 文档
|
|
160
160
|
- 定义功能模块、数据变更、API 规范
|
|
161
|
-
-
|
|
161
|
+
- 制定验收标准和模块拆分建议
|
|
162
162
|
- 自检 PRD 质量(16项检查)
|
|
163
163
|
outputs:
|
|
164
164
|
- docs/prd/brownfield-iteration-prd.md
|
|
@@ -166,15 +166,15 @@ workflow_stages:
|
|
|
166
166
|
stage_4_pm_epics:
|
|
167
167
|
agent: pm
|
|
168
168
|
command: "*create-epic"
|
|
169
|
-
duration: "
|
|
169
|
+
duration: "变动,取决于模块数量"
|
|
170
170
|
tasks:
|
|
171
|
-
- 从 PRD
|
|
172
|
-
-
|
|
171
|
+
- 从 PRD 提取模块清单
|
|
172
|
+
- 循环创建每个模块文档
|
|
173
173
|
- 初步识别用户故事
|
|
174
174
|
- 定义技术设计概要和数据库/API 变更
|
|
175
|
-
-
|
|
175
|
+
- 验证模块质量
|
|
176
176
|
outputs:
|
|
177
|
-
- docs/epics
|
|
177
|
+
- docs/epics/Epic-*.md (多个模块文件)
|
|
178
178
|
|
|
179
179
|
stage_5_architect_design:
|
|
180
180
|
agent: architect
|
|
@@ -183,7 +183,7 @@ workflow_stages:
|
|
|
183
183
|
duration: "30-40分钟"
|
|
184
184
|
inputs:
|
|
185
185
|
- docs/prd/brownfield-iteration-prd.md
|
|
186
|
-
- docs/epics
|
|
186
|
+
- docs/epics/Epic-*.md
|
|
187
187
|
- docs/architecture/current-architecture-analysis.md
|
|
188
188
|
tasks:
|
|
189
189
|
- 设计新增数据模型(Entity + DDL)
|
|
@@ -231,7 +231,7 @@ workflow_stages:
|
|
|
231
231
|
├─ 步骤 1/6: Analyst 需求分析
|
|
232
232
|
├─ 步骤 2/6: Architect 架构分析
|
|
233
233
|
├─ 步骤 3/6: PM 创建 PRD
|
|
234
|
-
├─ 步骤 4/6: PM
|
|
234
|
+
├─ 步骤 4/6: PM 拆分模块
|
|
235
235
|
├─ 步骤 5/6: Architect 架构设计
|
|
236
236
|
└─ 步骤 6/6: 生成需求分析报告
|
|
237
237
|
↓
|
|
@@ -486,7 +486,7 @@ quality_gates:
|
|
|
486
486
|
# ✓ 步骤 1/6: Analyst 需求分析 → 生成需求分析报告
|
|
487
487
|
# ✓ 步骤 2/6: Architect 架构分析 → 生成架构分析报告
|
|
488
488
|
# ✓ 步骤 3/6: PM 创建 PRD → 生成 Brownfield PRD
|
|
489
|
-
# ✓ 步骤 4/6: PM
|
|
489
|
+
# ✓ 步骤 4/6: PM 拆分模块 → 生成 Epic 文档
|
|
490
490
|
# ✓ 步骤 5/6: Architect 架构设计 → 生成架构设计和数据库脚本
|
|
491
491
|
# ✓ 步骤 6/6: 生成需求分析完成报告
|
|
492
492
|
# ↓
|
|
@@ -509,7 +509,7 @@ quality_gates:
|
|
|
509
509
|
# - docs/requirements/requirements-analysis.md
|
|
510
510
|
# - docs/architecture/current-architecture-analysis.md
|
|
511
511
|
# - docs/prd/brownfield-iteration-prd.md
|
|
512
|
-
# - docs/epics
|
|
512
|
+
# - docs/epics/Epic-*.md
|
|
513
513
|
# - docs/architecture/iteration-backend-design.md
|
|
514
514
|
# - docs/architecture/db-migration-scripts.sql
|
|
515
515
|
# - docs/architecture/*.md (7个模块文档)
|
|
@@ -561,7 +561,7 @@ quality_gates:
|
|
|
561
561
|
# ✓ 步骤 1/6: 切换到 Analyst 进行需求分析(15-25分钟)
|
|
562
562
|
# ✓ 步骤 2/6: 切换到 Architect 分析现有架构(10-20分钟)
|
|
563
563
|
# ✓ 步骤 3/6: 切换到 PM 创建 Brownfield PRD(20-30分钟)
|
|
564
|
-
# ✓ 步骤 4/6: 切换到 PM
|
|
564
|
+
# ✓ 步骤 4/6: 切换到 PM 拆分模块(取决于模块数量)
|
|
565
565
|
# ✓ 步骤 5/6: 切换到 Architect 设计增量架构(30-40分钟)
|
|
566
566
|
# ✓ 步骤 6/6: 生成完成报告
|
|
567
567
|
|
|
@@ -569,7 +569,7 @@ quality_gates:
|
|
|
569
569
|
# - docs/requirements/requirements-analysis.md
|
|
570
570
|
# - docs/architecture/current-architecture-analysis.md
|
|
571
571
|
# - docs/prd/brownfield-iteration-prd.md
|
|
572
|
-
# - docs/epics
|
|
572
|
+
# - docs/epics/Epic-*.md
|
|
573
573
|
# - docs/architecture/iteration-backend-design.md
|
|
574
574
|
# - docs/architecture/db-migration-scripts.sql
|
|
575
575
|
```
|
|
@@ -619,7 +619,7 @@ quality_gates:
|
|
|
619
619
|
|
|
620
620
|
# 输出示例:
|
|
621
621
|
# 当前工作流: automated-requirements-analysis
|
|
622
|
-
# 当前阶段: stage_4_pm_epics (PM
|
|
622
|
+
# 当前阶段: stage_4_pm_epics (PM 拆分模块)
|
|
623
623
|
# 进度: 60% (3/5 步骤完成)
|
|
624
624
|
# 当前智能体: pm
|
|
625
625
|
# 已完成步骤:
|
|
@@ -628,7 +628,7 @@ quality_gates:
|
|
|
628
628
|
# ✓ stage_2_architect - 架构分析
|
|
629
629
|
# ✓ stage_3_pm_prd - PRD 创建
|
|
630
630
|
# 进行中步骤:
|
|
631
|
-
# ⏳ stage_4_pm_epics -
|
|
631
|
+
# ⏳ stage_4_pm_epics - 模块拆分 (2/4 模块已创建)
|
|
632
632
|
# 待执行步骤:
|
|
633
633
|
# ⏸ stage_5_architect_design - 架构设计
|
|
634
634
|
```
|
|
@@ -730,7 +730,7 @@ escalation_protocol:
|
|
|
730
730
|
*validate-prerequisites
|
|
731
731
|
|
|
732
732
|
# 检查项目:
|
|
733
|
-
# ✓ Epic 文档存在 (docs/epics
|
|
733
|
+
# ✓ Epic 文档存在 (docs/epics/Epic-*.md)
|
|
734
734
|
# ✓ 数据库设计文档存在 (docs/architecture/iteration-backend-design.md)
|
|
735
735
|
# ✓ 架构分析文档存在 (docs/architecture/current-architecture-analysis.md)
|
|
736
736
|
# ✓ 代码生成器配置完成 (如使用 MyBatis-Plus Generator)
|
|
@@ -758,7 +758,7 @@ escalation_protocol:
|
|
|
758
758
|
# 示例输出:
|
|
759
759
|
# 检测到未完成的工作流: automated-requirements-analysis
|
|
760
760
|
# 最后完成的步骤: stage_3_pm_prd (PRD 创建)
|
|
761
|
-
# 准备从步骤 stage_4_pm_epics (
|
|
761
|
+
# 准备从步骤 stage_4_pm_epics (模块拆分) 恢复执行
|
|
762
762
|
#
|
|
763
763
|
# 验证前序输出:
|
|
764
764
|
# ✓ docs/requirements/requirements-analysis.md
|
|
@@ -938,7 +938,7 @@ completion_report:
|
|
|
938
938
|
# ✅ 步骤 1/6: Analyst 需求分析 → 立即开始步骤 2/6...
|
|
939
939
|
# ✅ 步骤 2/6: Architect 架构分析 → 立即开始步骤 3/6...
|
|
940
940
|
# ✅ 步骤 3/6: PM 创建 PRD → 立即开始步骤 4/6...
|
|
941
|
-
# ✅ 步骤 4/6: PM
|
|
941
|
+
# ✅ 步骤 4/6: PM 拆分模块 → 立即开始步骤 5/6...
|
|
942
942
|
# ✅ 步骤 5/6: Architect 架构设计 → 立即开始步骤 6/6...
|
|
943
943
|
# ✅ 步骤 6/6: 生成完成报告 → 🎉 工作流完成!
|
|
944
944
|
|
|
@@ -974,9 +974,9 @@ completion_report:
|
|
|
974
974
|
[20-30分钟后]
|
|
975
975
|
✅ 步骤 3/6 完成: 已生成 docs/prd/brownfield-iteration-prd.md
|
|
976
976
|
|
|
977
|
-
正在执行步骤 4/6: PM
|
|
978
|
-
[
|
|
979
|
-
✅ 步骤 4/6 完成: 已生成 4
|
|
977
|
+
正在执行步骤 4/6: PM 拆分模块...
|
|
978
|
+
[根据模块数量]
|
|
979
|
+
✅ 步骤 4/6 完成: 已生成 4 个模块文档
|
|
980
980
|
|
|
981
981
|
正在执行步骤 5/6: Architect 设计增量架构...
|
|
982
982
|
[30-40分钟后]
|
|
@@ -992,7 +992,7 @@ completion_report:
|
|
|
992
992
|
- docs/requirements/requirements-analysis.md
|
|
993
993
|
- docs/architecture/current-architecture-analysis.md
|
|
994
994
|
- docs/prd/brownfield-iteration-prd.md
|
|
995
|
-
- docs/epics
|
|
995
|
+
- docs/epics/Epic-*.md (4个)
|
|
996
996
|
- docs/architecture/iteration-backend-design.md
|
|
997
997
|
- docs/architecture/db-migration-scripts.sql
|
|
998
998
|
|
|
@@ -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
|
- 确保每个故事都交付明确的用户或业务价值,尽量避免使能型故事,而是将它们构建到交付价值的故事中。
|