⚡

用户故事作者Skill userstory-author

用户故事作者技能用于创建Agile风格的用户故事和验收标准，帮助产品团队定义需求、验证功能，并遵循INVEST原则确保故事质量。关键词：用户故事、验收标准、敏捷开发、需求分析、INVEST。

需求分析 0 次安装 0 次浏览 更新于 3/11/2026

name: userstory-author description: “编写带有链接验收标准的Agile风格用户故事。” argument-hint: “<功能描述或–interactive>” allowed-tools: 读取, 全局, 查找, 写入, 编辑, 技能, 任务

用户故事撰写

创建带有验收标准的Agile风格用户故事。

用户故事格式

## US-XXX: [简短标题]

**作为一个** [用户类型/角色],
**我希望** [目标/愿望],
**以便** [好处/价值].

### 验收标准

- [ ] AC-1: 给定 [上下文], 当 [动作], 然后 [结果]
- [ ] AC-2: 给定 [上下文], 当 [动作], 然后 [结果]

### 注释

- [附加上下文]
- [依赖项]

工作流程

  1. 收集上下文

    • 如果提供了参数，分析描述
    • 如果使用 --interactive，指导故事创建过程

  2. 识别用户

    • 生成 spec-author userstory 代理
    • 定义角色：
      • 用户是谁？
      • 他们的目标是什么？
      • 他们有什么痛点？

  3. 定义需求

    • 关注目标，而非解决方案
    • 例如，“我希望找到产品”而不是“我希望有一个搜索框”

  4. 阐述价值

    • 连接到商业价值
    • 节省时间、增加收入、降低风险

  5. 编写验收标准

    • 使用给定/当/然后格式
    • 覆盖正常路径和边界情况

  6. 使用INVEST验证

    • 独立性、可协商性、有价值性
    • 可估计性、小型化、可测试性
    • 分数必须 ≥ 7

  7. 输出

    • 显示格式化故事
    • 如果太大，建议拆分

INVEST标准

标准 问题 分数
独立性 可以单独交付吗？ 0-2
可协商性 描述什么，而非如何？ 0-2
有价值性 提供用户/商业价值吗？ 0-2
可估计性 团队能估计工作量吗？ 0-2
小型化 适合一个迭代周期吗？ 0-2
可测试性 有明确的通过/失败标准吗？ 0-2

阈值： 分数7+以上继续，否则拆分或优化。

参数

  • $ARGUMENTS - 功能描述
  • --interactive - 分步指导撰写
  • --persona - 指定用户角色
  • --append - 附加到规格文件

示例

# 从描述
/spec-driven-development:userstory-author "按关键词搜索产品"

# 交互模式
/spec-driven-development:userstory-author --interactive

# 指定角色
/spec-driven-development:userstory-author "查看订单历史" --persona "回头客"

# 附加到规格
/spec-driven-development:userstory-author "重置密码" --append .specs/auth/spec.md

故事拆分模式

如果INVEST分数低，代理建议拆分：

按用户类型拆分

拆分前： “作为一个用户，我希望看到一个仪表板”

拆分后：

  • “作为一个管理员，我希望看到系统指标仪表板”
  • “作为一个销售代表，我希望看到我的管道仪表板”

按工作流程步骤拆分

拆分前： “作为一个用户，我希望完成结账”

拆分后：

  • “作为一个用户，我希望查看我的购物车”
  • “作为一个用户，我希望输入配送信息”
  • “作为一个用户，我希望确认我的订单”

按操作（CRUD）拆分

拆分前： “作为一个用户，我希望管理我的个人资料”

拆分后：

  • “作为一个用户，我希望查看我的个人资料”
  • “作为一个用户，我希望更新我的个人资料”
  • “作为一个用户，我希望删除我的账户”

输出示例

## US-001: 按关键词搜索产品

**作为一个** 购物者,
**我希望** 使用关键词搜索产品,
**以便** 我能快速找到我感兴趣购买的商品。

### 验收标准

- [ ] AC-1: 给定我在产品列表页面，当我在搜索框中输入“笔记本”并按下回车，然后我看到包含“笔记本”在标题或描述中的产品

- [ ] AC-2: 给定我搜索了“笔记本”，当结果显示时，然后我看到结果计数和结果按相关性排序

- [ ] AC-3: 给定我搜索一个没有匹配项的术语，当结果显示时，然后我看到“未找到产品”消息并带有建议

### INVEST分数: 10/12

| I | N | V | E | S | T |
| - | - | - | - | - | - |
| 2 | 2 | 2 | 2 | 1 | 1 |

**注释：**
- S/T略微降低由于搜索相关性复杂性
- 考虑对搜索排名算法进行探索

### 依赖项

- 产品目录必须被索引
- 搜索基础设施必需

### 优先级

必须（核心购物功能）

相关命令

  • /spec-driven-development:gherkin-author - 创建Gherkin场景
  • /spec-driven-development:ears-author - 创建EARS需求
  • /spec-driven-development:specify - 生成完整规格