3d-builder は何をしますか?
3Dモデルを推測で作り始めないでください。何を構築するかを書き留め、ユーザーと曖昧な点を明確にし、すべての仮定を記録してからモデリングを行います。推測された寸法で作られたモデルは何度も修正されることになりますが、仕様書があれば、それらの推測がジオメトリになる前に捉えることができます。
ワークフローは常に次の順序で進めます:仕様 → 質問 → 間取り図(建物のみ) → モデル。仕様が存在し、質問が完了するまでは、BlenderやFreeCADを開いたり、モデリングコードを書いたりしないでください。建物の場合は、ユーザーが最初に間取り図を承認することも必要です。
プロジェクトレイアウト
1つのプロジェクトに複数のモデルが含まれる可能性があるため、1つのモデルに属するすべてのものは独自のフォルダに格納されます:
models/
<name>/
specs/
<yyyy-mm-dd-hhmmss>-<request>.md # リクエストごとに1つの仕様
plans/ # 建物のみ
layout.json
floor-<id>.svg
<name>.blend | <name>.FCStd # モデル
<name>.py # スクリプトのフォールバックのみ
<name>.glb | <name>.fbx # ゲーム/Webエクスポートのみ
.3d-builder.json # プロジェクト全体のツール選択の記憶
<name> はオブジェクトの短いケバブケースの名前です(例:phone-holder、router-wall-mount)。フォルダとモデルファイルの名前になります。以下のすべてのパスは、特に指定がない限り models/<name>/ からの相対パスです。
古いプロジェクト では、以前のフラットなレイアウト(specs/ と plans/ がプロジェクトルートにあり、models/<name>.blend がある)が使用されている可能性があります。見つけた場合は、そのまま作業し、ファイルをこの構造に移動することを1回提案してください。許可なく移動しないでください。
フェーズ1: 仕様を書く
- モデルの
<name>を選択します。新しいモデルの場合、models/<name>/がまだ存在しないことを確認し、作成してからspecs/フォルダも作成します。 - システムクロックからタイムスタンプを取得します(例:
date +%Y-%m-%d-%H%M%S)。自分で考えたタイムスタンプは使用しないでください。 - references/spec-template.md のテンプレートを使用して
specs/<yyyy-mm-dd-hhmmss>-<request>.mdを作成します。<request>はこのリクエストの短いケバブケースのラベルです:新しいモデルの場合はinitial、編集の場合は変更内容(thicker-hook、move-kitchen-wallなど)。
リクエストですでに述べられていることを入力し、次に未確定のポイントをリストアップします:ジオメトリに影響を与えるが指定されていないすべてのものです。典型的な未確定ポイントは以下の通りです:
- 全体の寸法と単位、および固定寸法と自由寸法の区別
- 実物に対するフィット感とクリアランス(60 mmのスマートフォンには、60 mmよりわずかに広いスロットが必要;どれだけの余裕が必要か?)
- 壁の厚さ、フィレット/面取り、穴のサイズ、ネジの種類
- 取り付け方法、向き、荷重
- 目的と製造方法(3Dプリント → オーバーハング、最小壁厚、平らな底面;CNC;レンダリングのみ;ゲーム/Webアセット)
- ゲーム/Webアセットの場合:ターゲットエンジン、ポリゴン予算、エンジン単位でのスケール、ピボット位置、UVとテクスチャ vs 単色、LOD、衝突メッシュ
- 詳細レベル、マテリアル(Blender)、パラメトリックの必要性(FreeCAD)
- 建物の場合:階数、フットプリント、部屋とそのサイズ、階段、ドアと窓。これらはフェーズ3の間取り図で確定するため、ここではなくそこにリストアップします
既存のモデルの編集: まず models/ 内のオブジェクトのフォルダを見つけてください。変更用の新しい仕様を書きます(各リクエストは独自のファイルを持つため、履歴が読みやすくなります)。前の仕様にリンクし、何が変更され、何が同じままである必要があるかを記述します。編集する前に、既存のモデルを(MCPを介して、またはそれを構築したスクリプトを使用して)読み取り、実際にあるものから編集を開始します。plans/ フォルダがある建物の場合、レイアウトの変更はまず間取り図を経由します(フェーズ3、「建物の編集」を参照)。
フェーズ2: 質問の明確化
リクエストに未確定のポイントが残っている場合は、モデリングを行う前にそれらについて質問してください。ユーザーはあなたが推測できないことを知っています(実際のスマートフォンの幅、壁のネジの位置など)。今1つの質問をすることで、後で再構築する手間を省けます。
ルール:
- 一度に1つの質問のみ。 回答を待ってから次の質問をしてください。ジオメトリへの影響が大きい順に質問を並べてください:全体のサイズと目的が最初、細かいデザインが最後です。
- 可能な限りはい/いいえで。 「ケーブルスロットは中央に配置しますか?」は「ケーブルスロットはどこに配置しますか?」より優れています。
- それ以外は選択式: 推奨オプションを最初に「(推奨)」とマークし、次に代替案、最後に自由記述の回答を配置します。エージェントの質問ツール(AskUserQuestionなど)があればそれを使用してください。通常、自由記述オプションが自動で追加されます。
- 5問ごとに区切る: 5問ごとに、残り何問未解決かをおおよそ示しながら、さらに最大5問続けるかどうかを尋ねます。ユーザーが「いいえ」と言ったら、質問を終了します。
- このモデルに関係のないことや、ユーザーがすでに述べたことについて質問しないでください。
- 各回答をすぐに仕様の「決定」セクションに記録し、仕様が常に最新の状態になるようにします。
重要な点が不明確でなくなったとき、またはユーザーが回答をやめたときに終了します。残った未確定のポイントについては、自分で決定し、述べられた目的に対して妥当なデフォルトを選択し、1行の理由とともに「仮定」に記録します。ユーザーは仕様を読めば、自分に代わって行われたすべての選択を見ることができるようにしてください。
リクエストがすでに完全に指定されている場合は、質問をスキップし、その旨を1行で伝えてください。
フェーズ3: 間取り図(建物のみ)
モデルが建物または部屋を持つ場合は、モデリングの前にレイアウトを紙面上で確定します。references/floorplans.md を読み、それに従ってください:
- 間取り図についてユーザーと話し合います。上記の質問ルールを使用します:階数、フットプリント、部屋、隣接関係、階段、ドア、窓。
- 各フロアのベクター計画を描画します。
plans/layout.jsonを作成し、同梱の scripts/draw_plans.py を使用してplans/floor-<id>.svgを生成します。 - 間取り図をユーザーとレビューし、ユーザーが承認するまで修正します。承認を「決定」に記録します。
承認された layout.json は、モデルの壁、開口部、部屋、階段に関する信頼できる情報源です。建物以外ではこのフェーズをスキップしてください。
フェーズ4: モデル
結果をモデルのフォルダ内の <name>.blend(Blender)または <name>.FCStd(FreeCAD)に保存します。ゲームまたはWebアセットの場合は、ソースファイルの隣にエクスポートも行います(エンジン用エクスポート を参照)。
ツールを選択する
どのMCPサーバーが設定されているかを確認します:利用可能なツールからBlenderまたはFreeCADのMCPツールを探します(名前には通常 blender または freecad が含まれます)。
- 記憶された選択: プロジェクトルートに
.3d-builder.jsonが存在する場合、ユーザーが別のものを要求しない限り、その `