mvpfy-context について
mvpfy-contextは、MVPFyオーケストレーター向けのスキルで、プロジェクト設定前や会話再開時に既存プロジェクトを調べ、技術的な背景をまとめます。根拠のある提案と未解決の質問を報告し、独自の .mvpfy 成果物以外は変更しません。
主な機能
- 01既存プロジェクトファイルの分析
- 02仕様書や製品資料の検索
- 03言語とフォルダー別のコード集計
- 04宣言されたスタックと依存関係の特定
- 05出典と確信度付きの提案
- 06未回答の質問の記録
活用シーン
- 01MVPインタビュー前のプロジェクト背景整理
- 02回答済みの質問を繰り返さずに会話を再開
- 03初期MVPの検討に役立つ技術情報の特定
- 04実装上の事実と未決の製品判断の切り分け
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/mvpfy-contextを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yamlscripts/analyze-existing-project.mjs
詳細
既存プロジェクトのコンテキスト
このスキルは、インタビューの前、プロジェクトのセットアップ中、および会話を再開するたびに最初に実行します。すでに作成されている資料を探し、MVPFy のオーケストレーターに簡潔な全体像を伝えます。
責務
- 利用側のディレクトリで
scripts/analyze-existing-project.mjsを実行します。 - Markdown、YAML、JSON ファイルから、仕様書、ブリーフ、バックログ、計画書、プロダクト文書、記録を探します。
- マニフェストを読み取り、言語別およびフォルダー別にプログラミングファイルの数を集計します。
- 宣言された技術スタック、アプリケーションの有無、最初の MVP の立案に役立つ技術的な兆候を把握します。
- 出典、要約、信頼度を添えて、回答案を提示します。
- 資料から回答できない質問を記録します。
制限事項
- 読み取りはコンテキストの把握に限られます。MVPFy 自身が
.mvpfy/内に作成する成果物を除き、利用側のプロジェクトのファイルは変更しません。 node_modules、vendor、.git、ビルド成果物、キャッシュ、カバレッジ、シークレット、バイナリファイルは読み取り対象外です。- 関数名、ルート、依存関係は実装を示しますが、製品の対象ユーザー、課題、価値提案、価格、受容性を証明するものではありません。
- 回答案で技術的な情報の不足は補えますが、会話中に製品、対象ユーザー、スコープに関する選択を本人が確認します。
- このスキルは
spec.mdを作成せず、specsfy/を変更せず、既存のコードを MVPFy のコードに転用しません。
出力
レポートは .mvpfy/existing-project.json に保存されます。次の情報が含まれます。
sources.specs：見つかった文書、種類、タイトル、パス、抜粋sources.code：言語別に分類されたプログラミングファイルmanifests：読み取ったマニフェストと宣言された依存関係stack：出典のパスとともに認識された技術suggested_answers：コンテキストから回答を補える項目gaps：未解決の質問summary：プロジェクトの集計と全体的な分析
状態には、existing_project_context に要約ポインターのみが保存されます。オーケストレーターはキューを作成する前にレポート全体を読み取り、質問の繰り返しを避けられる十分な回答案を利用し、資料に裏付けられていない結論はすべて保留として扱います。
オーケストレーターの起動タイミング
setup-project.mjs では、.mvpfy/ の初期作成後にこのスキルを実行します。$mvpfy との各会話の開始時にも、再度実行してください。
node skills/mvpfy-context/scripts/analyze-existing-project.mjs --project .
次に、.mvpfy/existing-project.json を state.json、answers.jsonl、MVP.md、コンテキストのソースと併せて読み取ります。資料がない場合は、アイデアを自由に説明してもらうところから続けます。資料がある場合は、すでに明らかになっている項目から始め、次に確認すべき重要な不足項目だけを提示します。