Intake-First Planner（スキーマ先行設計プランナー）

Intake-First Planner（スキーマ先行設計プランナー） は何をしますか？

このスキルは、推測によるパラメータから進めてはならないプロジェクトに使用します。物理レイアウトプランナー、ワークステーションや家具の配置ツール、機器配置、ケーブル配線、スケジュール/リソース最適化、シミュレーション設定、および同様の制約充足システムが対象です。ユーザーが完全な初心者であることを前提とし、必要な情報を平易な言葉で説明し、記入可能なYAMLを提供し、実装の詳細を理解する必要をなくします。

基本ルール

必要な事実とシナリオが、前提を不要にするほど明確になるまでは、ドメイン固有のロジックを解決、最適化、推奨、またはスキャフォールドしてはいけません。重要なデータが不足している場合は、「Missing Parameters（不足パラメータ）」の情報収集応答を出力し、実装前に処理を停止します。

ワークフロー

1. リクエストを分類します：
   • 情報収集のみ：ユーザーは要件、スキーマ、またはプロンプトの整理を希望。
   • 情報収集後の構築：ユーザーはコード、テスト、レポート、または再利用可能なプロジェクトを希望。
   • スキル作成：ユーザーは再利用可能/オープンソースのスキルまたはプロンプトパッケージを希望。
2. 該当するリファレンスを選択します：
   • 汎用再利用可能ワークフロー：references/intake-workflow.mdを読む。
   • 空間/レイアウトプランナー：references/spatial-layout-domain.mdを読む。
   • Three.jsレポートまたは3D/ビジュアル出力：references/threejs-visualization.mdを読む。
   • 一回限りのプロンプトを再利用可能なスキルに変換：references/prompt-to-skill.mdを読む。
   • スキルパッケージ化/オープンソース変換：references/skill-packaging.mdを読む。
3. 構造化された事実ソース（通常はYAMLまたはJSON）を作成または更新します。
4. 実行をゲートします：
   • 必要な事実が不足している場合、不足パラメータのチェックリスト、推奨スキーマ断片、必要なシナリオ、および明示的な非前提事項のみを返します。
   • 事実が完全な場合、事実ソースを権威ある入力としてプロジェクトを実装します。
5. Pythonプロジェクトではuvコマンドを優先します。引き継ぎ/復旧ドキュメントには必ずvenv + pipの復旧コマンドを含めます。
6. ユーザーが明示的に履歴復旧を要求しない限り、過去のセッションJSONL、チャットログ、または以前の会話を読み込んではいけません。

出力パターン

入力不足の場合、以下の形式を使用します：

これを安全に解決するには、いくつかの具体的な測定値が必要です。以下のYAMLに記入して回答できます。不明な値は`null`のままにしても構いません。

**不足パラメータ**
- ...

**推奨YAML**
```yaml
...
```

**確認すべきシナリオ**
- ...

**非前提事項**
- ...

実装の場合は、以下の構成でプロジェクトを作成します：

• pyproject.toml、src/、tests/、examples/、reports/、outputs/
• 単一の事実ソースとしての構造化設定例
• 幾何学やレイアウトが関与する場合は、上面図のSVG/HTMLとThree.js 3D HTMLビューアを使用したビジュアルレポート
• パース、変換、制約、スコアリング、および少なくとも1つのシナリオ回帰テストのための決定論的テスト
• uvとvenv + pipの両方のコマンドを含むHANDOFF.md、RECOVERY_README.md、PROJECT_CONTEXT.md

再利用可能なアセット

• schemas/intake_project.schema.yaml：汎用スキーマテンプレート。
• schemas/spatial_layout.schema.yaml：空間/レイアウトスキーマテンプレート。
• references/threejs-visualization.md：デフォルトの3D可視化ガイダンス。
• examples/workstation_layout_request.yaml：ドメインリクエストの例。
• examples/furniture_layout_request.yaml：部屋/家具計画の例。
• examples/equipment_cable_routing_request.yaml：機器配置とケーブル配線の例。
• scripts/check_skill_package.py：軽量パッケージ健全性チェッカー。