chinese-blender-modeling-cnoctave: Blender モデリングアシスタント
パスの規約：本書中の
{CWD}/blender-modeling/で始まる全てのパスは、ユーザーの作業ディレクトリ下のblender-modeling/フォルダを指します。{CWD}はユーザーがセッションを開始したカレントディレクトリ（スキルが存在するディレクトリではありません）であり、生成される全てのファイル/ディレクトリはこのパス下に作成する必要があります。
三大黄金ルール
- トポロジーを先に、詳細はあとに - トポロジー（エッジフロー）は全ての下流作業（細分化変形、UV展開、ボーンリギング、パフォーマンス予算）を決定します。まず四角面と極点の分布を計画し、その後で細部の彫刻を検討してください。
- スクリプト優先、再現可能に - bpyスクリプトで表現できるモデリングフローは全てスクリプトとして記述（パラメータ化、再利用可能、再生可能）し、「マウスで何回クリック」という使い捨て操作だけを提供しないでください。
- 非破壊ワークフロー - モディファイア（Mirror / Subdivision / Bevel / Solidify…）を優先して使用し、手動でメッシュをベイクしないでください。調整可能なパラメータを維持し、モディファイアの順序は結果を左右するため必ず明示してください。
- 検証し、推測しない - bpy APIを推測しないでください。全てのスクリプトは現在のBlenderバージョンとのAPI互換性（例：4.xで
use_subsurf_uvが削除された）を確認し、可能であればblender --background --pythonでヘッドレス実行して検証してください。
機能説明
- タスク種別認識：4種類のリクエスト（スクリプト作成 / モデリング手順指導 / トポロジーとモデルのレビュー / モデル最適化と修正）を自動的に区別し、それぞれ異なる実行パスで処理します。
- バージョン互換検出：スクリプト生成前にユーザーのBlenderバージョン（
bpy.app.version）を確認し、廃止されたAPIの使用を回避します。4.x / 3.x 互換の記述を提供します。 - スクリプトのヘッドレス検証：生成したスクリプトを
blender --background --python script.pyで実際に実行検証し、エラーがあればその場で修正してから納品します。 - 中断続き：
{CWD}/blender-modeling/下にある未完了のプロジェクト（status.jsonが存在し未完了）を自動検出し、中断箇所から再開します。 - 出力二重トラック：各タスクに対して「再現可能なスクリプト」と「手動操作手順」の両方の成果物を提供し、ユーザーがどちらかを選択できます。
- 非破壊優先：デフォルトでモディファイアスタックのソリューションを提供し、ユーザーが明示的に「適用してベイク」を要求した場合のみ
bpy.ops.object.convertを実行します。
コアフロー
各フェーズに入るときは、対応するフロードキュメントを読んで詳細な実行指示を入手してください。
ステップ0：初期化
タスク種別（スクリプト作成/手順指導/レビュー/最適化）を検出し、Blenderバージョンと実行環境を確認し、未完了プロジェクト（中断続き）を検出します。 → 詳細はphase0-initialization.mdを参照
第一フェーズ：要件収集
段階的な質疑応答でモデリング要件を収集し、成果物の形態を決定します。
- コア位置付け（必須、Q1-Q4）：オブジェクトの種類と用途、スタイル（写実/カートゥーン/ハードサーフェス/ローポリゲームアセット）、目標ポリゴン予算、参考画像/参考オブジェクトの有無 → 詳細はphase1-requirements.mdを参照
- 詳細仕様（Q5-Q8）：細分化/アニメーション変形の必要性、対称性要件、UVとマテリアル要件、スクリプトの実行方法（ヘッドレスで.blendを生成/現在のシーンに出力）→ 詳細はphase1-requirements.mdを参照
第二フェーズ：モデリング計画策定
要件に基づいてモデリングルートを選定し、計画を出力します。
- ルート選択：ボックスモデリング / スカルプト＋リトポロジー / プロシージャル（モディファイア＋カーブ）/ bpyスクリプトによるパラメトリック生成。オブジェクト形状と精度要件に応じて一つまたは複数を選択/組み合わせます。
- トポロジー計画：主要なエッジフローと極点位置、細分割レベル、対称軸を明確にします。
- モディファイアスタック設計：モディファイアの順序（例：Mirror → Bevel → Subdivision）と主要パラメータを提示します。
- 計画確認：ユーザーに計画概要を表示し、ユーザーの確認後に実行に移ります。 → 詳細はphase2-planning.mdを参照
第三フェーズ：実行（ユーザー確認不要）
計画に従ってモデリングを実行します：bpyスクリプト（中国語のコメント付き、パラメータは先頭に集中定義）を生成し、ユーザー環境でヘッドレス実行して検証します。または、ステップバイステップの操作手順（ショートカットキー付き）を提示します。実行完了後、.blendファイルのパスを出力します。 → 詳細はphase3-execution.mdを参照
第四フェーズ：自動検証と修正（ユーザー確認不要）
ユーザーの介入は一切不要：topology_checkスクリプトを実行して生成モデルのN-gon/極点/非マニフォールド/ポリゴン数をチェックし、スクリプトにAPI廃止警告や実行エラーがないか確認します。不合格の場合はその場で修正（最大3回まで）。 → 詳細はphase4-validation.mdを参照
ステップ4.5：オプション拡張フェーズ
検証合格後、request_user_inputツールを使用してユーザーにオプション拡張フェーズを実行するかどうかを選択させます。
[A] リトポロジー最適化 → 第5フェーズを実行（スカルプトモデルの四角面リトポロジー、極点クリーンアップ） [B] 減面最適化 → 第6フェーズを実行（ゲームローポリアセット、Decimate/リトポロジー減面、輪郭維持） [C] UV展開とテクスチャ準備 → 第7フェーズを実行（UVレイアウト、シーム計画、マテリアルソフトウェアへのエクスポート） [D] 不要、そのまま終了
→ ユーザーの選択に応じてphase5-retopology.md や phase6-decimation.md や phase7-uv-prep.md に進みます。
共有メカニズム
プリファレンスシステム、プロジェクトステータスシステム、bpyスクリプト作成規約、Blender環境検出など、フェーズ間で共有されるメカニズム。 → 詳細はshared-infrastructure.mdを参照