156 lines
3.8 KiB
Markdown
156 lines
3.8 KiB
Markdown
<!-- 由 BMAD™ Core 驱动 -->
|
||
|
||
# 创建棕地故事任务
|
||
|
||
## 目的
|
||
|
||
为非常小的棕地增强创建一个单一的用户故事，这些增强可以在一次专注的开发会话中完成。此任务适用于需要了解现有系统集成的最小添加或错误修复。
|
||
|
||
## 何时使用此任务
|
||
|
||
**在以下情况下使用此任务：**
|
||
|
||
- 增强功能可以在一个故事中完成
|
||
- 不需要新的架构或重要的设计
|
||
- 更改完全遵循现有模式
|
||
- 集成直接且风险最小
|
||
- 更改是孤立的，边界清晰
|
||
|
||
**在以下情况下使用 brownfield-create-epic：**
|
||
|
||
- 增强功能需要2-3个协调的故事
|
||
- 需要一些设计工作
|
||
- 涉及多个集成点
|
||
|
||
**在以下情况下使用完整的棕地PRD/架构流程：**
|
||
|
||
- 增强功能需要多个协调的故事
|
||
- 需要进行架构规划
|
||
- 需要大量的集成工作
|
||
|
||
## 说明
|
||
|
||
### 1. 快速项目评估
|
||
|
||
收集关于现有项目的最少但必要的信息：
|
||
|
||
**当前系统背景：**
|
||
|
||
- [ ] 确定了相关的现有功能
|
||
- [ ] 注意到该领域的技术栈
|
||
- [ ] 清楚地理解了集成点
|
||
- [ ] 确定了类似工作的现有模式
|
||
|
||
**变更范围：**
|
||
|
||
- [ ] 明确定义了具体变更
|
||
- [ ] 确定了影响边界
|
||
- [ ] 建立了成功标准
|
||
|
||
### 2. 故事创建
|
||
|
||
按照此结构创建一个专注的单一故事：
|
||
|
||
#### 故事标题
|
||
|
||
{{具体增强}} - 棕地添加
|
||
|
||
#### 用户故事
|
||
|
||
作为一个{{用户类型}}，
|
||
我想要{{具体行动/能力}}，
|
||
以便于{{明确的益处/价值}}。
|
||
|
||
#### 故事背景
|
||
|
||
**现有系统集成：**
|
||
|
||
- 集成于：{{现有组件/系统}}
|
||
- 技术：{{相关技术栈}}
|
||
- 遵循模式：{{要遵循的现有模式}}
|
||
- 接触点：{{具体的集成点}}
|
||
|
||
#### 验收标准
|
||
|
||
**功能性需求：**
|
||
|
||
1. {{主要功能性需求}}
|
||
2. {{次要功能性需求（如有）}}
|
||
3. {{集成需求}}
|
||
|
||
**集成需求：**
|
||
4. 现有{{相关功能}}继续保持不变
|
||
5. 新功能遵循现有{{模式}}模式
|
||
6. 与{{系统/组件}}的集成保持当前行为
|
||
|
||
**质量需求：**
|
||
7. 更改由适当的测试覆盖
|
||
8. 如果需要，更新文档
|
||
9. 验证现有功能无回归
|
||
|
||
#### 技术说明
|
||
|
||
- **集成方法：** {{它如何连接到现有系统}}
|
||
- **现有模式参考：** {{要遵循的模式的链接或描述}}
|
||
- **关键约束：** {{任何重要的限制或要求}}
|
||
|
||
#### 完成的定义
|
||
|
||
- [ ] 满足功能性需求
|
||
- [ ] 验证了集成需求
|
||
- [ ] 对现有功能进行了回归测试
|
||
- [ ] 代码遵循现有模式和标准
|
||
- [ ] 测试通过（现有和新的）
|
||
- [ ] 如果适用，更新了文档
|
||
|
||
### 3. 风险和兼容性检查
|
||
|
||
**最小风险评估：**
|
||
|
||
- **主要风险：** {{对现有系统的主要风险}}
|
||
- **缓解措施：** {{简单的缓解方法}}
|
||
- **回滚：** {{如果需要，如何撤销}}
|
||
|
||
**兼容性验证：**
|
||
|
||
- [ ] 对现有API无重大变更
|
||
- [ ] 数据库变更（如有）仅为增量式
|
||
- [ ] UI变更遵循现有设计模式
|
||
- [ ] 性能影响可忽略不计
|
||
|
||
### 4. 验证清单
|
||
|
||
在最终确定故事之前，请确认：
|
||
|
||
**范围验证：**
|
||
|
||
- [ ] 故事可以在一次开发会话中完成
|
||
- [ ] 集成方法直接
|
||
- [ ] 完全遵循现有模式
|
||
- [ ] 不需要设计或架构工作
|
||
|
||
**清晰度检查：**
|
||
|
||
- [ ] 故事需求明确
|
||
- [ ] 集成点明确指定
|
||
- [ ] 成功标准可测试
|
||
- [ ] 回滚方法简单
|
||
|
||
## 成功标准
|
||
|
||
当满足以下条件时，故事创建成功：
|
||
|
||
1. 增强功能定义清晰，范围适合单次会话
|
||
2. 集成方法直接且风险低
|
||
3. 确定并将遵循现有系统模式
|
||
4. 回滚计划简单可行
|
||
5. 验收标准包括对现有功能的验证
|
||
|
||
## 重要说明
|
||
|
||
- 此任务仅适用于非常小的棕地变更
|
||
- 如果分析过程中复杂性增加，请升级到 brownfield-create-epic
|
||
- 始终将现有系统的完整性置于首位
|
||
- 当对集成复杂性有疑问时，请改用 brownfield-create-epic
|
||
- 故事的专注开发工作时间不应超过4小时
|