# Principle Invest

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

- Skill: `majiayu000/principle-invest` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/principle-invest`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/principle-invest/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/principle-invest

---


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