AgentSkillsCN

requirement

指导需求撰写、用户故事构建与功能规格制定。 使用时机：撰写需求、用户故事、问题单、功能规划。 关键词：requirement、user story、issue、feature、specification、需求、功能规划、规格。

SKILL.md
--- frontmatter
source: skills/requirement-assistant/SKILL.md
source_version: 1.0.0
translation_version: 1.0.0
last_synced: 2025-12-25
status: current
name: requirement
description: |
  引導需求撰写、使用者故事建立与功能規格制定。
  使用时机：撰写需求、使用者故事、問題单、功能規划。
  关鍵字：requirement, user story, issue, feature, specification, 需求, 功能規划, 規格。

需求助手

语言: English | 简体中文

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

目的

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

快速參考

使用者故事格式（INVEST）

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

INVEST 原則

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

需求優先级

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

详细指南

完整标准請參考：

快速範本

簡单 Issue 範本

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

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

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

功能需求範本

markdown
## 摘要
[一行描述]

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

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

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

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

错误回报範本

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

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

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

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

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

驗收标准指南

好的驗收标准

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

範例

好的範例：

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

不好的範例：

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

需求完整性检查清单

撰写需求时，确保涵蓋：

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

设置檢测

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

檢测順序

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

首次设置

如果未找到範本：

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

此项目使用 **[选择的选项]** 撰写需求和 issues。
<!-- 选项：English | 中文 -->
  1. •根据项目类型建议適當的範本

设置範例

在项目的 CONTRIBUTING.md 中：

markdown
## 需求语言

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

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

相关标准

版本历史

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

授权

本 Skill 以 CC BY 4.0 授权發布。

來源：universal-dev-standards