make-it-real は何をしますか？
大まかなアイデアをプロジェクト仕様書、納品範囲、タスク引き継ぎに変換するポータブルなAIエージェントスキルです。
概要
このスキルは、AIエージェントがユーザーから提供された曖昧なアイデアやニーズを、以下の3つの主要な成果物に変換できるようにします。
- プロジェクト仕様書 (
specs/)：要件、制約、機能一覧、技術スタックなどを含む詳細な文書。 - 納品範囲 (
scopes/)：MVP（Minimum Viable Product）や特定のリリースにおける実装範囲と成果物を定義したスコープドキュメント。 - タスク引き継ぎ (
handoffs/)：実際の開発フェーズに移行するための、実装者向けの具体的で実行可能なタスクリスト。
使い方
- アイデアの提示：ユーザー（あなた）は、AIエージェントに対して実現したいアイデアを自然言語で説明します。
- スキルの実行：AIエージェントはこのスキル（make-it-real）を呼び出し、提供された情報を解析します。
- ドキュメントの生成：エージェントは上記3つの成果物を生成し、プロジェクトのルートディレクトリに
specs/,scopes/,handoffs/というディレクトリを作成して保存します。 - レビューと調整：生成されたドキュメントは、ユーザーとエージェントの間でレビュー・調整され、必要に応じて改善されます。
- 開発開始：
handoffs/ディレクトリのタスクリストに従って、実際のコーディングや実装作業を開始できます。
対応プラットフォーム
このスキルは、以下のようなAIエージェントツールで動作するように設計されています。
- Claude Code (Anthropic)
- Cursor
- Codex (OpenAI)
- その他、カスタム指示（プロンプト）やスキルファイルを読み込めるエージェント
スキルの構成
このスキルは、プロジェクトディレクトリ内の以下の構造を前提としています。
project-root/
├── specs/ # プロジェクト仕様書
│ └── spec.md
├── scopes/ # 納品範囲
│ └── v1-scope.md
├── handoffs/ # タスク引き継ぎ
│ └── handoff-to-dev.md
└── .make-it-real/ # スキルの内部設定やテンプレート（存在する場合）
└── ...
利点
- スピード：アイデアから具体的な計画への変換を数分で完了します。
- 一貫性：常に同じ構造と品質のドキュメントを生成します。
- 可搬性：特定のプラットフォームに依存せず、様々なAIエージェントで利用できます。
- 明確性：プロジェクトのスコープを明確に定義することで、手戻りや誤解を防ぎます。
注意点
- このスキルは、あくまで初期の計画立案を支援するものです。生成されたドキュメントは、実際の開発前に人間がレビューし、調整することを推奨します。
- スキルの効果は、入力されるアイデアの具体性と質に依存します。より詳細な情報を提供することで、より精度の高い成果物が得られます。