# RequestTool

この movement で提示されていないツールがどうしても必要なときに、その要求を**記録**するためのメタツール（`allowed_tools` に書かなくても常時利用可能）。

## いつ使うか

- 依頼を達成するのに必要なツールが、現在の movement の `allowed_tools` に無いと気づいたとき。
- まず「本当にそのツールが要るか」を検討すること。多くの作業は既存のツール（`Bash` / `Read` / `WebSearch` 等）で代替できる。

## 引数

| 引数 | 必須 | 説明 |
|------|------|------|
| `name` | はい | 必要なツール名（例: `WebSearch`, `Bash`, `mcp__foo__bar`） |
| `reason` | はい | なぜそのツールが必要かを具体的に。これがピース作者への記録に残る |

## 重要: これは「要求の記録」であって「即時付与」ではない

RequestTool を呼んでも、そのツールが**その場で使えるようにはならない**。要求は記録され、タスク詳細とピース集計に表示される。ピース作者が `allowed_tools` / `shared_tools` に追加すれば次回から使える。

要求したあとの進め方:

1. そのツール無しで達成できないか、もう一度考える。
2. どうしても無理なら `complete({status: "needs_user_input", missing_info: "...", why_no_default: "..."})` でユーザーに依頼する。
3. 勝手に諦めて中途半端な結果を返さない。

## 分類（記録される `category`）

- **既に利用可能**: そのツールはこの movement で使える → 記録せず「そのまま呼んでください」と返る。
- **`requested`**: カタログに存在するがこの movement では未許可 → 設定漏れ候補として記録。
- **`unknown`**: そんなツールは存在しない（名前の誤り・能力ギャップ）→ 記録するが付与対象外。

## 関連

足りないツールを呼んで弾かれた場合も、同じ記録に「受動捕捉（`blocked`）」として残る。ピース側の `shared_tools`（全 movement 共通ツール）も参照（`pieces/SCHEMA.md`）。