SuperAPI AI 工具集

requirement-assistant

写作与研究

查看项目

更新于 10-16 10:01

技能介绍

用途

Requirement Assistant 是一个 Claude Code 技能,旨在为编写清晰、完整且可执行的需求提供指导。它适用于编写需求、用户故事、issue 以及功能规划等场景。

主要能力

用户故事格式(INVEST)

技能提供标准的用户故事格式:

As a [role], I want [feature], So that [benefit].

并附带 INVEST 标准,用于评估用户故事质量:

  • Independent(独立):能否单独交付?是否依赖其他故事?
  • Negotiable(可协商):细节是否可讨论?是否过于规定性?
  • Valuable(有价值):是否提供用户价值?解决什么问题?
  • Estimable(可估算):能否估算工作量?是否理解范围?
  • Small(小):能否在一个冲刺内完成?能否拆分?
  • Testable(可测试):是否有明确的验收标准?如何知道已完成?

需求优先级分级

技能定义了四级优先级:

  • P0 Must Have:发布关键项
  • P1 Should Have:重要但不阻塞
  • P2 Could Have:锦上添花
  • P3 Won't Have:本次发布范围之外

快速模板

技能提供三类模板:

  1. 简单问题模板:包含问题、建议方案、验收标准。
  2. 功能请求模板:包含摘要、动机、详细描述、验收标准、范围之外。
  3. 缺陷报告模板:包含描述、复现步骤、预期行为、实际行为、环境信息。

验收标准指南

技能给出良好验收标准的特征:具体、可衡量、可实现、相关、可测试。并附有正反示例,例如“用户可上传最大 10MB 的文件”为良好示例,而“系统应该很快”为不佳示例。

需求完整性检查清单

编写需求时需覆盖:What(功能描述)、Why(业务价值/解决的问题)、Who(目标用户/角色)、When(优先级/时间线)、How(高层方法,如已知)、Acceptance(完成标准)、Scope(不包含的内容)。

配置检测

技能支持项目级需求模板,检测顺序为:

  1. 检查 CONTRIBUTING.md 中的“Disabled Skills”部分,若列出此技能则在本项目中禁用。
  2. 检查 CONTRIBUTING.md 中的“Requirement Language”部分。
  3. 检查 .github/ISSUE_TEMPLATE/ 目录。
  4. 检查 docs/templates/ 目录。
  5. 若未找到,默认使用英文和默认模板。

首次设置时,若未找到模板,技能会询问用户使用哪种语言(English / 中文),并建议在 CONTRIBUTING.md 中记录选择。

使用方式

该技能适用于 Claude Code 环境。在编写需求、用户故事、issue 或进行功能规划时调用。技能会根据项目配置自动检测语言和模板,若未配置则提示用户选择。

适用场景

  • 编写产品需求文档
  • 创建用户故事
  • 撰写 issue(问题、功能请求、缺陷报告)
  • 功能规划与优先级排序
  • 制定验收标准

限制

  • 该技能为 Claude Code 专用,适用性标注为 Claude Code Skills。
  • 版本为 1.0.0,最后更新于 2025-12-24。
  • 采用 CC BY 4.0 许可发布。
  • 来源标注为 universal-dev-standards。
  • 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。