Agent skill

requirement-assistant

引導需求撰寫、使用者故事建立與功能規格制定。 使用時機：撰寫需求、使用者故事、問題單、功能規劃。 關鍵字：requirement, user story, issue, feature, specification, 需求, 功能規劃, 規格。

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/requirement-assistant

SKILL.md

需求助手

語言: English | 繁體中文

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

目的

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

快速參考

使用者故事格式（INVEST）

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

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.0 2025-12-24 新增：標準區段（目的、相關標準、版本歷史、授權）

授權

本 Skill 以 CC BY 4.0 授權發布。

來源：universal-dev-standards

Didn't find tool you were looking for?

Be as detailed as possible for better results