mcpField
T
tesseract-3d

tesseract-3d

github.com/mirage-hqクリエイティブ・メディア304715 回インストール2 日前に更新
リポジトリ

tesseract-3d について

tesseract-3d は、Tesseract CLI で編集可能な 3D シーンを作成・納品する手順を支援するエージェントスキルです。スキーマ確認、段階的な編集、レンダーの検査、独立したレビューを重視します。

主な機能

  1. 01シーンレシピに基づく 3D 制作
  2. 02CLI バージョンとスキーマの確認
  3. 03パストレーシングまたはラスターレンダリング
  4. 04フィルムストリップによるアニメーション検査
  5. 05シーン評価とレビューの反復
  6. 06編集可能なシーンとプレビューの納品

活用シーン

  1. 01編集可能な 3D シーンの制作
  2. 02重要な時点でのアニメーション確認
  3. 03レンダー結果の評価と納品

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mirage-hq/tesseract --skill tesseract-3d

インストール後、Claude Code で/tesseract-3dを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
ad-hooks.md
audio-and-timing.md
cli-version.txt
color-grading.md
critic-instructions.md
critic-review.md
custom-shader.md
editorial-decisions.md
filmstrip-review.md
fx-authoring.md
hdr-blend-modes.md
hdr.md
install-cli.md
installation.md
local-operation.md
media-import.md
motion-design.md
motion.md
native-authoring.md
review-and-delivery.md
scene3d-basics.md
scene3d-blender.md
scene3d-properties.md
scene3d-recipes.md
sound-design.md
speech-cleanup.md
telemetry.md
waveform-editing.md
scripts/
tesseract_media.py

詳細

Tesseractで編集可能な3Dシーンをデザインする

CLIは、一部のコマンドで基本的な使用状況テレメトリーを送信する場合があります。TESSERACT_SKILL=tesseract-3dやその他のアトリビューション変数を使って、任意でアトリビューション情報を提供できます。CLIのテレメトリー無効設定を尊重し、ユーザーに代わってテレメトリーを有効にしないでください。

  1. このスキルのルートは、この SKILL.md があるディレクトリを基準に解決します。CLI installation を読み、セッションごとに Tesseract の必要なバージョンを一度確認してください。タスク全体を通して、解決した実行ファイルのパスを使用してください。Scene3D には 3D 対応の CLI ビルドが必要です。tsrct project schema の出力をファイルに保存し、createFxScene3DLayer を検索してください(スキーマ全体を表示してはいけません)。見つからない場合は作業を中止し、この CLI では 3D シーンを作成できないことをユーザーに伝えてください。2D レイヤーで代用したり、操作を再試行したりしてはいけません。local operation と native authoring を読んでください。
  2. Scene3D basics のバリデーターのルールを含め、内容を読んでください。対応する recipes を出発点にしてください。ユーザーが Blender の用語で作業を説明した場合は、Scene3D for Blender users を使って最も近いコントロールを選び、同等の機能がないものの名称を確認してください。キャンバス、意図するカメラビュー、スケール(pixelsPerMeter)、タイミングを設定してください。--hdr、HDR 納品、hdrGraphicsWhiteNits、1 を超える RGB 値、または HDR 静止画を扱う場合は、HDR を読んでください。Radiance .hdr 環境マップには Scene3D basics だけが必要です。シーンを修正する際は、既存の ID、アニメーション、パッケージ済みリソースを維持してください。
  3. レンダラーを選択してください。リアルなライティング、反射、屈折にはパストレーサーを優先してください。スタイライズされたグラフィックや、すばやいレイアウト確認、モーション確認にはラスタライザーを使用してください。
  4. プリレンダリング画像ではなく、編集可能なネイティブアイテムを作成してください。各操作を記述する前に、tsrct project schema で正確なフィールドを確認してください。プロパティ名、列挙値の表記、コマンドを推測してはいけません。少量ずつ適用し、バッチが拒否されたらレンダリングせずに停止してください。インポートしたモデルについては、変換診断を読み、poseStack にクリップ、モーフ、ノードオーバーライドを列挙してください(インポートしたモデルを参照)。
  5. 機能上重要な時点では、フィルムストリップレビューを使用してください。サンプリングしたフレームに目に見える違いがある場合にのみ、アニメーションが検証されたことになります。キーフレームやバインディングが保存されていても、動作の証明にはなりません。構造を編集した後は保存済みの JSON を確認し、納品前にドキュメントを再読み込みしてください。最終的なレンダラーと設定で代表的なフレームを確認し、長時間のエクスポートの前にコストを見積もってください。手順 6 に進む前に、レビューと納品に従い、Scene3D basicsにある該当する tsrct evaluate --checks のレシピを実行して、対応可能な指摘を修正し、再実行してください。アイテムごとの測定値も必要な場合に限り、scene3d.items を使用してください。これだけではチェックは実行されません。
  6. 批評レビューを読み、指示に従ってください。2 名の独立した批評者、つまりアートディレクターと、シーンの目的に応じた専門家(たとえば製品ショットなら製品ビジュアライゼーションのリード)がレンダリングプレビューを評価し、両者が 8.5/10 以上を付けるまでラウンドの間に修正します。レビューは最大 3 ラウンドです。パストレースのシーンでは、批評者に見せるビューを最終的なレンダラーのフラグでレンダリングし、そのフラグを「Renderer」行に記載してください。レビュー計画、各ラウンドのスコアとフィードバック、最終スコアをユーザーに伝えてください。
  7. 編集可能な .tsrct とレンダリング済みプレビューを納品してください。どのレンダリングでパストレーサーを使ったか、その際のフラグも伝えてください。サポートされないコントロール、インポート時の欠落、近似、未検証の出力について、デザインを黙って置き換えるのではなく説明してください。ストレージの説明に従い、チェックポイント、ダンプ、レビューレンダリングは必要最小限にしてください。詳細なシーンでは、完全なコピーを作成するたびに容量が大きくなります。

コメント