threejs-visual-validation について
描画結果を一枚の完成画像だけでなく、その生成メカニズムから検証するスキルです。再現可能な入力、診断画像、カメラとシードのテスト、時間的安定性、予算、回帰検証の証拠を定めます。
主な機能
- 01決定論的な入力の固定
- 02ベースラインと診断画像の必須化
- 03カメラ範囲とシード変動のテスト
- 04動きと時間的安定性の確認
- 05画像と性能予算の記録
- 06視覚回帰の証拠管理
活用シーン
- 01プロシージャルグラフィックスの変更検証
- 02完成画像で隠れた不具合の発見
- 03シードやカメラ距離別の効果テスト
- 04時間的アーティファクトと描画予算の追跡
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ scottstts/ threejs-awesome-graphics-agent-skills --skill threejs-visual-validationインストール後、Claude Code で/threejs-visual-validationを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yamlreferences/graphics-validation-protocol.md
詳細
ビジュアル検証
画像を生成する仕組みを評価します。美しいヒーロースクリーンショットの陰に、不安定なフィールド、破綻した奥行き、シードの失敗、後処理への依存が隠れていることがあります。
検証手順
- 決定論的な入力を固定します。
- 後処理なしのベースラインをキャプチャします。
- システム固有の診断ビューをキャプチャします。
- 想定するカメラ距離の範囲をテストします。
- 代表的なシードとパラメーターの極端な値をスイープします。
- モーションと時間的安定性をテストします。
- 画像、ジオメトリ、メモリ、タイミングの予算を記録します。
- ビジュアル不変条件に基づく小規模なリグレッションセットを維持します。
ビジュアル契約、必須の検査コントロール、仕組み固有の エビデンス、時間的なチェック、予算、明確な却下基準については、 references/graphics-validation-protocol.mdを参照してください。
必須エビデンス
- 固定カメラとシードのマニフェスト;
- 最終画像と後処理なしのキャプチャ;
- フィールド/パスの診断モザイク;
- 近距離、設計距離、遠距離のカメラビュー;
- 少なくとも1つのストレスシード;
- フレーム時間とレンダーターゲットの一覧;
- 明文化された不変条件と既知の妥協点。
失敗条件
- 1つのフレームだけを根拠に承認する;
- パスごとに後処理を無効化できない;
- ランダムシードを再現できない;
- GPU時間をCPUフレーム時間だけから推定する;
- 時間的なアーティファクトを静止画像で評価する;
- 意図的な確率的ピクセルを安定化しないまま、比較しきい値から除外する。
適用範囲の境界
このスキルは実装を評価するものであり、実装の仕組みは提供しません。まず対象または画像効果のスキルを読み込み、その後、このプロトコルを使って結果が許容できるか判断してください。
コメント
Markdown 対応