Claude Code Plugins

Community-maintained marketplace

Feedback

评估用户故事质量的六维度框架(独立性、可协商、有价值、可估算、小粒度、可测试),系统化审查需求质量。当需要编写用户故事、评审需求文档、拆分史诗故事时使用。提供分级检查清单和低质量故事的改进建议。

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

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: 待细化各维度的具体检查规则和评分标准