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