全体調整

CA-Tatami · CA-Tatami · commit 247556b93bc6 · 2025-10-22T12:32:42.000+09:00
diff --git a/Documentation/handover/HANDOVER.md b/Documentation/handover/HANDOVER.md
@@ -1,17 +1,5 @@
 # NOVA Shader プロジェクト引き継ぎ資料
 
-## 目次
-
-1. [プロジェクト概要](#1-プロジェクト概要)
-2. [アーキテクチャ](#2-アーキテクチャ)
-3. [開発ワークフロー](#3-開発ワークフロー)
-4. [AI開発戦略](#4-ai開発戦略)
-5. [技術詳細](#5-技術詳細)
-6. [運用・保守](#6-運用保守)
-7. [連絡先とリソース](#7-連絡先とリソース)
-8. [既知の課題と今後の展望](#8-既知の課題と今後の展望)
-9. [FAQ](#9-faq)
-
 ---
 
 ## 1. プロジェクト概要
@@ -29,7 +17,7 @@ MIT LicenseでOSSとして公開することで不具合など品質改善が図
 - **レンダーパイプライン**: Universal Render Pipeline (URP)
 - **Shader Model**: 3.5以上
   - Mesh GPU Instancing使用時はShader Model 4.5以上が必要
-  - Mirror Sampling使用時はInline Sampler States対応が必要
+  - Mirror Sampling使用時はInline Sampler States対応が必要(PowerVR等一部環境で非対応)
 
 **配布方法:**
 - **GitHub**: https://github.com/CyberAgentGameEntertainment/NovaShader
@@ -48,7 +36,7 @@ MIT LicenseでOSSとして公開することで不具合など品質改善が図
 以降コアテクのGFX班が管理し、清原さん、チャンさん、畳が開発・保守を行っています(矢野さんは開発には関与せず窓口的な立ち位置に)。
 2025年10月時点では畳が管理人をしており、後述するチャンネルで相談対応やリリースの発信を行っています。
 
-- CGWORLD記事「サイバーエージェントがOSSで公開した多機能シェーダ「NOVA Shader」はいかにして開発されたのか？ 開発者とエフェクトアーティストらが語る」:https://cgworld.jp/article/202206-nova-shader.html
+- [サイバーエージェントがOSSで公開した多機能シェーダ「NOVA Shader」はいかにして開発されたのか？ 開発者とエフェクトアーティストらが語る](https://cgworld.jp/article/202206-nova-shader.html)
 
 ---
 
@@ -89,32 +77,24 @@ uGUI上でパーティクルを表示するためのシェーダー。Custom Coo
 - **ParticlesUber.hlsl**: Uber共通のプロパティ定義とマクロ
 - **ParticlesInstancing.hlsl**: GPU Instancing対応（DefaultParticleInstanceData構造体）
 
-**階層構造**: .shader → ParticlesUber.hlsl（共通定義）→ Particles.hlsl（共通関数）→ ParticlesInstancing.hlsl（GPU Instancing）→ 各Pass用HLSL
-
-### 2.3 エディターシステム
-
-- **Material GUI**: マテリアルインスペクターUI（ParticlesUberCommonGUI、各種GUI継承構造）
-- **Material Post Processor**: マテリアル保存時にシェーダーキーワード自動設定（RenderQueue、ZWrite等）
-- **Renderer Error Handler**: Custom Vertex Streams検証と自動修正（Fix Nowボタン）
-- **Optimized Shader Generator**: メモリ使用量削減のための最適化シェーダー生成
+### 2.3 主要機能システム
 
-### 2.4 主要機能システム
-
-#### 2.4.1 Custom Coord System
+#### 2.3.1 Custom Coord
 統一的にパラメータをアニメーション可能にするシステム。GPU Instancing対応。詳細は [5.2 Custom Coord System詳細](#52-custom-coord-system詳細) を参照。
 
-#### 2.4.2 Random Row Selection
-Unity標準のTexture Sheet Animation Row Mode > Random機能の代替実装。Custom Coordシステムを活用し、任意のCustom Coordチャンネルで使用可能。詳細は`documentation/RandomRowSelection_Specification.md`を参照。
-
-#### 2.4.3 GPU Instancing
-Shader Model 4.5以上でMesh GPU Instancingを使用可能。DefaultParticleInstanceData構造体でtransform、color、customCoord1/2を効率的に転送。
+#### 2.3.2 Optimized Shader Generator
+メモリ使用量削減のため、不要な機能を除外した最適化シェーダーを生成。
 
-#### 2.4.4 UIParticles制約システム
-Unity UIのUIVertex構造の制限により、Custom Coord z/wコンポーネントが使用不可。UICustomCoord enumでCoord1.x/y、Coord2.x/yのみ対応。詳細は`documentation/UIParticles_Limitations.md`を参照。
+その他技術的な特徴や実装背景については以下の記事を参照してください。
+- [Unity用エフェクトシェーダ「NOVA Shader」のOSS化事例と技術的特徴](https://developers.cyberagent.co.jp/blog/archives/35148/)
+- [【Nova Shader 2.4.0】 uGUIでの再生に対応](https://blog.sge-coretech.com/entry/2024/10/18/155432)
+- [エディタバージョンの互換性を保ちつつRenderGraphに対応する【NOVA Shader】](https://blog.sge-coretech.com/entry/2024/10/18/155432)
+- [Adaptive Probe Volumesを自作シェーダーに対応させる【NOVA Shader】](https://blog.sge-coretech.com/entry/2025/05/12/113927)
+- [マテリアルから不要なパラメータを削除する【Nova Shader】](https://blog.sge-coretech.com/entry/2025/05/26/113157)
 
-### 2.5 ドキュメント体系
+### 2.4 ドキュメント体系
 
-#### 2.5.1 ユーザー向けドキュメント
+#### 2.4.1 ユーザー向けドキュメント
 | ファイル | 言語 | 内容 |
 |---------|------|------|
 | `README.md` | 英語 | プロジェクト概要、インストール、使い方 |
@@ -123,7 +103,7 @@ Unity UIのUIVertex構造の制限により、Custom Coord z/wコンポーネン
 | `Assets/Samples/README_JA.md` | 日本語 | 同上（日本語版） |
 | `Assets/Demo/README.md` | 英語 | デモの説明 |
 
-#### 2.5.2 AI開発支援
+#### 2.4.2 AI開発支援
 AI（Claude Code）による開発支援を最大限受けられるよう、NOVAでは技術仕様書を用意しています。
 Custom CoordやTEXCOORDの割り当てといった複雑な設計についてAIに理解させるのに手間がかかるという背景が理由です。
 現状効果があるように感じていますが、まだ満足のいく状態ではないため模索していくのがよいでしょう。
@@ -158,7 +138,7 @@ Custom CoordやTEXCOORDの割り当てといった複雑な設計についてAI
 `README.md`（英語）と`README_JA.md`（日本語）それぞれに対し、常に最新状態にする。目次はGitHub Actions（`toc.yml`）で自動生成。
 
 ### 3.3 ビルド・テストプロセス
-必ずUnity Test Runnerを回してからPRを出す。
+必ずUnity Test Runnerを回してからPRを出す。Optimized Shader Generatorへの対応作業が漏れがちなので注意。
 - **Edit Mode**（`Assets/Tests/Editor/`）: マテリアル内の不要パラメータ削除機能
 - **Play Mode**（`Assets/Tests/Runtime/`）: Average Test（画像比較）、最適化シェーダー機能
 
@@ -181,96 +161,3 @@ Semantic Versioning（`major.minor.patch`）: major=破壊的変更、minor=新
 
 ---
 
-## 8. 既知の課題と今後の展望
-
-### 8.1 既知の制限事項
-
-#### 8.1.1 UIParticles制約
-UIParticlesではCustom Coord z/wコンポーネントが使用不可（Unity UIのUIVertex構造の制限）。回避策として.xyコンポーネントのみ使用するか、標準Particlesシェーダーへ切り替え。
-
-**詳細**: `documentation/UIParticles_Limitations.md`
-
-#### 8.1.2 GPU Instancing使用時のエディタープレビュー問題
-Unity Editorでプレビュー表示時、GPU Instancing有効で正常に描画されない（Unity側のバグ）。Play Mode では正常動作。Unity Issue Tracker に該当Issue存在。
-
-#### 8.1.3 TEXCOORD制限
-Forward PassでTEXCOORD14まで使用（上限15）。新機能追加時のスロット不足の可能性あり。対応策としてデータパッキング、GPU Instancing活用、Pass別最適化を検討。
-
-**詳細**: `documentation/TEXCOORD_Usage_Strategy.md`
-
-#### 8.1.4 Shader Variant管理
-機能追加でバリアント数増加傾向。`shader_feature_local`の積極使用、Optimized Shader Generator活用、未使用機能削除で対応。
-
-### 8.2 技術的負債
-
-#### 8.2.1 コードベース
-- **Material Post Processor**: 機能追加で肥大化、条件分岐複雑化 → 機能別モジュール化、リファクタリングが必要
-- **エディターGUI**: Unlit/Lit/UIParticlesで類似コード重複 → 共通基底クラス抽出が必要
-
-#### 8.2.2 ドキュメント
-- **日英同期**: README.md/README_JA.mdの内容差異 → 更新チェックリスト化、CI/CD自動チェック
-- **サンプル不足**: 全機能網羅するサンプルが不足 → 機能別・ユースケース別サンプル追加
-
-### 8.3 パフォーマンス改善余地
-
-- **シェーダーコンパイル時間**: 初回インポート時に長時間（特にLit版） → `shader_feature_local`活用、バリアント削減
-- **エディターGUI**: Material Inspector描画が重い → 遅延描画、キャッシング強化
-- **モバイル**: 最適化余地あり → 軽量版検討、条件分岐削減
-
-### 8.4 機能追加の検討
-
-**優先度: 高**
-- **Tone Mapping拡張**: カスタムカーブ、LUT対応（課題: TEXCOORD使用量、パフォーマンス）
-- **Shader Graph対応**: Custom Functionノード、テンプレート提供（課題: Shader Graph制約、メンテナンスコスト）
-
-**優先度: 中**
-- **Mesh Deformation強化**: Vertex Animation Texture、Skinning対応
-- **カスタムLighting Model**: トゥーンシェーディング等
-
-### 8.5 Unity最新バージョン対応
-
-**Unity 6対応（2025年10月時点）:**
-- ✅ RenderGraph対応済み（v2.7以降）
-- ✅ 基本機能動作確認済み
-- ⚠️ 一部警告表示（機能影響なし） → 今後解消予定
-
-**将来対応:**
-- Unity 2023 LTS固有最適化、新API活用
-- URP 17.x以降の新機能対応
-- 条件付きコンパイルで互換性維持
-
-### 8.6 長期的ビジョン
-
-**アーキテクチャ進化:**
-- **モジュール化推進**: 機能を独立モジュール化、必要な機能のみ使用可能に
-- **プラグインシステム**: サードパーティ機能拡張対応（課題: API設計、互換性管理）
-
-**ツールチェーン強化:**
-- **ビジュアルエディター**: GUI上でエフェクトプレビュー、リアルタイム調整
-- **プリセットライブラリ**: よく使用される設定をワンクリック適用
-
-**コミュニティ協働:**
-- Good First Issue整備、コントリビューションガイド充実
-- GitHub Discussions、ユーザーアンケート活用
-
-### 8.7 リスク管理
-
-**Unity依存リスク:**
-UnityのAPI変更、URPの大幅な仕様変更 → Unity Roadmap定期確認、Beta版事前検証、複数バージョン対応維持
-
-**技術的負債蓄積:**
-コードベース複雑化、保守困難化 → 定期的リファクタリング、コードレビュー徹底、技術的負債可視化
-
-**コミュニティ対応負荷:**
-Issue/PR対応遅延 → 対応プロセス明確化、定期的Issue整理、FAQ充実
-
-### 8.8 まとめ
-
-**短期的課題（3-6ヶ月）:** UIParticles制約対応、ドキュメント同期、パフォーマンス改善
-
-**中期的課題（6-12ヶ月）:** 新機能追加（Tone Mapping拡張等）、Unity 6完全対応、コードリファクタリング
-
-**長期的ビジョン（1年以上）:** モジュール化、ビジュアルエディター、コミュニティ拡大
-
----
-
