majiayu000 需求助手
語言: 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 授權發布。