Scope Guard Skill | Agent Skills

Scope Guard

スコープ過大なタスクを診断し、実行戦略を提案するオーケストレーター。既存スキル（/decompose, /task-enrich, /task-handoff）を統制し、タスク完遂までのフローを設計する。

使い分け

| タスク規模 | 推奨 | |-----------|------| | 小（1-2ステップ、明確） | 不要 -- 直接実装 | | 中（3-5ステップ、複数戦略あり） | /approach-check | | 大（6+ステップ、設計判断を伴う） | Plan Mode + /decompose | | 過大（コンテキスト枯渇リスク） | このスキル |

scope-guard の責務

担うこと: スコープ診断、実行戦略の判断、実行プロンプト生成
担わないこと: タスクの実行そのもの（メインエージェントに委譲）

ワークフロー

1. スコープ診断

ユーザーの指示内容を分析する。必要であれば AskUserQuestion で 1-2問の追加質問をする（ファイル探索はしない）。

以下を特定する:

影響範囲: 関係するコンポーネント/モジュール
推定規模: Small / Medium / Large / Very Large
課題: スコープを過大にしている要因（探索と実装の混在、曖昧な終了条件など）

2. 仮戦略の提示

3つの戦略から推奨を提示し、ユーザーの承認を得る:

## スコープ診断結果

**影響範囲**: [コンポーネント/モジュール名]
**推定規模**: [Small / Medium / Large / Very Large]
**課題**:
  - [課題1]
  - [課題2]

## 推奨戦略: [A / B / C]

**理由**: [この戦略が適切な理由]

### 選択肢

A. **サブエージェント実行**（このセッション内で完結）
   → /decompose で軽量タスク粒度に分解 → 順次実行
   [具体的な分解の方向性を記述]

B. **マルチセッション分割**（複数セッションに跨る）
   → /decompose でセッション単位に分解 → /task-enrich → /task-handoff
   [セッション分割の方向性を記述]

C. **スコープカット**（ユーザーと優先度交渉で縮小）
   [削減候補の提案を記述]

AskUserQuestion で戦略の選択を求める。

3. 実行プロンプト生成

ユーザーが戦略を選択したら、メインエージェントへの実行指示を生成する。

A. サブエージェント実行の場合

## 実行プラン

### ステップ 1: タスク分解
/decompose を以下の方針で実行:
- 各タスクがサブエージェント（Task tool）で実行可能な粒度
- [具体的な分割軸・観点]

### ステップ 2: 順次実行
/execute-plan でタスクを順番に実行

B. マルチセッション分割の場合

## 実行プラン

### ステップ 1: タスク分解
/decompose を以下の方針で実行:
- 各タスクが1セッションで完結する粒度
- [具体的な分割軸・観点]

### ステップ 2: タスク品質保証
/task-enrich で各タスクの自己完結性を検証・拡充

### ステップ 3: セッション引き継ぎ
/task-handoff でハンドオフコマンドを生成

C. スコープカットの場合

## スコープ交渉

以下の優先度で分類しました:

**Must（今回実施）**:
- [タスク1]
- [タスク2]

**Should（次回以降）**:
- [タスク3]

**Could（余裕があれば）**:
- [タスク4]

Must のスコープで進めますか？

4. メインエージェントに返す

生成した実行プランをユーザーに提示する。ユーザーの後続指示（「進めて」「修正あり」等）に従って続行する。

戦略決定の2段階化

scope-guard が提示するのは「仮戦略」（方向性）のみ。

/decompose はコードベース探索を含むため、探索結果によって仮戦略と実態がズレる可能性がある。その場合、メインエージェントが /decompose の結果を見て最終戦略を調整する。

エッジケース

再帰的スコープ超過

分解後のサブタスクがまだ大きい場合:

再帰は最大2階層まで
2階層目でもまだ大きい場合はスコープカットに移行

分解前に調査が必要

「分解不可能」に見える場合の多くは、情報不足が原因:

探索的タスク → 「調査」と「実装」のセッション分離を提案（戦略B）
要件不明確 → ユーザーに要件の明確化を求める（戦略Cの変形）

誤検知

ユーザーが /scope-guard 不要と判断 → そのまま続行
ユーザーが手動で /scope-guard を呼ぶ → CLAUDE.mdルールの検知を経ずに直接起動可能

連携スキル

| スキル | 役割 | scope-guard との関係 | |--------|------|---------------------| | /decompose | タスク分解 | scope-guard が粒度を指示 | | /task-enrich | タスク説明の拡充 | マルチセッション経路で使用 | | /task-handoff | セッション引き継ぎ | マルチセッション経路で使用 | | /execute-plan | タスク順次実行 | サブエージェント経路で使用 | | /approach-check | アプローチ確認 | 中規模タスク向け（scope-guard は過大向け） |

Agent Skills: Scope Guard

Install this agent skill to your local

Skill Files