# 创建棕地故事任务 ## 目的 为非常小的棕地增强创建一个单一的用户故事，这些增强可以在一次专注的开发会话中完成。此任务适用于需要了解现有系统集成的最小添加或错误修复。 ## 何时使用此任务 **在以下情况下使用此任务：** - 增强功能可以在一个故事中完成 - 不需要新的架构或重要的设计 - 更改完全遵循现有模式 - 集成直接且风险最小 - 更改是孤立的，边界清晰 **在以下情况下使用 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小时