quality-refinement-autoloop

品質改善オートループ

ユーザーから、結果が正しくない、見栄えが悪い、位置が合っていない、テクスチャがない、アニメーションされていない、エクスポートできない、あるいは期待を下回ると指摘された場合に使用します。目的は、やみくもに調整を続けることではありません。再試行する前に、失敗を再利用可能で汎用的なスキル改善につなげることが目的です。

オートループの各フェーズ

0. 凍結して保持する

• すぐにプロダクトへの変更を停止します。
• 最後に承認されたベースラインと、失敗した成果物を保持します。
• 失敗したブランチ／バージョンには正確な名前を付け、承認済みの出力を上書きしないでください。

1. 証拠を収集する

失敗を裏付ける最小限の証拠一式を収集します。

• ユーザーからのフィードバックの引用または要約；
• 使用したソース／参照ファイル；
• 現在の出力パス／バージョン；
• 関連するレンダー／コンタクトシート／オーバーレイ／監査レポート；
• 失敗が Blender 内部で発生した場合は、シーン／マテリアル／オブジェクトの一覧。

2. 失敗の要因を診断する

主な問題を分類します。

• ジオメトリ／シルエット／ランドマーク；
• マルチビュー／奥行きの一貫性；
• UV／アトラス／テクスチャの適合性；
• 表面全体のカバー範囲（前面／背面／側面）；
• 外観／マテリアル／ライティングの調整；
• アニメーション／モーション／エクスポートの実態；
• オーケストレーション／スキル間の引き継ぎ；
• バリデーターまたは決定論的なヘルパースクリプトの不足。

3. スキルギャップを判断する

現在のスキルスタックに、この失敗に対する汎用的な方法がすでに含まれているか確認します。

• 含まれている場合：既存のスキルを実行し、成果物を修正します。
• 含まれていない場合：まず汎用スキルを追加／改良してから、修正します。
• スキル同士の連携が原因で失敗が繰り返される場合：末端のスキルだけでなく、ハーモナイザー／引き継ぎルールを更新します。

4. 教訓をサニタイズする

スキルの変更を記述する前に、以下を行います。

• プロジェクト／クライアント／アセットの名前を削除します；
• シークレット、未加工のログ、非公開のパス、個人情報、著作権で保護されたソース内容を削除します；
• 再利用可能な方法、ゲート、スクリプト、失敗パターンだけを残します；
• 入力／出力は汎用的に記述します；
• 壊れやすい監査には、決定論的なスクリプトを優先します。

5. スキルスタックにパッチを適用する

公開可能な最小限の変更を適用します。

• 簡潔なスキルを1つ、または既存のスキル内に簡潔なセクションを1つ追加します；
• 検証を繰り返し実行する場合は、任意でヘルパースクリプトを追加します；
• 順序／引き継ぎが変更された場合は、ハーモナイザーを更新します；
• マニフェストのエントリー／バージョンを更新します。

6. スキルの変更を検証する

必須チェック：

• スクリプトがコンパイルできること；
• マニフェストのパスが存在すること；
• ハーモナイザーが存在する状態で、スキルグラフの監査に合格すること；
• サニタイザーのスキャンでプロジェクト固有の用語が検出されないこと；
• 該当する場合は、新しいヘルパーを失敗した成果物に対して実行し、レポートを保存すること。

7. スキルのゲートを通過してからプロダクトを修正する

改善したスキルを使い、正しいベースラインから再構築または修正します。却下された出力は、ソース証拠として明示的に指定されていない限り、再利用しないでください。

8. 要求された場合にリリース準備を行う

ユーザーから公開／コミット／プッシュを依頼された場合に限り、以下を行います。

1. 最新のリモートを取得し、ローカルブランチが最新であることを確認します；
2. ステージングする前に、コンフリクトを解決／調整します；
3. 変更範囲に適したセマンティックバージョニングに基づいて、バージョンを上げます；
4. 該当する場合は、README／プラグインのREADME／CHANGELOG／VERSIONINGを更新します；
5. サニタイザーとコンパイル／監査チェックを実行します；
6. 設定済みのリモートを使用して、ステージング、コミット、プッシュを行います。

厳守事項

• 公開スキルにタスク固有の例を組み込まないでください。
• 実際のメッシュ表面がカバレッジのゲートに合格していない限り、オーバーレイの曲線／平面を「テクスチャカバレッジ」と呼ばないでください。
• ジオメトリやUVの問題を隠すために、ライティング／マテリアルを調整しないでください。
• エフェクトが Blender Python 内、またはレンダーシーケンス内にしか存在しない場合は、エクスポートに対応していると主張しないでください。
• ユーザーから明示的な依頼がなく、最新のリモート確認も済んでいない状態でプッシュしないでください。

推奨される成果物

このループの実行時には、プロジェクトの出力先の近くに以下を保存します。

• RALPH_OR_QUALITY_LOOP_REPORT.md
• failure_evidence/、または既存のレンダー／レポートへの参照
• skill_gap_decision.json
• sanitization_report.json
• validation_report.json

スクリプト

• scripts/ralph_autoloop_plan.py は、フィードバックや成果物のヒントから、汎用的な失敗分類とループ計画を作成します。
• scripts/sanitize_skill_contributions.py は、公開前にスキルファイルをスキャンし、プロジェクト固有または非公開の用語が含まれていないか確認します。
• scripts/release_readiness_check.py は、コミット／プッシュ前に、マニフェスト、ドキュメント、バージョン、パスを簡易チェックします。