Agent skill
scope-confirmation
功能範圍確認工具. Use for: (1) 測試/實作/需求不一致時的範圍確認, (2) 功能邊界不清時的澄清, (3) 防止範圍蔓延
Install this agent skill to your Project
npx add-skill https://github.com/tarrragon/claude/tree/main/skills/scope-confirmation
SKILL.md
功能範圍確認 (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 前置審查確保設計一致
檢查清單
每個功能完成時,確認:
- 需求文件已更新到最新
- 所有測試通過
- 測試覆蓋所有需求項目
- 沒有超出需求的實作
- 邊界條件都有處理
Last Updated: 2026-03-02 Version: 1.1.0
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
skill-design-guide
Use this skill when creating a new skill, updating an existing skill's YAML frontmatter, or reviewing skill quality. Provides the official Anthropic skill specification, frontmatter rules, description writing best practices, progressive disclosure architecture, and common pitfalls to avoid. Triggers include: creating skills, skill review, frontmatter validation, SKILL.md writing.
test-async-guardian
Flutter/Dart 測試異步資源管理守護者。用於:(1) 診斷測試卡住問題,(2) 審查測試程式碼中的異步資源清理,(3) 提供 tearDown 最佳實踐,(4) 掃描潛在的資源洩漏風險。觸發場景:測試卡住、撰寫新測試、Code Review 測試程式碼、執行 flutter test 前自動掃描。
agent-team
Agent Teams 協作派發指南。Use when: (1) Agent A 的發現會改變 Agent B 正在進行的工作, (2) 用戶要求使用 team/swarm, (3) 多代理人需即時協商共用介面或 API 契約。涵蓋 team 建立、Ticket-Task 橋接、teammate 入職、生命週期管理。
tdd
TDD 全流程指導工具。Use for: (1) 開始新功能的 TDD 流程(Phase 0-4), (2) 推進到下一個 TDD 階段, (3) Phase 1 SOLID 原則驅動功能拆分分析, (4) 查看當前 TDD 進度和階段狀態, (5) 評估是否需要 Phase 4 重構以及 3b 拆分評估。Use when: 開始新功能開發、進入任何 TDD Phase、需要 SOLID 拆分指導、需要確認當前所在 TDD 階段、需要做 Phase 4 豁免判斷時。
branch-worktree-guardian
Branch Worktree Guardian - Git 分支和 Worktree 管理工具。Use for: (1) 新開發需求時建立隔離分支, (2) 使用 worktree 機制避免分支衝突, (3) 驗證當前工作分支正確性, (4) 預防在錯誤分支上開發
design-decision-framework
多方案評估決策框架。用於面臨 3+ 技術方案時的結構化評估、架構決策時的系統化分析,防止衝動決策和技術債務累積。Use for: 技術方案選擇、重大架構決策、高風險技術選型
Didn't find tool you were looking for?