fit-repair-optimizer について
fit-repair-optimizerは、3Dモデルの検証失敗後に修正を計画するスキルです。依存関係、編集範囲、合格条件を含む順序付きキューに検証結果を整理します。
主な機能
- 01段階に沿った修正順序の設定
- 02並列実行できる作業の判定
- 03複数ビューのテンプレート競合の確認
- 04キュー項目と合格条件の定義
- 05再発時のスキル改善への振り分け
活用シーン
- 01検証失敗を修正キューに変換
- 02形状、UV、マテリアル修正の調整
- 03ビュー間のテンプレート競合への対応
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ roble3/ cc-blender-skill --skill fit-repair-optimizerインストール後、Claude Code で/fit-repair-optimizerを入力して読み込まれたか確認します。
同梱ファイルscripts/fit_repair_queue.py
詳細
フィット修復オプティマイザー
このスキルは、検証の失敗を実行可能な修復キューに変換します。ソーステンプレートが基準であり、現在のモデルは破棄可能です。
判断:順次処理か並列処理か?
失敗が連動している場合は、順次修復を使用します。
- 基準となるビュー/ソースの矛盾が未解決である。
- 正面シルエットまたはパーツ数が不合格である。
- UV を信頼できる段階に進む前に、ジオメトリの寸法が不合格である。
- テクスチャ領域の境界がジオメトリの変更に依存する。
- ライティング/見た目が最終的なマテリアル配置に依存する。
書き込み範囲が重複しない独立した作業に限り、並列修復を使用します。
- ジオメトリのレシピ/配置の調整;
- アトラス領域の分類;
- マテリアル/見た目の調整;
- 検証ツールの改善。
同じ Blender レシピ、オブジェクトのトランスフォーム、または UV 割り当てファイルを編集するタスクを並列化してはいけません。
必須の修復順序
0 source-conflict / multiview-rigidity gate
1 structural part count
2 front silhouette and landmarks
3 side/back/top depth and projection
4 UV/texture region fit
5 material/light/look calibration
6 export and final validation
前段階が失敗した場合、後続段階の分析は可能ですが、確定してはいけません。
ソース矛盾ゲート
修復の前に、multiview-constraint-solver を使用して、テンプレート同士が相互に整合するかを確認します。同じ物理軸に対してビュー間で互換性のない比率が指定されている場合は、矛盾レポートを作成し、次のいずれかの基準方針を要求します。
- 正面+側面を基準とする;
- 正面+上面を基準とする;
- テンプレートシートを修正する;
- ビュー別の簡易レンダリングのみとし、剛体の 3D モデルは作成しない。
修復キューのスキーマ
各修復項目には次の内容を含める必要があります。
idstageview_scopefailuremeasured_deltaproposed_actionwrite_scopeparallel_groupblocked_byacceptance_gate
スキル不足のルール
同じ失敗が 2 回繰り返された場合は、再ビルドの前に作業を停止し、quality-refinement-autoloop を実行します。オートループでは、証拠を収集し、不足している手法を診断し、教訓を汎用的で公開可能なガイダンスに整え、該当するスキルを修正し、スキルスタックを検証してから、新しい修復キューを作成してここに戻る必要があります。一般的な振り分け先は次のとおりです。
- ジオメトリの不一致 →
contour-to-mesh、orthographic-registration、またはこのスキル; - UV/テクスチャの不一致 →
atlas-uv-fitting; - ライティングの不一致 →
blender-lightingまたは見た目調整スキルに、見た目の調整方法に関するガイダンスを追加する; - 検証の不一致 →
multiview-fit-loop/reference-analysis-validator。
出力
ALIGNMENT_REPAIR_QUEUE.json などのプロジェクト修復計画と、人が読める形式の ALIGNMENT_REPAIR_METHOD.md を作成します。