unity-vrc-skills-renovator

VRC スキルの改修

概要

このリポジトリにある VRChat 関連スキルの改修（知識の補完、最新化、品質向上）に関するガイドです。

改修の3つの柱

柱	説明	例
補完	不足している知識を追加します	ドキュメント化されていない API、パターン、ヒント
最新化	古くなった情報を更新します	新しい SDK バージョンへの対応、非推奨 API の削除
品質向上	既存の知識の正確性と網羅性を高めます	コード例の追加、説明の改善

対象スキル

パス表記：skills/ はリポジトリのルートにある skills/ ディレクトリを指します。 rules/ は skills/unity-vrc-udon-sharp/rules/ 以下のファイルを指します。 このスキル自体は .claude/skills/unity-vrc-skills-renovator/ にあります（開発用のみ、npm では配布されません）。

スキル	ディレクトリ	内容
unity-vrc-udon-sharp	skills/unity-vrc-udon-sharp/	UdonSharp のコーディング、ネットワーク、イベント
unity-vrc-world-sdk-3	skills/unity-vrc-world-sdk-3/	VRC コンポーネント、レイヤー設定、ワールドの最適化

改修手順

フェーズ 1：現状分析

1. 各スキルで有効かつ検証済みの SDK 対象を確認します

Read: skills/unity-vrc-udon-sharp/SKILL.md
Read: skills/unity-vrc-world-sdk-3/SKILL.md
→ Check the "Active support / last verified" line in each file

2. 各スキルのファイル一覧を確認します

Glob: skills/unity-vrc-udon-sharp/**/*
Glob: skills/unity-vrc-world-sdk-3/**/*

フェーズ 2：情報収集

最新情報を収集するため、次の検索クエリを並行して実行します。

# Required searches (parallel execution recommended)
1. "VRChat SDK {current year} new features updates changelog"
2. "UdonSharp VRChat SDK 3.{next minor version} changes"
3. "VRChat Worlds SDK {current year} UdonSharp"
4. "VRChat World SDK components new features {current year}"

# Supplementary searches (as needed)
5. "VRChat SDK NetworkCallable parameters"
6. "VRChat SDK persistence PlayerData"
7. "VRChat SDK PhysBones Contacts worlds"

詳細は references/search-queries.md を参照してください。

フェーズ 3：改修計画

収集した情報を3つの柱と対象スキルに分類します。

柱による分類

柱	内容	対応
補完	スキルにまだ記載されていない情報	セクションやコード例を追加します
最新化	古くなった情報	バージョン参照を更新し、非推奨 API を削除します
品質向上	不正確または不十分な説明	説明を改善し、パターンを追加します

スキルによる分類

カテゴリ	対象スキル	例
C# API、ネットワーク、同期変数	unity-vrc-udon-sharp	NetworkCallable、新しいイベント
コンポーネント、レイヤー、最適化	unity-vrc-world-sdk-3	新しいコンポーネント、設定の変更
両方に影響	両方	SDK バージョンの参照、Persistence

フェーズ 4：unity-vrc-udon-sharp を更新

優先度	ファイル	更新内容
1	SKILL.md	SDK バージョンへの対応、新機能の概要
2	references/constraints.md	新たに利用可能になった機能
3	references/networking.md	新しいネットワーク機能
4	references/events.md	新しいイベント
5	references/api.md	新しい API
6	CHEATSHEET.md	クイックリファレンスの更新
7	references/patterns.md	新機能の使用パターン
8	references/troubleshooting.md	トラブルシューティング

フェーズ 5：unity-vrc-world-sdk-3 を更新

優先度	ファイル	更新内容
1	SKILL.md	SDK バージョンへの対応、新機能の概要
2	references/components.md	新しいコンポーネント、プロパティの変更
3	references/layers.md	レイヤー／衝突の変更
4	references/performance.md	新しい最適化ガイドライン
5	references/lighting.md	ライティング関連の変更
6	references/audio-video.md	オーディオ／ビデオ関連の変更
7	references/upload.md	アップロード手順の変更
8	CHEATSHEET.md	クイックリファレンスの更新
9	references/troubleshooting.md	トラブルシューティング

フェーズ 6：新しいファイルの作成（必要に応じて）

大規模な新機能を追加する場合：

• 対応するスキルの references/ に専用のリファレンスファイルを作成します
• 対応する SKILL.md の「リソース」セクションにリンクを追加します

フェーズ 7：ルールと強制適用レイヤーの同期

ナレッジレイヤー（references/*.md）を変更した場合は、必ずルールレイヤーと強制適用レイヤーも同期します。

7a. ルールレイヤー — 自動読み込みルール（skills/unity-vrc-udon-sharp/rules/）

Read: skills/unity-vrc-udon-sharp/rules/udonsharp-constraints.md
Read: skills/unity-vrc-udon-sharp/rules/udonsharp-networking.md
Read: skills/unity-vrc-udon-sharp/rules/udonsharp-sync-selection.md
→ Check for differences with the Knowledge layer and reflect the same facts

変更の種類	対象ルールファイル	対応
ブロック対象の機能を追加／削除	udonsharp-constraints.md	ブロックリスト／利用可能リストを更新
ネットワーク関連の変更	udonsharp-networking.md	同期モード、制限、パターンを更新
データ予算の変更	udonsharp-sync-selection.md	予算値、決定木を更新

7b. 適用レイヤー — 検証フック（hooks/）

Read: skills/unity-vrc-udon-sharp/hooks/validate-udonsharp.sh
Read: skills/unity-vrc-udon-sharp/hooks/validate-udonsharp.ps1
→ Add/remove/modify rules based on constraint changes

変更の種類	フック側の対応
機能のブロック解除	対応する grep パターンを削除
新しい制約の追加	新しい grep パターンを追加
制限値の変更	しきい値（synced_count など）を更新
新しいアンチパターン	新しい警告ルールを追加

重要：.sh と .ps1 では、同じルールセットを維持してください（一方だけを更新しないでください）。

7c. 適用レイヤー — テンプレート（assets/templates/）

Read: skills/unity-vrc-udon-sharp/assets/templates/BasicInteraction.cs
Read: skills/unity-vrc-udon-sharp/assets/templates/SyncedObject.cs
Read: skills/unity-vrc-udon-sharp/assets/templates/PlayerSettings.cs
Read: skills/unity-vrc-udon-sharp/assets/templates/CustomInspector.cs
→ Remove deprecated patterns and reflect new best practices

変更の種類	テンプレート側の対応
新しい API が推奨される	新しい API を使用するようテンプレートを更新
パターンが非推奨になる	推奨パターンに書き換え
新しいベストプラクティス	該当するテンプレートに反映するか、新しいテンプレートを作成

フェーズ 8：検証

1. すべてのファイルで SDK のバージョン表記を統一する
2. 両方のスキル間の相互参照リンクを確認する
3. コードサンプルの構文を確認する
4. 3 層の整合性チェック：ナレッジ／ルール／適用が同じ事実を反映していることを確認する
   • 制約リストが 3 層すべてで一致している
   • 制限値（同期変数の数、文字列の長さなど）が 3 層すべてで一致している
   • テンプレートでブロック対象の機能を使用していない

公式情報源

詳細は references/changelog-sources.md を参照してください。

主な情報源

情報源	URL	内容
SDK リリース	creators.vrchat.com/releases/	公式リリースノート
UdonSharp ブログ	udonsharp.docs.vrchat.com/news/	UdonSharp 固有の更新
VRChat Canny	feedback.vrchat.com/udon	機能リクエストと完了状況

公式ドキュメントの WebSearch

# Search official documentation
WebSearch: "API name or feature site:creators.vrchat.com"

# UdonSharp API reference
WebSearch: "API name site:udonsharp.docs.vrchat.com"

検索に関する注意事項

• VRChat の公式サイトでは 403 エラーが返る場合があるため、WebFetch ではなく WebSearch を使用してください
• 日本語の情報源（Qiita など）も参考になりますが、公式情報を優先してください
• GitHub の UdonSharp リリースページも確認してください

改修履歴のテンプレート

次の形式で改修内容を記録してください：

## Renovation History

### YYYY-MM-DD - Summary (e.g., SDK X.Y.Z support / knowledge fill / quality improvement)

**Fill (New additions):**
- Added knowledge / sections

**Refresh (Updates / Fixes):**
- Updated info / corrections

**Quality Improvement:**
- Improved descriptions / added examples

**Rules Layer Sync:**
- unity-vrc-udon-sharp/rules/udonsharp-constraints.md: changes
- unity-vrc-udon-sharp/rules/udonsharp-networking.md: changes

**Enforcement Layer Sync:**
- hooks/validate-udonsharp.sh: rules added/removed
- hooks/validate-udonsharp.ps1: synced with .sh
- assets/templates/SyncedObject.cs: pattern updated

**Changed Files:**
- unity-vrc-udon-sharp/file.md: changes
- unity-vrc-world-sdk-3/file.md: changes

**3-Layer Consistency**: OK / NG (details)