需求助手

语言: English | 简体中文

版本: 1.0.0 最後更新: 2025-12-24 適用範圍: Claude Code Skills

目的

本 Skill 提供撰写清晰、完整且可执行需求的指導。

快速參考

使用者故事格式（INVEST）

作为 [角色]，
我想要 [功能]，
以便 [效益]。

INVEST 原則

原則	说明	应該問的問題
Independent（獨立性）	可以单獨交付	这是否依賴其他故事？
Negotiable（可協商性）	細节可以討論	这是否太過具体規定？
Valuable（有价值性）	提供使用者价值	这解决了什麼問題？
Estimable（可估算性）	可以估算工作量	我們了解範圍嗎？
Small（小型化）	適合在一个衝刺內完成	我們可以拆分这个嗎？
Testable（可测试性）	有明确的驗收标准	我們如何知道完成了？

需求優先级

優先级	标签	说明
P0	必須有	發布的关鍵需求
P1	应該有	重要但不阻塞
P2	可以有	可有可無
P3	不会有	超出範圍（本次發布）

详细指南

完整标准請參考：

快速範本

簡单 Issue 範本

## 問題
[我們要解决什麼問題？]

## 建议解决方案
[我們应該如何解决？]

## 驗收标准
- [ ] [标准 1]
- [ ] [标准 2]
- [ ] [标准 3]

功能需求範本

## 摘要
[一行描述]

## 动机
[为什麼需要这个？誰会受益？]

## 详细描述
[功能的完整描述]

## 驗收标准
- [ ] [可衡量的标准 1]
- [ ] [可衡量的标准 2]

## 超出範圍
- [这个功能不包含什麼]

错误回报範本

## 描述
[错误的簡要描述]

## 重現步骤
1. [步骤 1]
2. [步骤 2]
3. [步骤 3]

## 预期行为
[应該發生什麼]

## 实际行为
[实际發生什麼]

## 環境
- 作业系统：[例如：Windows 11]
- 版本：[例如：v1.2.3]

驗收标准指南

好的驗收标准

具体的：清晰、無歧義
可衡量的：可以验证通過/失败
可实現的：技術上可行
相关的：与需求相关
可测试的：可以为其编写测试

範例

好的範例：

- [ ] 使用者可以上传最大 10MB 的文件
- [ ] 系统在第 95 百分位數內 500ms 內响应
- [ ] 上传失败时顯示错误消息

不好的範例：

- [ ] 系统应該很快  # 無法衡量
- [ ] 使其使用者友善  # 太模糊
- [ ] 修復错误        # 没有具体标准

需求完整性检查清单

撰写需求时，确保涵蓋：

什麼：功能的清晰描述
为什麼：商业价值/解决的問題
誰：目標使用者/角色
何时：優先级/时间表
如何：高阶方法（如果已知）
驗收：完成标准
範圍：不包含什麼

设置檢测

此 Skill 支援项目特定的需求範本。

檢测順序

检查 CONTRIBUTING.md 中的「停用的 Skills」區段
- 如果此 Skill 在列表中，則此项目停用此 Skill
检查 CONTRIBUTING.md 中的「需求语言」區段
检查 .github/ISSUE_TEMPLATE/ 目录
检查 docs/templates/ 目录
如果未找到，预设使用英文并使用预设範本

首次设置

如果未找到範本：

詢問使用者：「此项目没有需求範本。我应該使用哪种语言？（English / 中文）」
使用者选择後，建议在 CONTRIBUTING.md 中记录：

## 需求语言

此项目使用 **[选择的选项]** 撰写需求和 issues。
<!-- 选项：English | 中文 -->

根据项目类型建议適當的範本

设置範例

在项目的 CONTRIBUTING.md 中：

## 需求语言

此项目使用 **English** 撰写需求和 issues。
<!-- 选项：English | 中文 -->

### Issue 範本位置
`.github/ISSUE_TEMPLATE/`

版本历史

版本	日期	变更
1.0.0	2025-12-24	新增：标准區段（目的、相关标准、版本历史、授权）

授权

本 Skill 以 CC BY 4.0 授权發布。

來源：universal-dev-standards

requirement-assistant