m_plan — リクエストを計画ドキュメントに変換
実装は行いません。他のエージェントがそのまま実装できるほど具体的な計画を作成することが目標です。
入力
- スキルとともに受け取った引数が既存のファイルパスの場合、そのファイルの内容がリクエストです。それ以外の場合は、引数全体(複数行を含む)がリクエストです。
- 引数が空の場合は、何を開発したいかを質問します。
手順
- 把握: リクエストを読み、関連する既存コード・ドキュメント(
AGENTS.md、plan/README.md、再利用可能なコード)を確認します。 - IDの決定: 計画内容を最もよく表す英大文字3文字の略語(例:
FKS= Foreign film Korean Subtitle)を決めます。plan/README.mdで重複を確認します。 - 前提の検証: 計画が依存している不確実な技術的前提は、簡易実験で確認します(CLIオプションの有無、外部サイト・APIへのアクセス可否、応答時間など)。確認結果と日付を計画に記載します。推測で計画しません。
- 作成: 以下のテンプレートで
plan/<ID>_plan_<エージェント>-<モデル>.mdを作成し(作成者の表記はAGENTS.mdを参照)、plan/README.mdのインデックステーブルに| <ID> | <計画名> | 計画中 |行を追加します。 - 決定の確定: 決定が必要な事項を
<ID>-Q1、<ID>-Q2… として記述し、ユーザーに一度に1つずつ質問します。- 各質問に選択肢を2〜3個提示し、推奨案には
(推奨)とその理由を付けます。 - ユーザーが選択肢にない回答をした場合は、実現可能か実験で確認した上で結果を伝え、反映します。
- 回答を受けたら
✅で確定を示し、本文の関連部分もその決定に合わせて修正します。
- 各質問に選択肢を2〜3個提示し、推奨案には
- 完了: すべての決定が確定したら、インデックスの状態を
計画確定(実装前)に変更し、コミットするかどうかを尋ねます。次のステップは/m_impl <ID>であることを案内します。
テンプレート (plan/<ID>_plan_<エージェント>-<モデル>.md)
# [<ID>] <計画名>
## 1. 目標
<何を、なぜ。範囲外の事項も明記>
## 2. 全体の流れ
<処理順序・優先順位。必要に応じて図>
## 3. ステップ別詳細
### 1) <ステップ>
- <具体的な方法、使用するコマンド/API/形式、失敗時の動作>
## 4. 共通モジュール
<複数のステップが共有する部分:入出力形式、外部ツール呼び出し、キャッシュ、エラー処理>
## 5. 実装構造
- ファイル構成、再利用する既存コード、依存関係の原則、設定方法
- CLI/使用方法の草案
## 6. 決定事項
- **<ID>-Q1** <質問> — 選択肢 …(確定した場合は `✅ <決定内容>`)
## 7. マイルストーン
| # | 内容 | 完了基準 |
| :--- | :--- | :--- |
| <ID>-M1 | … | <検証可能な基準> |