freecad-modeling-order

name	freecad-modeling-order
description	FreeCAD MCPツールを使って3Dモデリングを行う際に、ツールの正しい実行順序を参照・適用するためのスキル。 複数ステップのモデリング（コーヒーカップ・ボトル・穴あきプレート・スイープ形状など）を行うとき、 ブール演算・シェル化・フィレット・パターン・ミラーを組み合わせるときは必ずこのスキルを参照すること。 FreeCAD MCPツール（create_box, combine_by_name, shell_body, add_fillet, extrude_sketch など）を 1つ以上呼び出す可能性があるモデリング作業であれば、迷わずこのスキルを使うこと。

FreeCAD モデリング実行順序ガイド

FreeCAD MCPツールは 順序依存が強い。間違った順序で呼ぶとブール演算失敗・フィレット不可・スケッチ未定義エラーが発生する。 このスキルでは「なぜその順序なのか」を理解したうえで正しい順序でツールを呼び出すことを目的とする。

---

作業開始前の確認

モデリングを始める前に必ず座標軸を確認する。

get_bounding_box または get_body_center で既存ボディの位置を把握する。
既存ボディがない場合は原点（0, 0, 0）を基準とする。

• X軸・Y軸・Z軸のどの方向が「高さ」「幅」「奥行き」に対応するかを把握してから形状を配置する
• FreeCAD では通常 Z軸が上方向
• 複数ボディを組み合わせる場合は、各ボディの基準点が揃っているかを確認してからブール演算に進む

---

基本原則：フェーズ順に進む

① 形状作成・スケッチ
    ↓
② 配置（移動・回転）
    ↓
③ ブール演算（結合 join / 切除 cut）
    ↓
④ シェル化（中空化）     ← join の後でないと薄肉ボディへのブール演算が失敗する
    ↓
⑤ パターン・ミラー       ← ブール演算の前後どちらかは意図による（後述）
    ↓
⑥ フィレット・面取り     ← 必ず最後。ここより前にブール演算を入れると失敗する
    ↓
⑦ 確認（情報取得・干渉チェック）
    ↓
⑧ 保存・エクスポート

---

最重要ルール

ルール1：フィレット・面取りは絶対に最後

add_fillet / add_chamfer の後にブール演算（combine_*）を呼んではいけない。 丸みのついたエッジは後続のブール演算カーネルを失敗させる。

OK: combine_by_name(cut) → add_fillet NG: add_fillet → combine_by_name(cut)

ルール1-b：フィレット前に必ず get_edges_info でエッジ型を確認する

add_fillet / add_chamfer は curve_type == "Circle" のエッジにのみ適用できる。 "Line" 型エッジを指定するとエラー「There are no suitable edges」が発生する。

必ずこの手順を踏む：

1. get_edges_info(body_name="MyBody") でエッジ一覧を取得
2. curve_type == "Circle" のインデックスだけを選ぶ
3. add_fillet(edge_indices=[...) に渡す

OK: get_edges_info → Circle型のインデックスを抽出 → add_fillet NG: インデックスを決め打ちで add_fillet を呼ぶ

ルール2：ブール結合（join）→ シェル化（shell_body）

shell_body はソリッドの状態で呼ぶ。取っ手付き容器のような複合形状は、 必ず全パーツを combine_by_name(join) で1つのソリッドにしてから shell_body を呼ぶ。 薄肉シェル状態のボディに対してブール演算を行うと形状が破綻する可能性が高い。

OK: combine(join) → shell_body → add_fillet NG: shell_body → combine(join) → add_fillet

補足：中空化に cut を使う場合も同様。 取っ手などの付属物は必ずソリッドの状態で join してから、内側 cut で中空化する。

OK: 外形作成 → 取っ手join → 内側cut（中空化） NG: 外形作成 → 内側cut（中空化） → 取っ手join

ルール3：移動・回転してからブール演算

ツール形状を正しい位置に配置してからブール演算を行う。

OK: create_cylinder → move_by_name → combine_by_name(cut) NG: create_cylinder → combine_by_name(cut) → move_by_name

ルール4：スウィープ・ロフトは全スケッチを先に用意する

sweep_sketch はプロファイルスケッチとパススケッチ両方が存在しないと失敗する。 loft_sketches は全プロファイルスケッチが揃ってから呼ぶ。

OK: create_sketch(profile) → create_sketch(path) → sweep_sketch NG: sweep_sketch を呼んでから path スケッチを作る

ルール5：干渉チェックしてからブール演算

check_interference で重なりを確認してから combine_by_name(cut/join) を呼ぶと 意図しない形状生成を防げる。干渉なし(False)のまま cut を呼んでも形状は変化しない。

---

ケース別ベストプラクティス

① 取っ手付き容器（コーヒーカップ・マグカップ等）

1. create_cylinder          カップ本体（ソリッド）
2. create_pipe              取っ手（ソリッド）
3. move_by_name             取っ手を正しい位置へ
4. check_interference       重なりを確認
5. combine_by_name(join)    本体＋取っ手を一体化（ソリッド同士）
6. shell_body               一体化後に中空化（開口面・厚みを指定）
7. add_fillet               最後に角を丸める
8. export_file

② ボルト穴パターン（円形配列で複数穴を一括切除）

パターン化→一括切除の方が、1穴ずつ切除を繰り返すより安定する。

1. create_cylinder          本体
2. create_cylinder          穴ツール（1個）
3. move_by_name             1か所目の位置へ配置
4. create_circular_pattern  穴ツールを円形配列（切除前にパターン化）
5. combine_selection(cut)   本体からパターン全穴を一括切除
6. add_chamfer              穴の入り口を面取り（最後）
7. export_file

③ 左右対称部品（ミラーコピー）

フィレット前にミラー＆結合することで、接合ラインに問題が起きにくい。

1. create_sketch + draw_*            片側の断面スケッチ
2. add_*_constraint / add_*_dimension   拘束・寸法を確定
3. extrude_sketch                    片側をソリッド化
4. copy_body_symmetric               フィレット前にミラーコピー
5. combine_by_name(join)             両側を結合（ソリッド同士）
6. add_fillet                        結合後に丸め（最後）
7. export_file

④ スウィープ形状（パイプ継手・曲管等）

1. create_sketch(plane=yz)   断面プロファイルを先に用意
2. draw_circle_in_sketch     断面形状を描く
3. create_sketch(plane=xy)   パス用スケッチを用意
4. draw_line_in_sketch       パス形状を描く
5. sweep_sketch              両スケッチが揃ってから実行
6. add_fillet                最後

⑤ 矩形パターン（格子状穴・リブ配列等）

1. create_cylinder / create_box     ツール形状（1個）
2. move_by_name                     基準位置へ配置
3. create_rectangular_pattern       X/Y方向に配列（切除前）
4. combine_selection(cut)           一括切除
5. add_fillet / add_chamfer         最後

---

ツール別注意事項

ツール	注意点
delete_all_features	モデリング途中では絶対に使わない。新規作業開始・作り直し時のみ冒頭で使用
save_document	ユーザーが「保存して」と明示的に指示した場合のみ呼ぶ。自動保存しない。 保存時は必ずフルパスを渡す（例: D:/freecad_mcp_server/MyPart.FCStd）。パスなしで呼ぶと未保存ドキュメントでは失敗する
shell_body	ブール結合（join）後に呼ぶ。シェル化前に全パーツを join しておく
add_fillet / add_chamfer	全ブール演算・パターン完了後に呼ぶ
combine_selection_all	非表示ボディは対象外。hide_body で除外してから使う
create_section_view	可視化・確認用途のみ。断面ボディを後続ブール演算に使わない
loft_sketches	全プロファイルスケッチが存在してから呼ぶ
sweep_sketch	プロファイルとパスの両スケッチが存在してから呼ぶ
get_edges_info	add_fillet 前に呼んでエッジインデックスを確認するとミスを防げる
check_interference	ブール演算前の確認に使う。False（干渉なし）の状態で cut しても形状は変わらない

---

スケッチワークフロー順序

create_sketch
  → draw_rectangle_in_sketch / draw_circle_in_sketch / draw_line_in_sketch
  → add_horizontal_constraint / add_vertical_constraint / add_parallel_constraint
  → add_perpendicular_constraint / add_coincident_constraint / add_tangent_constraint
  → add_linear_dimension / add_radius_dimension
  → extrude_sketch / revolve_sketch / sweep_sketch / loft_sketches

拘束・寸法は図形を描いた後に追加する。先に拘束を追加しても図形がないので適用できない。

---

クイックリファレンス

【作業開始前】← 必ず最初に実行
  get_bounding_box / get_body_center  → 座標軸・既存ボディの位置を把握
  （既存ボディなし → 原点(0,0,0)を基準に設計開始）

【形状作成】
  create_box / create_cylinder / create_sphere / create_cone /
  create_torus / create_hemisphere / create_half_torus /
  create_polygon_prism / create_pipe / create_cube
  create_sketch → draw_* → add_*_constraint → add_*_dimension
  extrude_sketch / revolve_sketch / loft_sketches / sweep_sketch

【配置】
  move_by_name / rotate_by_name → (任意) check_interference

【ブール演算】
  combine_by_name / combine_selection / combine_selection_all

【中空化】← ブール結合の後
  shell_body

【パターン・ミラー】
  create_circular_pattern / create_rectangular_pattern / copy_body_symmetric

【仕上げ】← 必ず最後
  add_fillet / add_chamfer

【情報確認】← 任意のタイミング
  get_all_bodies / get_body_dimensions / get_bounding_box / get_body_center /
  get_mass_properties / get_edges_info / get_faces_info /
  measure_distance / measure_angle / check_interference

【出力】← 最後
  save_document / export_file