| name | principle-invest |
| description | 评估用户故事质量的六维度框架(独立性、可协商、有价值、可估算、小粒度、可测试),系统化审查需求质量。当需要编写用户故事、评审需求文档、拆分史诗故事时使用。提供分级检查清单和低质量故事的改进建议。 |
| stage | COMMON |
| level_supported | L1-STREAMLINED, L2-BALANCED, L3-RIGOROUS |
INVEST Principles Skill
Scope: COMMON(全阶段通用)
版本: 0.1.0(占位)| 创建日期: 2025-11-27
概述
INVEST 是评估用户故事质量的六维度框架:
┌─────────────────────────────────────────────────────┐
│ 📋 INVEST Criteria │
├──────────┬──────────────────────────────────────────┤
│ I │ Independent - 独立性 │
│ N │ Negotiable - 可协商 │
│ V │ Valuable - 有价值 │
│ E │ Estimable - 可估算 │
│ S │ Small - 小粒度 │
│ T │ Testable - 可测试 │
└──────────┴──────────────────────────────────────────┘
六维度检查
I - 独立性 (Independent)
- 用户故事之间无强依赖
- 可以独立开发和交付
- 不需要特定顺序实现
N - 可协商 (Negotiable)
- 不是固定合同,而是协作起点
- 细节可以与团队讨论调整
- 保持灵活性
V - 有价值 (Valuable)
- 对用户或业务有明确价值
- 价值可以被理解和解释
- 优先级可以被评估
E - 可估算 (Estimable)
- 团队能够估算工作量
- 范围足够清晰
- 技术可行性已知
S - 小粒度 (Small)
- 可以在一个迭代内完成
- 不需要拆分成更小的故事
- 复杂度可控
T - 可测试 (Testable)
- 验收条件清晰
- 可以编写测试用例
- 完成标准明确
分级检查策略
L1-STREAMLINED
- 每维度检查 1 个核心点(共 6 项)
- 关注明显不符合
- 通过标准:6 项中 5 项通过(≥83%)
L2-BALANCED
- 每维度检查 2-3 个关键点(共 12-18 项)
- 结合用户故事示例分析
- 通过标准:12 项中 10 项通过(≥83%)
L3-RIGOROUS
- 全面检查所有子项(18+ 项)
- 生成 INVEST 评分卡(每维度 1-5 分)
- 记录改进建议和优先级
- 通过标准:总评分 ≥ 24/30(≥80%)
>> 命令
>>invest_check_l1 # INVEST 快速检查(6项各1个关键点)
>>invest_check_l2 # INVEST 标准检查(含示例分析)
>>invest_score # 生成 INVEST 评分卡
相关 Skills
- 前置: user-story-format(US 格式正确后再验证质量)
- 并行: acceptance-criteria(AC 与 US 一起检查)
- 后续: draft-finalize(INVEST 通过后定稿)
- 同类: principle-solid, principle-dry(质量原则家族)
TODO: 待细化各维度的具体检查规则和评分标准