blender-workflow について
blender-workflowは、PythonでBlenderのシーンを作成・編集するためのスキルです。再実行可能なスクリプト、参考資料に基づくモデリング、レンダー画像や出力ファイルの検証を扱います。
主な機能
- 01大きな変更前の参考資料調査
- 02再実行可能なBlender Pythonスクリプト
- 03シーンデータとレンダーの検証
- 04製造・リグ・アニメーションの確認
- 05プロジェクト出力の保存と検証
活用シーン
- 01視覚資料を基にした新規モデルの作成
- 02既存内容を保ったシーンの編集
- 03製造向け出力前のモデル確認
- 04アニメーションのリグや動きの確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ jord-jd/ jord-skills --skill blender-workflowインストール後、Claude Code で/blender-workflowを入力して読み込まれたか確認します。
詳細
Blender のワークフロー
メインのインターフェースとして Blender Python を使用します。大規模な作業は再実行可能なスクリプトにまとめ、既存のシーン内容とユーザーが選んだスタイルを維持します。
対象を調べる
新しいモデルやシーンの制作、または形状、マテリアル、ライティング、構図への大幅な変更に着手する前に、関連する独立した2つ以上の情報源から参考資料を探し、実際に目で確認します。検索結果の抜粋やページの説明ではなく、実際の画像、レンダー、動画のフレームを調べます。シルエットと構造、マテリアルの見え方、プロポーション、構図、動きなど、その作業で解決すべき疑問に答えられる資料を選びます。1つの視点では形状が曖昧な場合は、複数の角度から確認します。
モデリングの前に、情報源と観察した内容を簡潔に記録します。役立つ原則を取り入れつつ、独自性のあるデザインを模倣したり、依頼内容を無視したりしないでください。提供された資料も参考資料として扱い、この作業で確認済みの根拠は再利用してください。小規模な修正や機械的なエクスポートでは、新しいムードボードではなく、関連する既存の資料と確認だけで十分です。資料を視覚的に確認できない場合は、別の方法を試し、それでも確認できない点があれば明らかにします。
API やワークフローが不明な場合は、インストールされている Blender のバージョンに対応する公式 Blender マニュアルまたは Python API ドキュメントを確認します。コンテキストの要件を推測したり、別のバージョン向けの例がそのまま動作すると決めつけたりしないでください。
Python で構築する
通常はバックグラウンドモードで、プロジェクトの実際の Blender 実行ファイルを使用します。
blender scene.blend --background --python-exit-code 1 --python scripts/change_scene.py
新しいシーンでは、開始状態を明示してクリーンな状態にします。既存のプロジェクトでは、まず内容を確認し、関係のないオブジェクトを維持します。大規模な自動化処理はリポジトリ内にまとめ、出力と失敗を記録し、目的の .blend を明示的に保存します。価値のある元データを破壊的に変更する前に、チェックポイントを作成します。
コンテキストに依存するオペレーターよりも、bpy のデータ API、bmesh、mathutils を優先します。bpy.ops を使う場合は、必要なアクティブオブジェクト、選択状態、モード、その他のコンテキストを明示的に設定します。バックグラウンドモードでインタラクティブなビューポートが存在することを前提にしないでください。Blender API の処理はメインスレッドで行います。
安定したオブジェクト名、明示的な単位とパラメーターを使い、意図しない重複を避ける再現可能な操作を行います。トランスフォームとワールド空間での寸法を考慮します。必要に応じて、非破壊のモディファイアーを使用します。確認や扱いにくい操作には、稼働中の Blender ツールや GUI 操作が役立つ場合があります。大規模な変更は、スクリプトで再現可能な状態に保ちます。
Blender が利用できない場合は、プロジェクトに記載されたインストール方法を確認します。実行していないコードを、検証済みのシーンとして提示しないでください。
検査と納品
Blender で自動化を実行し、シーンデータとレンダリング画像の両方を確認してください。スクリプトが正常に実行されたというだけでは、見た目や構造の正しさは証明されません。
重要な項目を確認してください。寸法とトランスフォーム、オブジェクトとコレクションの状態、マテリアル、モディファイアー、依存関係の欠落、クリアランスなどです。問題が起きやすい箇所が見える視点から、低コストのプレビューをレンダリングしてください。画像を実際に開き、シルエット、プロポーション、交差、パーツの浮き、シェーディング、ライティング、フレーミングを確認してください。目に見える不具合を修正し、最終レンダリングの前に新しいレンダリングを確認してください。小さな編集には対象を絞った確認を行い、複雑なオブジェクトには透視図、正投影図、ディテールビューが必要になる場合があります。
製作物の場合は、単位、壁の厚さ、嵌合クリアランス、分離したジオメトリ、非多様体エッジまたは開いたエッジ、法線を確認してください。エクスポートのスケールを検証してください。見栄えの良いレンダリングでも、物理的な正しさが保証されるわけではありません。
リグとアニメーションの場合は、フレーム範囲、親子関係、ボーン、コンストレイント、変形、交差を確認してください。動きが重要な場合は、代表的なポーズと遷移、または短いシーケンスを確認してください。可能であれば、対象のランタイムでエクスポートしたアニメーションを検証してください。
保存した .blend と、指定されたエクスポートファイルが存在することを確認してください。可能であれば、エクスポートを再インポートするか、独立して検査し、必要に応じてスケール、マテリアル、ジオメトリ、アニメーションを確認してください。指定された出力とともに、編集可能なソースとスクリプトを納品し、確認した項目と残っている制約を簡潔に説明してください。