用户故事质量检查工具
如何使用此技能
当收到用户故事质量检查请求时,遵循以下步骤:
1. 分析用户故事
- 解析故事结构,提取角色、目标、价值、验收标准
- 识别华为特定环境要求(如高交场景、认证鉴权等)
2. 系统化质量检查
按照以下框架进行检查:
结构完整性检查
- 角色定义是否明确具体?
- 目标描述是否清晰?
- 价值阐述是否充分?
- 验收标准是否完整可测试?
INVEST原则检查(详细信息参见references/invest-principles.md)
- 独立性:是否可独立实施?
- 可协商性:实现方式是否灵活?
- 有价值:是否有明确业务价值?
- 可估算:工作量是否便于估算?
- 规模小:是否可在迭代内完成?
- 可测试:验收标准是否明确?
DFX非功能性需求检查(详细信息参见references/dfx-requirements.md)
- 性能要求是否明确?
- 安全要求是否充分?
- 可靠性保障措施?
- 可维护性设计?
- 可用性考虑?
- 可扩展性规划?
华为环境特定检查
- 是否符合华为安全规范?
- 是否支持华为云服务?
- 是否有企业集成要求?
- 是否考虑了高并发场景?
3. 生成检查报告
使用以下格式输出结果:
问题 [序号]:[类别] [问题描述]
建议: [具体可行的改进建议]
预期收益: [改进后预计达成的效果]
工作流程详细说明
第一阶段:故事解析
- 识别故事标题
- 提取标准格式组件:
- 【As】角色定义
- 【I want】目标描述
- 【so that】价值阐述
- 验收标准(Given-When-Then)
- 识别华为特定环境要求
第二阶段:质量评估
- 结构评分(0-25分)
- INVEST原则评分(0-30分)
- DFX要求评分(0-25分)
- 业务逻辑评分(0-20分)
第三阶段:问题识别与建议
- 列出所有发现的质量问题
- 针对每个问题提供可执行建议
- 标明问题严重程度(高/中/低优先级)
- 提供优化后的故事版本参考
内置工具和模板
本技能包含以下资源:
脚本
- scripts/checklist_generator.py:自动化检查清单生成
参考资料
- references/invest-principles.md:INVEST原则详细说明
- references/dfx-requirements.md:DFX非功能性需求框架
模板
- templates/quality_report_template.md:质量报告模板
华为环境特定指南
必须检查的项目
- ✅ 认证鉴权机制
- ✅ 高并发处理能力(如500并发/s)
- ✅ 与企业知识系统集成
- ✅ 数据安全与合规要求
- ✅ 华为云服务兼容性
典型问题示例
- ❌ 缺乏具体性能指标(如"支撑高并发"但未定义具体并发数)
- ❌ 安全要求不明确(如管理功能缺乏权限控制)
- ❌ 验收标准模糊(如"提高准确率"但未定义具体指标)
改进建议模式
- 🔧 明确量化的性能指标
- 🔧 补充安全控制和审计要求
- 🔧 定义具体的可测试验收标准
- 🔧 考虑华为环境的特定约束
输出质量保证
所有检查结果必须:
- 条目化展示,问题与建议一一对应
- 建议具体可行,具有可操作性
- 标明预期收益,帮助需求方理解改进价值
- 考虑华为特定环境约束和最佳实践