tesseract-3d について
tesseract-3d は、Tesseract CLI で編集可能な 3D シーンを作成・納品する手順を支援するエージェントスキルです。スキーマ確認、段階的な編集、レンダーの検査、独立したレビューを重視します。
主な機能
- 01シーンレシピに基づく 3D 制作
- 02CLI バージョンとスキーマの確認
- 03パストレーシングまたはラスターレンダリング
- 04フィルムストリップによるアニメーション検査
- 05シーン評価とレビューの反復
- 06編集可能なシーンとプレビューの納品
活用シーン
- 01編集可能な 3D シーンの制作
- 02重要な時点でのアニメーション確認
- 03レンダー結果の評価と納品
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ mirage-hq/ tesseract --skill tesseract-3dインストール後、Claude Code で/tesseract-3dを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/ad-hooks.mdaudio-and-timing.mdcli-version.txtcolor-grading.mdcritic-instructions.mdcritic-review.mdcustom-shader.mdeditorial-decisions.mdfilmstrip-review.mdfx-authoring.mdhdr-blend-modes.mdhdr.mdinstall-cli.mdinstallation.mdlocal-operation.mdmedia-import.mdmotion-design.mdmotion.mdnative-authoring.mdreview-and-delivery.mdscene3d-basics.mdscene3d-blender.mdscene3d-properties.mdscene3d-recipes.mdsound-design.mdspeech-cleanup.mdtelemetry.mdwaveform-editing.mdscripts/tesseract_media.py詳細
Tesseractで編集可能な3Dシーンをデザインする
CLIは、一部のコマンドで基本的な使用状況テレメトリーを送信する場合があります。TESSERACT_SKILL=tesseract-3dやその他のアトリビューション変数を使って、任意でアトリビューション情報を提供できます。CLIのテレメトリー無効設定を尊重し、ユーザーに代わってテレメトリーを有効にしないでください。
- このスキルのルートは、この
SKILL.mdがあるディレクトリを基準に解決します。CLI installation を読み、セッションごとに Tesseract の必要なバージョンを一度確認してください。タスク全体を通して、解決した実行ファイルのパスを使用してください。Scene3D には 3D 対応の CLI ビルドが必要です。tsrct project schemaの出力をファイルに保存し、createFxScene3DLayerを検索してください(スキーマ全体を表示してはいけません)。見つからない場合は作業を中止し、この CLI では 3D シーンを作成できないことをユーザーに伝えてください。2D レイヤーで代用したり、操作を再試行したりしてはいけません。local operation と native authoring を読んでください。 - Scene3D basics のバリデーターのルールを含め、内容を読んでください。対応する recipes を出発点にしてください。ユーザーが Blender の用語で作業を説明した場合は、Scene3D for Blender users を使って最も近いコントロールを選び、同等の機能がないものの名称を確認してください。キャンバス、意図するカメラビュー、スケール(
pixelsPerMeter)、タイミングを設定してください。--hdr、HDR 納品、hdrGraphicsWhiteNits、1 を超える RGB 値、または HDR 静止画を扱う場合は、HDR を読んでください。Radiance.hdr環境マップには Scene3D basics だけが必要です。シーンを修正する際は、既存の ID、アニメーション、パッケージ済みリソースを維持してください。 - レンダラーを選択してください。リアルなライティング、反射、屈折にはパストレーサーを優先してください。スタイライズされたグラフィックや、すばやいレイアウト確認、モーション確認にはラスタライザーを使用してください。
- プリレンダリング画像ではなく、編集可能なネイティブアイテムを作成してください。各操作を記述する前に、
tsrct project schemaで正確なフィールドを確認してください。プロパティ名、列挙値の表記、コマンドを推測してはいけません。少量ずつ適用し、バッチが拒否されたらレンダリングせずに停止してください。インポートしたモデルについては、変換診断を読み、poseStackにクリップ、モーフ、ノードオーバーライドを列挙してください(インポートしたモデルを参照)。 - 機能上重要な時点では、フィルムストリップレビューを使用してください。サンプリングしたフレームに目に見える違いがある場合にのみ、アニメーションが検証されたことになります。キーフレームやバインディングが保存されていても、動作の証明にはなりません。構造を編集した後は保存済みの JSON を確認し、納品前にドキュメントを再読み込みしてください。最終的なレンダラーと設定で代表的なフレームを確認し、長時間のエクスポートの前にコストを見積もってください。手順 6 に進む前に、レビューと納品に従い、Scene3D basicsにある該当する
tsrct evaluate --checksのレシピを実行して、対応可能な指摘を修正し、再実行してください。アイテムごとの測定値も必要な場合に限り、scene3d.itemsを使用してください。これだけではチェックは実行されません。 - 批評レビューを読み、指示に従ってください。2 名の独立した批評者、つまりアートディレクターと、シーンの目的に応じた専門家(たとえば製品ショットなら製品ビジュアライゼーションのリード)がレンダリングプレビューを評価し、両者が 8.5/10 以上を付けるまでラウンドの間に修正します。レビューは最大 3 ラウンドです。パストレースのシーンでは、批評者に見せるビューを最終的なレンダラーのフラグでレンダリングし、そのフラグを「Renderer」行に記載してください。レビュー計画、各ラウンドのスコアとフィードバック、最終スコアをユーザーに伝えてください。
- 編集可能な
.tsrctとレンダリング済みプレビューを納品してください。どのレンダリングでパストレーサーを使ったか、その際のフラグも伝えてください。サポートされないコントロール、インポート時の欠落、近似、未検証の出力について、デザインを黙って置き換えるのではなく説明してください。ストレージの説明に従い、チェックポイント、ダンプ、レビューレンダリングは必要最小限にしてください。詳細なシーンでは、完全なコピーを作成するたびに容量が大きくなります。
コメント
Markdown 対応