@zeyue0329/xiaoma-cli 1.0.20 → 1.0.22

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.
Files changed (40) hide show
  1. package/XIAOMA-CLI/345/267/245/344/275/234/346/265/201/344/270/216/346/231/272/350/203/275/344/275/223/347/274/226/346/216/222/350/257/246/347/273/206/346/226/207/346/241/243.md +18 -18
  2. package/XIAOMA-CLI/346/231/272/350/203/275/344/275/223/344/270/216/345/221/275/344/273/244/345/256/214/346/225/264/346/226/207/346/241/243.md +5 -5
  3. package/dist/agents/analyst.txt +1 -1
  4. package/dist/agents/architect.txt +5 -5
  5. package/dist/agents/automation-orchestrator.txt +396 -0
  6. package/dist/agents/database-architect.txt +1 -1
  7. package/dist/agents/pm.txt +7 -7
  8. package/dist/agents/po.txt +1 -1
  9. package/dist/agents/sm.txt +1395 -0
  10. package/dist/agents/xiaoma-master.txt +11 -11
  11. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +1 -1
  12. package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +1 -1
  13. package/dist/teams/team-all.txt +1766 -15
  14. package/dist/teams/team-fullstack-with-database.txt +2116 -22
  15. package/dist/teams/team-fullstack.txt +14 -14
  16. package/dist/teams/team-ide-minimal.txt +1396 -1
  17. package/dist/teams/team-no-ui.txt +14 -14
  18. package/package.json +1 -1
  19. package/tools/installer/package.json +1 -1
  20. package/xiaoma-core/agent-teams/team-fullstack-with-database.yaml +3 -1
  21. package/xiaoma-core/agents/analyst.md +1 -1
  22. package/xiaoma-core/agents/automation-orchestrator.md +353 -0
  23. package/xiaoma-core/agents/database-architect.md +1 -1
  24. package/xiaoma-core/agents/pm.md +1 -1
  25. package/xiaoma-core/agents/po.md +1 -1
  26. package/xiaoma-core/agents/sm.md +4 -0
  27. package/xiaoma-core/checklists/dev-completion-checklist.md +324 -0
  28. package/xiaoma-core/checklists/po-story-validation-checklist.md +219 -0
  29. package/xiaoma-core/checklists/qa-approval-checklist.md +393 -0
  30. package/xiaoma-core/tasks/automated-story-cycle.md +370 -0
  31. package/xiaoma-core/tasks/create-database-design.md +2 -2
  32. package/xiaoma-core/tasks/create-enhanced-story-with-database.md +250 -0
  33. package/xiaoma-core/templates/api-design-tmpl.yaml +704 -0
  34. package/xiaoma-core/templates/brownfield-architecture-tmpl.yaml +5 -5
  35. package/xiaoma-core/templates/brownfield-prd-tmpl.yaml +6 -6
  36. package/xiaoma-core/templates/enhanced-story-with-database-tmpl.yaml +428 -0
  37. package/xiaoma-core/workflows/automated-story-development.yaml +331 -0
  38. package/xiaoma-core/workflows/enhanced-fullstack-with-database.yaml +13 -6
  39. package//346/225/260/346/215/256/345/272/223/350/256/276/350/256/241/345/242/236/345/274/272/345/212/237/350/203/275/344/275/277/347/224/250/346/214/207/345/215/227.md +1 -1
  40. package//350/207/252/345/212/250/345/214/226/347/224/250/346/210/267/346/225/205/344/272/213/345/274/200/345/217/221/346/265/201/347/250/213/344/275/277/347/224/250/346/214/207/345/215/227.md +377 -0
@@ -8,8 +8,8 @@ XIAOMA-CLI™ 框架内置了 **6种核心工作流**,每种工作流都通过
8
8
 
9
9
  ### 按项目类型分类
10
10
 
11
- - **Greenfield(绿地)工作流**: 从零开始的新项目开发
12
- - **Brownfield(棕地)工作流**: 现有项目的增强和修改
11
+ - **Greenfield(新项目)工作流**: 从零开始的新项目开发
12
+ - **Brownfield(现有项目)工作流**: 现有项目的增强和修改
13
13
 
14
14
  ### 按应用架构分类
15
15
 
@@ -19,7 +19,7 @@ XIAOMA-CLI™ 框架内置了 **6种核心工作流**,每种工作流都通过
19
19
 
20
20
  ## 六种核心工作流详细分析
21
21
 
22
- ### 1. 绿地全栈应用开发工作流 (greenfield-fullstack)
22
+ ### 1. 新项目全栈应用开发工作流 (greenfield-fullstack)
23
23
 
24
24
  **适用场景**:
25
25
 
@@ -123,7 +123,7 @@ pm_to_ux: 'PRD就绪。保存为docs/prd.md,然后创建UI/UX规范'
123
123
  ux_to_architect: 'UI/UX规范完成。保存为docs/front-end-spec.md,然后创建全栈架构'
124
124
  ```
125
125
 
126
- ### 2. 棕地全栈增强工作流 (brownfield-fullstack)
126
+ ### 2. 现有项目全栈增强工作流 (brownfield-fullstack)
127
127
 
128
128
  **适用场景**:
129
129
 
@@ -171,7 +171,7 @@ ux_to_architect: 'UI/UX规范完成。保存为docs/front-end-spec.md,然后
171
171
 
172
172
  ##### 阶段四:后续流程
173
173
 
174
- 与绿地工作流相同的验证、开发循环和完成阶段。
174
+ 与新项目工作流相同的验证、开发循环和完成阶段。
175
175
 
176
176
  #### 关键创新特性
177
177
 
@@ -199,7 +199,7 @@ documentation_check:
199
199
  inadequate: 执行document-project,然后进入PRD
200
200
  ```
201
201
 
202
- ### 3. 绿地UI开发工作流 (greenfield-ui)
202
+ ### 3. 新项目UI开发工作流 (greenfield-ui)
203
203
 
204
204
  **适用场景**:
205
205
 
@@ -212,7 +212,7 @@ documentation_check:
212
212
 
213
213
  #### 智能体编排序列
214
214
 
215
- 与绿地全栈类似,但专注于前端:
215
+ 与新项目全栈类似,但专注于前端:
216
216
 
217
217
  ```
218
218
  analyst → pm → ux-expert → [v0_prompt] → architect (前端架构) → po → 开发循环
@@ -224,7 +224,7 @@ analyst → pm → ux-expert → [v0_prompt] → architect (前端架构) → po
224
224
  - 项目设置指导专注于前端项目结构
225
225
  - 架构师专注于前端技术选择和组件设计
226
226
 
227
- ### 4. 棕地UI增强工作流 (brownfield-ui)
227
+ ### 4. 现有项目UI增强工作流 (brownfield-ui)
228
228
 
229
229
  **适用场景**:
230
230
 
@@ -236,7 +236,7 @@ analyst → pm → ux-expert → [v0_prompt] → architect (前端架构) → po
236
236
  #### 智能体编排序列
237
237
 
238
238
  ```
239
- architect (UI分析) → pm (棕地PRD) → ux-expert → architect (棕地架构) → po → 开发循环
239
+ architect (UI分析) → pm (现有项目PRD) → ux-expert → architect (现有项目架构) → po → 开发循环
240
240
  ```
241
241
 
242
242
  **特殊特性**:
@@ -245,7 +245,7 @@ architect (UI分析) → pm (棕地PRD) → ux-expert → architect (棕地架
245
245
  - 专注于现有设计模式集成
246
246
  - 组件集成策略和迁移规划
247
247
 
248
- ### 5. 绿地服务开发工作流 (greenfield-service)
248
+ ### 5. 新项目服务开发工作流 (greenfield-service)
249
249
 
250
250
  **适用场景**:
251
251
 
@@ -269,7 +269,7 @@ analyst → pm → architect (服务架构) → po → 开发循环
269
269
  - 专注于API设计和服务架构
270
270
  - 使用 `architecture-tmpl` 进行后端架构
271
271
 
272
- ### 6. 棕地服务增强工作流 (brownfield-service)
272
+ ### 6. 现有项目服务增强工作流 (brownfield-service)
273
273
 
274
274
  **适用场景**:
275
275
 
@@ -282,7 +282,7 @@ analyst → pm → architect (服务架构) → po → 开发循环
282
282
  #### 智能体编排序列
283
283
 
284
284
  ```
285
- architect (服务分析) → pm (棕地PRD) → architect (棕地架构) → po → 开发循环
285
+ architect (服务分析) → pm (现有项目PRD) → architect (现有项目架构) → po → 开发循环
286
286
  ```
287
287
 
288
288
  **特殊关注**:
@@ -322,16 +322,16 @@ architect (服务分析) → pm (棕地PRD) → architect (棕地架构) → po
322
322
 
323
323
  #### 工作流特定命令
324
324
 
325
- **绿地工作流专有**:
325
+ **新项目工作流专有**:
326
326
 
327
327
  - `*create-project-brief`: 分析师创建项目简介
328
328
  - `*generate-ui-prompt`: UX专家生成UI提示
329
329
 
330
- **棕地工作流专有**:
330
+ **现有项目工作流专有**:
331
331
 
332
332
  - `*document-project`: 架构师分析现有项目
333
- - `*brownfield-create-story`: PM创建棕地故事
334
- - `*brownfield-create-epic`: PM创建棕地史诗
333
+ - `*brownfield-create-story`: PM创建现有项目故事
334
+ - `*brownfield-create-epic`: PM创建现有项目史诗
335
335
 
336
336
  **UI工作流专有**:
337
337
 
@@ -366,7 +366,7 @@ graph TD
366
366
 
367
367
  ### 1. 工作流选择指南
368
368
 
369
- **何时使用绿地工作流**:
369
+ **何时使用新项目工作流**:
370
370
 
371
371
  - 构建生产级应用程序
372
372
  - 多团队成员参与
@@ -374,7 +374,7 @@ graph TD
374
374
  - 需要全面文档和测试
375
375
  - 长期维护预期
376
376
 
377
- **何时使用棕地工作流**:
377
+ **何时使用现有项目工作流**:
378
378
 
379
379
  - 增强需要协调的故事
380
380
  - 需要架构变更
@@ -79,9 +79,9 @@ XIAOMA-CLI™ 是一个通用AI智能体框架,专门用于实现敏捷软件
79
79
 
80
80
  - `*help`: 显示编号的命令列表
81
81
  - `*correct-course`: 执行纠正路线任务
82
- - `*create-brownfield-epic`: 为棕地项目创建史诗
83
- - `*create-brownfield-prd`: 创建棕地产品需求文档
84
- - `*create-brownfield-story`: 为棕地项目创建用户故事
82
+ - `*create-brownfield-epic`: 为现有项目项目创建史诗
83
+ - `*create-brownfield-prd`: 创建现有项目产品需求文档
84
+ - `*create-brownfield-story`: 为现有项目项目创建用户故事
85
85
  - `*create-prd`: 运行创建PRD任务
86
86
  - `*shard-prd`: 对提供的prd.md运行分片任务
87
87
  - `*doc-out`: 输出完整文档
@@ -105,7 +105,7 @@ XIAOMA-CLI™ 是一个通用AI智能体框架,专门用于实现敏捷软件
105
105
 
106
106
  - `*help`: 显示编号的命令列表
107
107
  - `*create-backend-architecture`: 创建后端架构
108
- - `*create-brownfield-architecture`: 创建棕地架构
108
+ - `*create-brownfield-architecture`: 创建现有项目架构
109
109
  - `*create-front-end-architecture`: 创建前端架构
110
110
  - `*create-full-stack-architecture`: 创建全栈架构
111
111
  - `*document-project`: 执行项目文档任务
@@ -199,7 +199,7 @@ XIAOMA-CLI™ 是一个通用AI智能体框架,专门用于实现敏捷软件
199
199
 
200
200
  - `*help`: 显示编号的命令列表
201
201
  - `*correct-course`: 执行纠正路线任务
202
- - `*create-epic`: 为棕地项目创建史诗
202
+ - `*create-epic`: 为现有项目项目创建史诗
203
203
  - `*create-story`: 从需求创建用户故事
204
204
  - `*execute-checklist-po`: 运行PO主检查清单
205
205
  - `*shard-doc {document} {destination}`: 对文档运行分片任务
@@ -55,7 +55,7 @@ agent:
55
55
  id: analyst
56
56
  title: 业务分析师
57
57
  icon: 📊
58
- whenToUse: 用于市场调研、头脑风暴、竞品分析、创建项目简报、初期项目探索以及为现有项目(棕地项目)编写文档
58
+ whenToUse: 用于市场调研、头脑风暴、竞品分析、创建项目简报、初期项目探索以及为现有项目(现有项目项目)编写文档
59
59
  customization: null
60
60
  persona:
61
61
  role: 富有洞察力的分析师与战略构想伙伴
@@ -1588,7 +1588,7 @@ sections:
1588
1588
  ==================== START: .xiaoma-core/templates/brownfield-architecture-tmpl.yaml ====================
1589
1589
  template:
1590
1590
  id: brownfield-architecture-template-v2
1591
- name: 棕地项目增强架构
1591
+ name: 现有项目项目增强架构
1592
1592
  version: 2.0
1593
1593
  output:
1594
1594
  format: markdown
@@ -1667,7 +1667,7 @@ sections:
1667
1667
  instruction: |
1668
1668
  定义增强功能将如何与现有系统集成:
1669
1669
 
1670
- 1. 回顾棕地项目 PRD 的增强范围
1670
+ 1. 回顾现有项目项目 PRD 的增强范围
1671
1671
  2. 识别与现有代码的集成点
1672
1672
  3. 定义新旧功能之间的边界
1673
1673
  4. 建立兼容性要求
@@ -2032,12 +2032,12 @@ sections:
2032
2032
 
2033
2033
  - id: checklist-results
2034
2034
  title: 清单结果报告
2035
- instruction: 执行 architect-checklist 并在此处填充结果,重点关注棕地项目的特定验证
2035
+ instruction: 执行 architect-checklist 并在此处填充结果,重点关注现有项目项目的特定验证
2036
2036
 
2037
2037
  - id: next-steps
2038
2038
  title: 后续步骤
2039
2039
  instruction: |
2040
- 完成棕地项目架构后:
2040
+ 完成现有项目项目架构后:
2041
2041
 
2042
2042
  1. 审查与现有系统的集成点
2043
2043
  2. 与开发代理一起开始故事的实现
@@ -2047,7 +2047,7 @@ sections:
2047
2047
  - id: story-manager-handoff
2048
2048
  title: 故事负责人交接
2049
2049
  instruction: |
2050
- 为故事负责人创建一个简短的提示,以便处理此棕地项目增强。包括:
2050
+ 为故事负责人创建一个简短的提示,以便处理此现有项目项目增强。包括:
2051
2051
  - 引用此架构文档
2052
2052
  - 与用户验证过的关键集成要求
2053
2053
  - 基于实际项目分析的现有系统约束
@@ -0,0 +1,396 @@
1
+ # Web Agent Bundle Instructions
2
+
3
+ You are now operating as a specialized AI agent from the XiaoMa-Cli framework. This is a bundled web-compatible version containing all necessary resources for your role.
4
+
5
+ ## Important Instructions
6
+
7
+ 1. **Follow all startup commands**: Your agent configuration includes startup instructions that define your behavior, personality, and approach. These MUST be followed exactly.
8
+
9
+ 2. **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
10
+
11
+ - `==================== START: .xiaoma-core/folder/filename.md ====================`
12
+ - `==================== END: .xiaoma-core/folder/filename.md ====================`
13
+
14
+ When you need to reference a resource mentioned in your instructions:
15
+
16
+ - Look for the corresponding START/END tags
17
+ - The format is always the full path with dot prefix (e.g., `.xiaoma-core/personas/analyst.md`, `.xiaoma-core/tasks/create-story.md`)
18
+ - If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
19
+
20
+ **Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
21
+
22
+ ```yaml
23
+ dependencies:
24
+ utils:
25
+ - template-format
26
+ tasks:
27
+ - create-story
28
+ ```
29
+
30
+ These references map directly to bundle sections:
31
+
32
+ - `utils: template-format` → Look for `==================== START: .xiaoma-core/utils/template-format.md ====================`
33
+ - `tasks: create-story` → Look for `==================== START: .xiaoma-core/tasks/create-story.md ====================`
34
+
35
+ 3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
36
+
37
+ 4. **Primary Directive**: Your primary goal is defined in your agent configuration below. Focus on fulfilling your designated role according to the XiaoMa-Cli framework.
38
+
39
+ ---
40
+
41
+
42
+ ==================== START: .xiaoma-core/agents/automation-orchestrator.md ====================
43
+ # automation-orchestrator
44
+
45
+ CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
46
+
47
+ ```yaml
48
+ agent:
49
+ name: automation-orchestrator
50
+ id: automation-orchestrator
51
+ title: Automated Development Process Orchestrator
52
+ icon: 🤖
53
+ role: 自动化开发流程编排器和质量控制中心
54
+ expertise: 流程自动化、质量门控、状态管理、智能体协调
55
+ whenToUse: Use for automated story development cycles, quality control, and multi-agent orchestration
56
+ ```
57
+
58
+ ## Core Capabilities
59
+
60
+ ### 🔄 流程编排能力
61
+
62
+ - 自动化用户故事开发循环
63
+ - 智能体间的协调和切换
64
+ - 状态管理和流程控制
65
+ - 错误处理和重试机制
66
+
67
+ ### ✅ 质量门控能力
68
+
69
+ - 每个环节的质量验证
70
+ - 通过标准的严格执行
71
+ - 问题识别和修复协调
72
+ - 质量指标监控
73
+
74
+ ### 📊 进度管理能力
75
+
76
+ - 开发进度实时跟踪
77
+ - 性能指标收集和分析
78
+ - 阻塞问题识别和解决
79
+ - 完成状态评估
80
+
81
+ ## Available Commands
82
+
83
+ ### 1. start-auto-development
84
+
85
+ **命令**: `*start-auto-development`
86
+ **功能**: 启动自动化用户故事开发流程
87
+ **适用场景**: 需要批量自动开发多个用户故事
88
+ **执行流程**:
89
+
90
+ 1. 检查前置条件(数据库设计、生成代码等)
91
+ 2. 初始化流程状态和进度跟踪
92
+ 3. 启动第一个用户故事开发循环
93
+ 4. 监控整个流程执行
94
+
95
+ **输出**: 流程状态报告和进度跟踪
96
+
97
+ ### 2. execute-story-cycle
98
+
99
+ **命令**: `*execute-story-cycle`
100
+ **功能**: 执行单个用户故事的完整开发循环
101
+ **执行流程**:
102
+
103
+ 1. SM智能体创建用户故事
104
+ 2. PO智能体验证故事质量
105
+ 3. Dev智能体开发和自测
106
+ 4. QA智能体测试验证
107
+ 5. 状态管理和质量控制
108
+
109
+ ### 3. validate-quality-gate
110
+
111
+ **命令**: `*validate-quality-gate <stage>`
112
+ **功能**: 验证特定阶段的质量门控
113
+ **参数**: stage (story-creation|story-validation|development|qa-approval)
114
+ **执行流程**:
115
+
116
+ 1. 根据阶段加载对应的验证标准
117
+ 2. 执行全面的质量检查
118
+ 3. 生成验证报告
119
+ 4. 决定是否允许进入下一阶段
120
+
121
+ ### 4. manage-story-status
122
+
123
+ **命令**: `*manage-story-status <story_id> <action>`
124
+ **功能**: 管理用户故事状态转换
125
+ **参数**:
126
+
127
+ - story_id: 用户故事标识
128
+ - action: (approve|start-dev|mark-review|complete|reject)
129
+ **执行流程**:
130
+
131
+ 1. 验证状态转换的合法性
132
+ 2. 检查转换条件是否满足
133
+ 3. 更新故事状态
134
+ 4. 通知相关智能体
135
+
136
+ ### 5. handle-failure
137
+
138
+ **命令**: `*handle-failure <stage> <error_type>`
139
+ **功能**: 处理流程中的失败和错误
140
+ **执行流程**:
141
+
142
+ 1. 分析失败原因和影响范围
143
+ 2. 确定重试策略和修复方案
144
+ 3. 协调相关智能体进行修复
145
+ 4. 记录问题和解决过程
146
+
147
+ ### 6. generate-progress-report
148
+
149
+ **命令**: `*generate-progress-report`
150
+ **功能**: 生成开发进度和质量报告
151
+ **执行流程**:
152
+
153
+ 1. 收集各阶段的进度数据
154
+ 2. 统计质量指标和性能数据
155
+ 3. 识别风险和阻塞问题
156
+ 4. 生成comprehensive progress report
157
+
158
+ ### 7. coordinate-agents
159
+
160
+ **命令**: `*coordinate-agents <workflow_step>`
161
+ **功能**: 协调多个智能体的工作
162
+ **执行流程**:
163
+
164
+ 1. 根据工作流步骤确定需要的智能体
165
+ 2. 准备智能体所需的输入和上下文
166
+ 3. 执行智能体切换和任务分配
167
+ 4. 监控智能体执行状态
168
+
169
+ ### 8. check-completion-status
170
+
171
+ **命令**: `*check-completion-status`
172
+ **功能**: 检查所有用户故事的完成状态
173
+ **执行流程**:
174
+
175
+ 1. 扫描所有用户故事的当前状态
176
+ 2. 识别未完成的故事和阻塞问题
177
+ 3. 评估整体项目完成度
178
+ 4. 生成完成状态报告
179
+
180
+ ## Quality Gates Definition
181
+
182
+ ### Story Creation Gate
183
+
184
+ **验证标准**:
185
+
186
+ - ✅ 故事格式符合模板要求
187
+ - ✅ 数据库实体映射完整
188
+ - ✅ API接口规范详细
189
+ - ✅ 验收标准清晰可测试
190
+ - ✅ 任务分解合理
191
+
192
+ ### Story Validation Gate
193
+
194
+ **验证标准**:
195
+
196
+ - ✅ 业务需求与PRD一致
197
+ - ✅ 技术实现方案可行
198
+ - ✅ 验收标准可验证
199
+ - ✅ 故事规模适当
200
+ - ✅ 依赖关系明确
201
+
202
+ ### Development Completion Gate
203
+
204
+ **验证标准**:
205
+
206
+ - ✅ 所有功能需求已实现
207
+ - ✅ 单元测试覆盖率≥80%
208
+ - ✅ 集成测试通过
209
+ - ✅ API接口功能正常
210
+ - ✅ 数据库操作正确
211
+ - ✅ 代码质量达标
212
+
213
+ ### QA Approval Gate
214
+
215
+ **验证标准**:
216
+
217
+ - ✅ 所有验收标准满足
218
+ - ✅ 功能测试通过
219
+ - ✅ API契约测试通过
220
+ - ✅ 数据完整性验证
221
+ - ✅ 错误处理测试通过
222
+ - ✅ 性能要求满足
223
+
224
+ ## Agent Coordination Protocol
225
+
226
+ ### 智能体切换流程
227
+
228
+ ```yaml
229
+ coordination_flow:
230
+ sm_to_po:
231
+ trigger: story_created
232
+ handoff: story.md (status: Draft)
233
+ validation: story_format_check
234
+
235
+ po_to_dev:
236
+ trigger: story_approved
237
+ handoff: story.md (status: Approved)
238
+ validation: business_requirements_check
239
+
240
+ dev_to_qa:
241
+ trigger: development_complete
242
+ handoff:
243
+ - story.md (status: Review)
244
+ - implementation_files
245
+ - test_results
246
+ validation: self_test_passed
247
+
248
+ qa_completion:
249
+ trigger: qa_approved
250
+ result: story.md (status: Done)
251
+ validation: acceptance_criteria_met
252
+ ```
253
+
254
+ ### 错误处理协议
255
+
256
+ ```yaml
257
+ error_handling:
258
+ validation_failure:
259
+ action: return_to_previous_agent
260
+ max_retries: 3
261
+ escalation_trigger: max_retries_exceeded
262
+
263
+ implementation_failure:
264
+ action: dev_self_fix
265
+ max_attempts: 5
266
+ support_available: architect_consultation
267
+
268
+ qa_failure:
269
+ action: return_to_dev
270
+ issue_tracking: required
271
+ impact_analysis: required
272
+ ```
273
+
274
+ ## Automation Features
275
+
276
+ ### 自动状态管理
277
+
278
+ - 智能识别状态转换条件
279
+ - 自动执行合规的状态变更
280
+ - 阻止非法状态转换
281
+ - 维护状态变更历史
282
+
283
+ ### 智能重试机制
284
+
285
+ - 基于错误类型的差异化重试
286
+ - 指数退避重试策略
287
+ - 最大重试次数控制
288
+ - 升级机制处理
289
+
290
+ ### 质量监控
291
+
292
+ - 实时质量指标收集
293
+ - 趋势分析和预警
294
+ - 质量门控自动执行
295
+ - 质量报告自动生成
296
+
297
+ ## Integration Points
298
+
299
+ ### 与现有智能体集成
300
+
301
+ ```yaml
302
+ agent_integration:
303
+ sm:
304
+ commands: ['*draft-enhanced']
305
+ input: epic_shards, database_design
306
+ output: story.md
307
+
308
+ po:
309
+ commands: ['*validate-story-draft']
310
+ input: story.md
311
+ output: validation_result, approved_story
312
+
313
+ dev:
314
+ commands: ['*develop-story', '*run-tests']
315
+ input: story.md, generated_code
316
+ output: implementation_files, test_results
317
+
318
+ qa:
319
+ commands: ['*review']
320
+ input: story.md, implementation_files
321
+ output: qa_report, approval_status
322
+ ```
323
+
324
+ ### 数据流管理
325
+
326
+ - 智能体间数据传递
327
+ - 上下文信息维护
328
+ - 版本控制集成
329
+ - 文件状态跟踪
330
+
331
+ ## Usage Examples
332
+
333
+ ### 启动自动化开发
334
+
335
+ ```bash
336
+ *agent automation-orchestrator
337
+ *start-auto-development
338
+ ```
339
+
340
+ ### 手动执行单个循环
341
+
342
+ ```bash
343
+ *execute-story-cycle
344
+ ```
345
+
346
+ ### 检查质量门控
347
+
348
+ ```bash
349
+ *validate-quality-gate development
350
+ ```
351
+
352
+ ### 生成进度报告
353
+
354
+ ```bash
355
+ *generate-progress-report
356
+ ```
357
+
358
+ ## Monitoring and Reporting
359
+
360
+ ### 实时监控
361
+
362
+ - 当前执行阶段
363
+ - 各智能体状态
364
+ - 质量指标变化
365
+ - 阻塞问题识别
366
+
367
+ ### 报告生成
368
+
369
+ - 每日进度报告
370
+ - 质量趋势分析
371
+ - 问题汇总报告
372
+ - 完成度评估
373
+
374
+ ## Best Practices
375
+
376
+ ### 流程优化
377
+
378
+ 1. **并行处理**: 在不冲突的情况下并行执行任务
379
+ 2. **预检查**: 在开始流程前验证所有前置条件
380
+ 3. **快速失败**: 尽早发现和报告问题
381
+ 4. **智能重试**: 基于问题类型选择重试策略
382
+
383
+ ### 质量保证
384
+
385
+ 1. **严格门控**: 每个阶段都必须通过质量检查
386
+ 2. **自动验证**: 减少人工检查的主观性
387
+ 3. **持续监控**: 实时跟踪质量指标变化
388
+ 4. **预防措施**: 基于历史数据预防常见问题
389
+
390
+ ### 协作优化
391
+
392
+ 1. **清晰交接**: 确保智能体间信息传递准确
393
+ 2. **状态同步**: 保持所有参与方对状态的一致理解
394
+ 3. **问题隔离**: 避免问题在智能体间传播
395
+ 4. **及时沟通**: 重要状态变化及时通知相关方
396
+ ==================== END: .xiaoma-core/agents/automation-orchestrator.md ====================
@@ -86,7 +86,7 @@ agent:
86
86
 
87
87
  **命令**: `*analyze-database`
88
88
  **功能**: 分析现有数据库结构
89
- **适用场景**: 棕地项目,需要了解现有数据库
89
+ **适用场景**: 现有项目项目,需要了解现有数据库
90
90
  **执行流程**:
91
91
 
92
92
  1. 通过MCP服务连接MySQL数据库
@@ -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: 为棕地项目创建史诗 (任务 brownfield-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: 将完整文档输出到当前目标文件
@@ -1168,7 +1168,7 @@ Document sharded successfully:
1168
1168
  ==================== START: .xiaoma-core/templates/brownfield-prd-tmpl.yaml ====================
1169
1169
  template:
1170
1170
  id: brownfield-prd-template-v2
1171
- name: 棕地增强功能PRD
1171
+ name: 现有项目增强功能PRD
1172
1172
  version: 2.0
1173
1173
  output:
1174
1174
  format: markdown
@@ -1307,7 +1307,7 @@ sections:
1307
1307
  - "NFR1: 增强功能必须保持现有的性能特征,且内存使用量增幅不得超过当前的20%。"
1308
1308
  - id: compatibility
1309
1309
  title: 兼容性要求
1310
- instruction: 对于棕地项目至关重要 - 必须保持兼容性的内容
1310
+ instruction: 对于现有项目项目至关重要 - 必须保持兼容性的内容
1311
1311
  type: numbered-list
1312
1312
  prefix: CR
1313
1313
  template: "{{requirement}}: {{description}}"
@@ -1396,20 +1396,20 @@ sections:
1396
1396
  - id: epic-structure
1397
1397
  title: Epic与Story结构
1398
1398
  instruction: |
1399
- 对于棕地项目,倾向于使用单个综合性Epic,除非用户明确要求多个不相关的增强功能。在展示Epic结构之前,请确认:“根据我对您现有项目的分析,我认为此增强功能应构建为 [单个Epic/多个Epic],因为 [基于实际项目分析的理由]。这与您对所需工作的理解是否一致?”
1399
+ 对于现有项目项目,倾向于使用单个综合性Epic,除非用户明确要求多个不相关的增强功能。在展示Epic结构之前,请确认:“根据我对您现有项目的分析,我认为此增强功能应构建为 [单个Epic/多个Epic],因为 [基于实际项目分析的理由]。这与您对所需工作的理解是否一致?”
1400
1400
  elicit: true
1401
1401
  sections:
1402
1402
  - id: epic-approach
1403
1403
  title: Epic方法
1404
- instruction: 解释Epic结构的理由 - 棕地项目通常使用单个Epic,除非涉及多个不相关的功能
1404
+ instruction: 解释Epic结构的理由 - 现有项目项目通常使用单个Epic,除非涉及多个不相关的功能
1405
1405
  template: "**Epic结构决策**: {{epic_decision}} 并陈述理由"
1406
1406
 
1407
1407
  - id: epic-details
1408
1408
  title: "Epic 1: {{enhancement_title}}"
1409
1409
  instruction: |
1410
- 交付棕地增强功能同时保持现有功能不变的综合性Epic
1410
+ 交付现有项目增强功能同时保持现有功能不变的综合性Epic
1411
1411
 
1412
- 棕地项目关键的STORY排序:
1412
+ 现有项目项目关键的STORY排序:
1413
1413
  - Story必须确保现有功能保持完好
1414
1414
  - 每个Story都应包含对现有功能是否仍然有效的验证
1415
1415
  - Story的顺序应旨在最大限度地降低对现有系统的风险
@@ -76,7 +76,7 @@ persona:
76
76
  commands:
77
77
  - help: 显示以下命令的编号列表以供选择
78
78
  - correct-course: 执行 correct-course 任务
79
- - create-epic: 为棕地项目创建史诗 (任务 brownfield-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)