关于 unity-vrc-skills-renovator
面向维护 VRChat 技能仓库的工作指南，用于补充知识、更新过时内容并提升准确性。它规定了对 UdonSharp 与 World SDK 技能的分析、资料搜集、规则同步和验证流程。
主要功能
- 01按补充、更新和质量改进分类
- 02维护 UdonSharp 与 World SDK 技能
- 03同步知识、规则与验证钩子
- 04更新模板和代码示例
- 05核对官方来源与交叉引用
适用场景
- 01更新 VRChat SDK 版本支持信息
- 02将新 API 和模式纳入技能文档
- 03确保规则、钩子与模板保持一致
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/unity-vrc-skills-renovator确认已加载。
详细介绍
VRC Skills Renovator
概述
本指南介绍如何翻新（补充知识、更新信息并提升质量）此仓库中与 VRChat 相关的技能。
翻新的三大支柱
| 支柱 | 描述 | 示例 |
|---|---|---|
| 补充 | 添加缺失的知识 | 未记录的 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：分析当前状态
- 检查每项技能当前启用且已验证的 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
- 检查每项技能的文件列表
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：制定翻新计划
按三大支柱和目标技能对收集的信息进行分类：
按支柱分类
| 支柱 | 内容 | 操作 |
|---|---|---|
| 补充 | 技能中尚未包含的信息 | 添加新章节、添加代码示例 |
| 更新 | 过时的信息 | 更新版本引用、移除已弃用的 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 的 Resources 部分添加链接
阶段 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：验证
- 统一所有文件中的 SDK 版本引用
- 验证两个技能之间的交叉引用链接
- 检查代码示例语法
- 三层一致性检查：验证知识／规则／强制执行是否反映相同的事实
- 确保所有三层的限制列表保持一致
- 确保所有三层的限制值（同步变量数量、字符串长度等）保持一致
- 确保模板不使用受限功能
官方来源
详情请参阅 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 错误，因此请使用 WebSearch 而非 WebFetch
- 日语来源（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)
评论
支持 Markdown