planning について
複雑な複数ステップの作業を管理する、AI Maestroの単独で使えるスキルです。3つの永続的なMarkdownファイルに計画、調査結果、進捗を記録し、エージェントがタスクの文脈を保てるようにします。
主な機能
- 013ファイルの計画パターン
- 02フェーズ・判断・エラーの記録
- 03調査結果の記録
- 04セッション進捗とテストのログ
- 053回失敗時の対応手順
活用シーン
- 01複数ステップの調査プロジェクトの管理
- 02機能開発をフェーズ別に計画
- 03ツールを使う作業中の発見を記録
- 04中断後のタスク文脈の復元
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/planningを入力して読み込まれたか確認します。
詳細
AI Maestro Planning
複雑で多段階のタスクの実行中に集中を保つという実行上の課題を解決します。永続的な Markdown ファイルを使って目標、調査結果、進捗を記録するため、コンテキストを失うことがありません。AI Maestro スイートの一部です。
使用するタイミング
- 多段階のタスク（3ステップ以上）
- リサーチプロジェクト
- 5回を超えるツール呼び出しが必要な機能の構築
- 目標を見失う可能性がある任意のタスク
3ファイルパターン
docs_dev/（または $AIMAESTRO_PLANNING_DIR）に作成します。
| ファイル | 目的 | 更新するタイミング |
|---|---|---|
task_plan.md | 目標、フェーズ、決定事項、エラー | 各フェーズの後 |
findings.md | リサーチ、発見事項、リソース | リサーチ中 |
progress.md | セッションログ、テスト結果 | セッション中を通して |
クイックスタート
PLAN_DIR="${AIMAESTRO_PLANNING_DIR:-docs_dev}"
mkdir -p "$PLAN_DIR"
その後、次の内容で task_plan.md を作成します。
# Task: [Goal]
## Phases
- [ ] Phase 1: Research
- [ ] Phase 2: Design
- [ ] Phase 3: Implement
- [ ] Phase 4: Test
## Decisions
| Decision | Rationale | Date |
|----------|-----------|------|
## Errors Encountered
| Error | Attempt | Resolution |
|-------|---------|------------|
6つのルール
- 最初に計画を作成する --
task_plan.mdを用意せずに複雑な作業を始めないでください - 判断する前に読み直す -- 重要な判断を行う前に、必ず計画を読み直してください
- 行動後に更新する -- フェーズを完了としてマークし、変更内容を記録してください
- 2アクションルール -- 検索・閲覧操作を2回行うごとに、発見事項を
findings.mdに保存してください - すべてのエラーを記録する -- すべてのエラーを、試行回数と解決策とともに計画に記載してください
- 失敗を繰り返さない -- 操作が失敗した場合は、アプローチを変更してください
3回失敗時のプロトコル
| 失敗回数 | 対応 |
|---|---|
| 1 | 根本原因を診断し、的を絞った修正を適用する |
| 2 | 別のアプローチを全面的に試す |
| 3 | 前提を疑い、類似の問題を検索する |
| 3回後 | すべての試行内容を記録したうえで、ユーザーにエスカレーションする |
5つの質問による再確認
どこにいるかわからなくなったら、計画ファイルを基に次の質問に答えてください。
- 現在どこにいるか？（
task_plan.mdにおける現在のフェーズ） - これからどこへ向かうのか？（残りのフェーズ）
- 目標は何か？（目標のセクション）
- 何を学んだか？（
findings.md） - 何を行ったか？（
progress.md）
AI Maestro のフル機能
このスキルは依存関係なしで単独でも動作します。メモリ検索、ドキュメント検索、グラフクエリ、エージェントメッセージング、エージェント管理を含む完全な機能を利用するには、AI Maestro プラットフォーム全体をインストールしてください。
コメント
Markdown 対応