Agent skill

principle-invest

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

View SKILL.md on GitHub Repository
Stars 5
Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/tikazyq/agentic-spec-forge/tree/main/AGENTIC_SPEC_FORGE/spec_stage_skill/common_normal/principle-invest

SKILL.md

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

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

tikazyq/agentic-spec-forge

code-review

执行代码审查流程（提交PR→自查→同行审查→反馈修改→合并），覆盖功能正确性、代码质量、测试完整性、安全合规四大维度。当提交Pull Request、进行结对编程、执行代码走查、需要知识共享时使用。支持L1/L2/L3三级审查深度。

5 1
Explore
tikazyq/agentic-spec-forge

code-quality

执行代码质量门禁检查（测试通过→覆盖率→Lint→GOAL追溯→可提交），验证单元测试覆盖率≥80%、集成测试通过率≥95%、代码规范零错误。当完成代码实现、准备提交代码、需要质量验证、进行提交前自检时使用。确保代码可合并。

5 1
Explore
tikazyq/agentic-spec-forge

tdd-cycle

执行 TDD 红绿重构循环（RED→GREEN→REFACTOR→REPEAT），通过先写失败测试、最小代码实现、保持绿色重构的节奏驱动开发。当启动功能开发、需要测试驱动节奏、进行迭代编码、追求高测试覆盖率时使用。提供检查清单和节奏控制。

5 1
Explore
tikazyq/agentic-spec-forge

refactoring

执行代码重构（识别坏味道→选择手法→小步修改→运行测试），在保持外部行为不变前提下改进内部结构。当TDD进入REFACTOR阶段、发现代码坏味道、需要消除重复代码、优化代码结构时使用。支持提取方法、类、参数对象等重构手法。

5 1
Explore
tikazyq/agentic-spec-forge

arch-options-compare

比较多个架构方案（单体/微服务等），从SOLID原则、成本、复杂度等维度评分，生成对比表和推荐方案。当需要向客户解释架构选择或ADR决策时使用。

5 1
Explore
tikazyq/agentic-spec-forge

dev-tech-view-supplement

根据设计补充Dev视角的技术细节（数据库/API/通信协议），帮助Dev快速进入实施。当L1/L2设计缺乏技术细节、或准备向Dev交付前使用。

5 1
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results