| name | fit-check |
| description | 段階 4-5 の橋渡し — パーツ間の嵌合・接合面・蝶番組合せの干渉/クリアランスを点検する。リップ嵌合、蝶番ナックル組み合わせ、ねじ穴・差し込み・スナップ等の突合機構を CAD 干渉解析+ルールベースで検証。 |
| when_to_use | 「嵌合をチェック」「干渉してないか確認」「ヒンジが組める?」「export 前の最終チェック」「ALLOWLIST を見直す」のとき。 |
| allowed-tools | Read, Write, Edit, Glob, Bash(.venv/bin/python *), Bash(python *) |
| paths | ["output/design/fit_check.py","output/reports/fit-check.md"] |
| model | claude-opus-4-7 |
/fit-check — 嵌合・接合チェック skill
目的
/review-fix で確定した設計を /export する前に、パーツ同士の嵌合と接合面のクリアランス・干渉を網羅的に点検する。
ターゲットは:
- リップ嵌合: 蓋リップが本体内寸に収まるかの全周クリアランス
- 蝶番組み合わせ: 本体ナックル × 蓋ナックルの噛み合い、ピン穴整合、壁埋込時の本体壁リリーフ
- CAD 上の幾何干渉: 閉じた状態で
body.intersect(lid) の体積を計測し、未許容の重なりを検出
- 将来拡張: ねじ穴と相手部品、差し込み突起と受け穴、スナップ機構、磁石マウント等の 2 パーツ以上の嵌合機構全般
対象は body / lid に限らず、PART_PAIRS 定義に追加すれば任意のパーツペアに展開可能。
関連スキルとの違い
| スキル | 役割 |
|---|
validator.py | 単一パーツの「設計ルール」(壁厚・蓋厚・タブ寸法等) |
/fit-check(本スキル) | 複数パーツの嵌合(クリアランス・干渉)+ 過去事例パターンの網羅 |
/review-fix | 利用者からの個別フィードバックの反映 |
/export | 最終 STL/3MF + スライサー設定 |
fit-check は validator と相補。validator は「壁が薄すぎないか」、fit-check は「組み立たないか」。
前提条件
output/design/generator.py validator.py が存在output/preview/case-body.step case-lid.step(または対象パーツの STEP)が最新- 利用者が CAD 上の重なりや 3D 形状を一度確認済み(段階 4 を経ている)
入出力
| 区分 | パス | 説明 |
|---|
| 入力 | input/design-params/case-config.yaml | 数値パラメータ |
| 入力 | input/requirements/case-spec.yaml | 構造仕様 |
| 入力 | input/objects/*.yaml | 対象オブジェクト寸法 |
| 入力 | output/preview/*.step | CAD 干渉解析の対象 |
| 出力 | output/design/fit_check.py | 初回生成・以降は利用者カスタムを尊重 |
| 出力 | output/reports/fit-check.md | 結果レポート |
チェック項目(過去事例ベース)
A. 内寸マージン
| 項目 | 推奨 | 警告 | 失敗 |
|---|
| object_clearance | ≥ 1.0 mm | ≥ 0.5 mm | < 0.5 mm |
| z_margin | ≥ 1.0 mm | ≥ 0.5 mm | < 0.5 mm |
| 内寸 X/Y/Z 各軸 vs 実測オブジェクト | + 1mm 以上 | + 0.5 〜 1mm | + 0.5mm 未満 |
理由: FDM 印刷の反り・収縮で内寸が縮む。実寸ぴったりだと収まらない事故多数。
B. リップ嵌合クリアランス
| 項目 | 推奨 | 警告 | 失敗 |
|---|
| fit_clearance(全周共通) | ≥ 0.4 mm | ≥ 0.3 mm | < 0.3 mm |
| 蝶番側追加クリア(蝶番がある場合) | ≥ 1.0 mm | ≥ 0.5 mm | < 0.3 mm |
| ラッチ側 / 反対側 | 0.3-0.5 mm | 0.2 or 0.7 | < 0.2 or > 1.0 |
理由: 蝶番ピンが蓋位置を Y 方向に拘束するため、蝶番側だけ非対称に大きいクリアランスが必要。ラッチ側はラッチ自体の弾性で吸収できるので標準値で十分。
C. 蝶番設計
| 項目 | 推奨 | 警告 | 失敗 |
|---|
| ナックル肉厚 = (knuckle_d - pin_d - pin_clear) / 2 | ≥ 1.5 mm | ≥ 1.0 mm | < 1.0 mm |
| ナックル Z 高さ | ≥ 5 mm | ≥ 3 mm | < 3 mm |
| pin_clearance | 0.4-0.6 mm | 0.3 or 0.7 | < 0.3 or > 1.0 |
| knuckle_clearance_z | 0.4-0.6 mm | 0.3 or 0.8 | < 0.3 |
| body_relief_clearance(壁埋込時) | ≥ 0.3 mm | ≥ 0.2 mm | < 0.2(または未設定) |
| lid_knuckle_extra_clearance_z(本体固定運用で蓋のみ縮める場合) | 0.3-0.5 mm | 0.2 or 0.6 | — |
理由:
- ピン挿入容易性、回転自由度、壁埋込時のリリーフカット干渉、本体固定運用への対応
- 壁埋込型蝶番の落とし穴: 本体側ナックル円柱が壁に食い込んでいる場合、蓋ナックル Z 位置でも本体壁が solid に存在するため、リリーフカット(円筒状の除去)が必要。これを忘れると蓋シリンダーが壁と干渉して蓋が収まらない
D. CAD 上の干渉(closed state)
CadQuery で本体と蓋を閉じた位置で重ね、body.intersect(lid) の体積を計算:
| 体積 | 判定 |
|---|
| ≥ 100 mm³ | ❌ 重大な干渉 |
| 1 - 100 mm³ | ⚠ 小さな干渉(意図的か確認、ALLOWLIST に登録すれば pass) |
| < 1 mm³ | ✅ |
ALLOWLIST は fit_check.py 内に宣言。例:
ALLOWLIST = [
{
"label": "本体ナックル右半円×蓋プレート -Y 端",
"max_mm3": 50.0,
"where": "蝶番付近、構造上避けられない 1mm 帯",
},
]
ALLOWLIST の合計を超える分が「未許容の干渉」として ❌ 扱い。
ALLOWLIST の運用ルール:
- 意図的な重なりは label / max_mm3 / 理由を必ず併記
- 解消した重なりは ALLOWLIST から削除し、コメントで「いつ・どう解消したか」を残す(例:
# 旧エントリ「○○」は 2026-XX-XX に lid_relief_clearance を導入し CAD レベルで解消したため削除)
- 「動作確認後の手削り対応」も ALLOWLIST 外で許容することは避ける(明示的な許容 vs 暗黙の許容を区別)
E. 印刷可能性(他カテゴリと重複しないもの)
- 各部品が printer_bed に収まる
- 全壁が min_wall_thickness を満たす
- print_orientation が定義されている
- 蓋 axis(closure.lid_axis)が本体形状と整合
F.(将来拡張)他の嵌合機構
PART_PAIRS / MECHANISMS に追加することで以下も対象化:
- ねじ穴 vs 相手ボス: 雌ねじクリアランス、ボス肉厚
- 差し込み突起 vs 受け穴: 突起径と穴径の差、挿入長
- スナップフック vs 受けリブ: フック撓み量、引っ掛かり代
- 磁石マウント: 磁石ポケット深さ、引き合い距離
- 複数オブジェクト間の接触面: 例: バッテリーホルダーと本体ホルダーの接合面
各機構のチェック関数を fit_check.py 内で定義し、MECHANISMS レジストリに登録する設計。
処理フロー
Step 1: fit_check.py(shim)の準備
本体ロジックは src/case_blueprint/fit_check.py に集約済み。利用者プロジェクトの
output/design/fit_check.py は 薄い shim として、ALLOWLIST と generator が
組んだ parts を渡して main() を呼ぶだけにする:
"""fit_check.py — src/case_blueprint.fit_check の shim。
本ファイルでカスタマイズするのは ALLOWLIST(意図的な微小重なりの登録)と
プロジェクト固有チェッカーのみ。MECHANISMS の登録は @register_mechanism で。
"""
from case_blueprint import fit_check, loader, closures, features
ALLOWLIST = [
]
def _build_parts(cfg):
"""generator.py と同じ手順でパーツを再構築して dict で返す。
CAD 干渉解析(D)に渡す。"""
import cadquery as cq
from case_blueprint.geometry import (
internal_bbox_stacked, internal_bbox_side_by_side, external_bbox,
)
case_spec, case_config, objects = cfg["case_spec"], cfg["case_config"], cfg["objects"]
layout = case_spec["case"].get("layout", {})
arrangement = layout.get("arrangement", "stacked")
fn = internal_bbox_stacked if arrangement == "stacked" else internal_bbox_side_by_side
internal = fn(
objects,
object_clearance=case_config.get("internal", {}).get("object_clearance", 1.0),
z_margin=case_config.get("internal", {}).get("z_margin", 0.0),
)
walls = case_config.get("walls", {})
eb = external_bbox(internal, wall_thickness=walls.get("thickness", 2.0))
body = cq.Workplane().box(eb.width, eb.depth, eb.height).cut(
cq.Workplane().box(internal.width, internal.depth, internal.height)
)
lid = cq.Workplane().box(eb.width, eb.depth, case_config.get(, {}).get(, ))
body_zmax = body.val().BoundingBox().zmax
lid = lid.translate((, , body_zmax + lid.val().BoundingBox().zlen / ))
method = case_spec[][][]
parts = closures.build(method, body, lid, case_spec, case_config)
parts
__name__ == :
cfg = loader.load_all()
parts =
:
parts = _build_parts(cfg)
Exception e:
()
SystemExit(fit_check.main(cfg=cfg, parts=parts, allowlist=ALLOWLIST))
shim が無ければ skill が初回生成。既に存在する shim は上書きしない
(ALLOWLIST など利用者編集を尊重)。
Step 2: チェック実行
python output/design/fit_check.py
実行内容:
- case-config / case-spec / objects を読み込む
- ルールベースチェック(A-C, E)を実施
- CAD パーツ(
output/preview/*.step)を読み込み、PART_PAIRS で定義された組み合わせを閉じた位置で intersect
ALLOWLIST と照合して未許容部分を特定- レポート組み立て、
output/reports/fit-check.md へ出力
Step 3: レポート確認
# Fit-Check Report
## サマリー
- ✅ Pass: N
- ⚠ Warning: M
- ❌ Fail: K
## A. 内寸マージン
- ✅ object_clearance: 1.5 mm (推奨 ≥ 1.0)
- ⚠ z_margin: 0.5 mm (推奨 ≥ 1.0)
## D. CAD 干渉解析
- pair: case-body × case-lid (closed)
- 重なり総体積: 35.6 mm³
- allowlist 合計: 50.0 mm³
- 未許容: 0 mm³ ✅
Step 4: 利用者に提示
判定:
- ❌ がある: 印刷前に修正を推奨。
/review-fix に戻って調整
- ⚠ のみ: 印刷可能。ただし以下の点を確認(リスト)
- ✅ のみ: 印刷準備 OK。
/export に進めます
ゲート
/export 前に推奨:
output/reports/fit-check.md が最新- ❌ がない(または利用者が明示的に「許容」を宣言)
物理ループ(印刷後の実測フィードバック)
本スキルは CAD 上の検査であり、ここを通っても実測との差は別途取り込む必要がある。
試作を印刷したら 物理ループ に移る:
/export で STL/3MF を出して印刷- 利用者が組み立て・ノギス計測・操作確認を行う
/review-fix measurements を呼ぶと、.claude/templates/feedback-measurements.yaml が
input/feedback/<date>-measurements.yaml にコピーされる- 利用者が CAD 値 vs 実測値 vs 採用補正を埋める
/review-fix がそれを case-config.yaml に反映 → generator.py 再実行 → 本スキルで再点検
詳細は @.claude/rules/measurement-feedback.md を参照。CAD 検査と物理検査の 両輪で
品質を担保する設計。本体不変原則(P15)・暗黙許容禁止(P16)は物理ループでも適用。
注意事項
- 利用者カスタムの尊重:
fit_check.py を利用者が編集していたら上書きしない。チェック項目の追加は ALLOWLIST / PART_PAIRS / MECHANISMS への追記で対応
- ALLOWLIST の運用: 意図的な重なりは label・max_mm3・理由を併記して登録。「なぜ許容したか」を残す。CAD で解消したら削除し、コメントで履歴を残す
- 基準値はチューニング可能: 推奨値は経験則ベース。プロジェクト特性で見直し可。緩める場合は理由をコメントに残す
- 拡張容易性: 新しい嵌合機構が登場したら
MECHANISMS 辞書に追加するだけで取り込める設計を維持
- 段階 4 と 5 の橋渡し: review-fix では「直近フィードバック反映」、fit-check では「過去事例網羅+CAD 干渉」と役割分離
- 本体固定運用への対応: 印刷時間が長く本体を再印刷したくない場合、本体パラメータを変えずに蓋のみ調整する余地(
lid_knuckle_extra_clearance_z など)を残す
関連
@.claude/skills/review-fix/SKILL.md — 段階 4 + 物理ループ反映@.claude/skills/export/SKILL.md — 段階 5@.claude/skills/hinged-lid/SKILL.md — closure=hinge_lever 時、本スキルの C/F カテゴリに固有チェックを追加する@.claude/quality-gates.md — 5 段階ゲート条件@.claude/pitfalls.md — リリーフカット忘れなどの落とし穴@.claude/rules/measurement-feedback.md — 物理ループの様式@.claude/rules/materials-catalog.md — 材料別 fit_clearance 推奨範囲output/design/validator.py — 単一パーツの設計ルール検証output/design/fit_check.py — このスキルが管理する嵌合チェック実装
