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