tarrragon 功能範圍確認 (Scope Confirmation) SKILL
版本: v1.1 建立日期: 2026-01-23 狀態: 穩定
概述
功能範圍確認工具用於在測試、實作、需求之間出現不一致時，系統性地確認和對齊功能範圍，防止範圍蔓延和混淆。
觸發條件
以下情況應使用此 Skill：
| 情境 | 識別特徵 | 強制性 |
|---|---|---|
| 三方不一致 | 測試、實作、需求三者不一致 | 強制 |
| 邊界不清 | 功能邊界定義不明確 | 強制 |
| 範圍蔓延 | 實作超出原始需求 | 建議 |
| 需求變更 | 需求發生變化但文件未同步 | 建議 |
確認流程
Stage 1: 現狀收集
目標: 收集測試、實作、需求三方的現狀
輸出格式:
## 現狀收集
### 需求文件 (docs/app-requirements-spec.md)
- **功能名稱**: [名稱]
- **功能描述**: [描述]
- **驗收標準**: [標準列表]
- **文件版本**: [版本]
- **最後更新**: [日期]
### 測試案例
- **測試檔案**: [檔案路徑]
- **測試數量**: [數量]
- **測試覆蓋**: [覆蓋的功能點]
- **Given-When-Then**: [測試意圖]
### 實作狀態
- **實作檔案**: [檔案路徑]
- **實作功能**: [已實作的功能]
- **實作版本**: [版本]
Stage 2: 差異分析
目標: 識別三方之間的差異
分析維度:
| 比較對象 | 可能的差異 |
|---|---|
| 需求 vs 測試 | 測試未覆蓋需求、測試超出需求 |
| 需求 vs 實作 | 實作未完成需求、實作超出需求 |
| 測試 vs 實作 | 測試失敗、測試過時 |
輸出格式:
## 差異分析
### 需求 vs 測試
| 需求項目 | 測試覆蓋 | 差異說明 |
|---------|---------|---------|
| [需求1] | 是/否 | [說明] |
| [需求2] | 是/否 | [說明] |
**超出需求的測試**:
- [測試1]: [說明]
- [測試2]: [說明]
### 需求 vs 實作
| 需求項目 | 實作狀態 | 差異說明 |
|---------|---------|---------|
| [需求1] | 完成/部分/未開始 | [說明] |
| [需求2] | 完成/部分/未開始 | [說明] |
**超出需求的實作**:
- [實作1]: [說明]
- [實作2]: [說明]
### 測試 vs 實作
| 測試 | 實作支持 | 結果 | 差異說明 |
|------|---------|------|---------|
| [測試1] | 是/否 | 通過/失敗 | [說明] |
| [測試2] | 是/否 | 通過/失敗 | [說明] |
Stage 3: 差異根因分析
目標: 找出差異產生的根本原因
根因類型:
| 根因類型 | 說明 | 處理方向 |
|---|---|---|
| 需求變更未同步 | 需求改了但文件未更新 | 更新需求文件 |
| 設計遺漏 | 設計時未考慮到 | 補充設計 |
| 實作偏離 | 實作偏離原始設計 | 修正實作或更新設計 |
| 測試過時 | 測試基於舊需求 | 更新測試 |
| 範圍蔓延 | 無意中擴大範圍 | 確認範圍並調整 |
輸出格式:
## 根因分析
### 差異 1: [差異描述]
- **根因類型**: [類型]
- **詳細說明**: [說明]
- **影響範圍**: [範圍]
- **建議處理**: [處理方向]
### 差異 2: [差異描述]
- **根因類型**: [類型]
- **詳細說明**: [說明]
- **影響範圍**: [範圍]
- **建議處理**: [處理方向]
Stage 4: 範圍確認
目標: 確認最終的功能範圍
確認問題:
- 這個功能應該做什麼？（In Scope）
- 這個功能不應該做什麼？（Out of Scope）
- 邊界條件是什麼？
- 例外情況如何處理？
輸出格式:
## 功能範圍確認
### In Scope（應該做的）
| # | 功能項目 | 驗收標準 | 優先級 |
|---|---------|---------|--------|
| 1 | [項目1] | [標準] | P0/P1/P2 |
| 2 | [項目2] | [標準] | P0/P1/P2 |
### Out of Scope（不應該做的）
| # | 排除項目 | 排除原因 | 未來規劃 |
|---|---------|---------|---------|
| 1 | [項目1] | [原因] | [規劃] |
| 2 | [項目2] | [原因] | [規劃] |
### 邊界條件
| 條件 | 處理方式 |
|------|---------|
| [條件1] | [處理] |
| [條件2] | [處理] |
### 例外情況
| 例外 | 處理方式 |
|------|---------|
| [例外1] | [處理] |
| [例外2] | [處理] |
Stage 5: 對齊行動
目標: 制定對齊三方的具體行動
輸出格式:
## 對齊行動計畫
### 需求文件更新
- [ ] [更新項目1]
- [ ] [更新項目2]
### 測試更新
- [ ] [更新/新增/刪除測試1]
- [ ] [更新/新增/刪除測試2]
### 實作調整
- [ ] [調整項目1]
- [ ] [調整項目2]
### 執行順序
1. [步驟1]
2. [步驟2]
3. [步驟3]
### 驗證方法
- [ ] 所有測試通過
- [ ] 需求文件與實作一致
- [ ] 測試覆蓋所有需求
完整確認報告模板
# 功能範圍確認報告
## 報告資訊
- **功能名稱**: [名稱]
- **確認日期**: [日期]
- **觸發原因**: [原因]
## 現狀收集
[Stage 1 輸出]
## 差異分析
[Stage 2 輸出]
## 根因分析
[Stage 3 輸出]
## 功能範圍確認
[Stage 4 輸出]
## 對齊行動
[Stage 5 輸出]
## 5W1H 記錄
- **Who**: [確認者] | rosemary-project-manager (審核)
- **What**: 功能範圍確認 - [功能名稱]
- **When**: [確認時間]
- **Where**: [影響範圍]
- **Why**: [觸發原因]
- **How**: [Task Type: Analysis] 系統性差異分析和範圍對齊
常見情況處理
情況 1: 測試失敗但實作正確
診斷: 測試基於舊需求 處理:
- 確認當前需求
- 更新測試以符合當前需求
- 記錄需求變更歷史
情況 2: 實作超出需求
診斷: 範圍蔓延 處理:
- 確認超出部分是否有價值
- 如有價值，補充需求文件
- 如無價值，移除多餘實作
情況 3: 需求未被測試覆蓋
診斷: 測試遺漏 處理:
- 分析遺漏原因
- 補充缺失的測試
- 驗證測試覆蓋率
情況 4: 三方都不一致
診斷: 多重問題 處理:
- 先確認「正確的」需求
- 以需求為基準對齊測試和實作
- 分步驟處理，避免混亂
與其他 Skill 的關係
| Skill | 關係 |
|---|---|
/pre-fix-eval |
如果差異導致測試失敗，使用 pre-fix-eval 分析 |
/ticket create |
對齊行動應建立對應 Ticket |
/5w1h-decision |
範圍確認決策應符合 5W1H 格式 |
預防措施
如何預防三方不一致
- 需求變更時同步更新測試和實作
- 使用 TDD 流程確保測試先行
- 定期執行範圍確認檢查
- 使用 SA 前置審查確保設計一致
檢查清單
每個功能完成時，確認：
- 需求文件已更新到最新
- 所有測試通過
- 測試覆蓋所有需求項目
- 沒有超出需求的實作
- 邊界條件都有處理
版本紀錄在同目錄的 CHANGELOG.md。