Renovador de Skills VRChat
Visão Geral
Um guia para renovar (preencher conhecimento, atualizar e melhorar a qualidade) dos skills relacionados ao VRChat neste repositório.
Três Pilares da Renovação
| Pilar | Descrição | Exemplos |
|---|---|---|
| Preencher | Adicionar conhecimento ausente | APIs, padrões e dicas não documentadas |
| Atualizar | Atualizar informações desatualizadas | Suporte a nova versão do SDK, remoção de APIs obsoletas |
| Melhoria de Qualidade | Melhorar precisão e cobertura do conhecimento existente | Adicionar exemplos de código, melhorar explicações |
Skills Alvo
Notação de caminho:
skills/refere-se ao diretórioskills/na raiz do repositório.rules/refere-se a arquivos sobskills/unity-vrc-udon-sharp/rules/. Este skill em si reside em.claude/skills/unity-vrc-skills-renovator/(apenas para desenvolvimento, não distribuído via npm).
| Skill | Diretório | Conteúdo |
|---|---|---|
unity-vrc-udon-sharp | skills/unity-vrc-udon-sharp/ | Programação UdonSharp, rede, eventos |
unity-vrc-world-sdk-3 | skills/unity-vrc-world-sdk-3/ | Componentes VRChat, configurações de camadas, otimização de worlds |
Procedimento de Renovação
Fase 1: Análise do Estado Atual
- Verifique o suporte à versão atual do SDK para cada skill
Leia: skills/unity-vrc-udon-sharp/SKILL.md
Leia: skills/unity-vrc-world-sdk-3/SKILL.md
→ Verifique a linha "Versão do SDK suportada" em cada arquivo
- Verifique a lista de arquivos de cada skill
Glob: skills/unity-vrc-udon-sharp/**/*
Glob: skills/unity-vrc-world-sdk-3/**/*
Fase 2: Coleta de Informações
Execute as seguintes consultas de pesquisa em paralelo para coletar as informações mais recentes:
# Pesquisas obrigatórias (recomenda-se execução paralela)
1. "VRChat SDK {ano atual} novos recursos atualizações changelog"
2. "UdonSharp VRChat SDK 3.{próxima versão menor} mudanças"
3. "VRChat Worlds SDK {ano atual} UdonSharp"
4. "VRChat World SDK componentes novos recursos {ano atual}"
# Pesquisas complementares (conforme necessário)
5. "Parâmetros NetworkCallable do VRChat SDK"
6. "Persistência PlayerData do VRChat SDK"
7. "PhysBones e Contacts do VRChat SDK em worlds"
Consulte references/search-queries.md para detalhes.
Fase 3: Plano de Renovação
Classifique as informações coletadas de acordo com os 3 pilares e skills alvo:
Classificação por Pilar
| Pilar | Conteúdo | Ação |
|---|---|---|
| Preencher | Informações ainda não presentes no skill | Adicionar novas seções, adicionar exemplos de código |
| Atualizar | Informações desatualizadas | Atualizar referências de versão, remover APIs obsoletas |
| Melhoria de Qualidade | Descrições imprecisas ou insuficientes | Melhorar explicações, adicionar padrões |
Classificação por Skill
| Categoria | Skill Alvo | Exemplos |
|---|---|---|
| API C#, rede, variáveis de sincronização | unity-vrc-udon-sharp | NetworkCallable, novos eventos |
| Componentes, camadas, otimização | unity-vrc-world-sdk-3 | Novos componentes, mudanças de configuração |
| Afeta ambos | Ambos | Referências de versão do SDK, Persistence |
Fase 4: Atualizar unity-vrc-udon-sharp
| Prioridade | Arquivo | Conteúdo da Atualização |
|---|---|---|
| 1 | SKILL.md | Suporte à versão do SDK, resumo de novos recursos |
| 2 | references/constraints.md | Recursos recém-disponíveis |
| 3 | references/networking.md | Novos recursos de rede |
| 4 | references/events.md | Novos eventos |
| 5 | references/api.md | Novas APIs |
| 6 | CHEATSHEET.md | Atualização de referência rápida |
| 7 | references/patterns.md | Padrões de uso de novos recursos |
| 8 | references/troubleshooting.md | Solução de problemas |
Fase 5: Atualizar unity-vrc-world-sdk-3
| Prioridade | Arquivo | Conteúdo da Atualização |
|---|---|---|
| 1 | SKILL.md | Suporte à versão do SDK, resumo de novos recursos |
| 2 | references/components.md | Novos componentes, mudanças de propriedades |
| 3 | references/layers.md | Mudanças em camadas/colisões |
| 4 | references/performance.md | Novas diretrizes de otimização |
| 5 | references/lighting.md | Mudanças relacionadas à iluminação |
| 6 | references/audio-video.md | Mudanças relacionadas a áudio/vídeo |
| 7 | references/upload.md | Mudanças no procedimento de upload |
| 8 | CHEATSHEET.md | Atualização de referência rápida |
| 9 | references/troubleshooting.md | Solução de problemas |
Fase 6: Criação de Novos Arquivos (se necessário)
Quando novos recursos importantes são adicionados:
- Crie um arquivo de referência dedicado em
references/do skill correspondente - Adicione um link na seção de Recursos do SKILL.md correspondente
Fase 7: Sincronização da Camada de Regras e Execução
Quando a camada de Conhecimento (references/*.md) muda, sempre sincronize também a camada de Regras e a camada de Execução.
7a. Camada de Regras — Regras Carregadas Automaticamente (skills/unity-vrc-udon-sharp/rules/)
Leia: skills/unity-vrc-udon-sharp/rules/udonsharp-constraints.md
Leia: skills/unity-vrc-udon-sharp/rules/udonsharp-networking.md
Leia: skills/unity-vrc-udon-sharp/rules/udonsharp-sync-selection.md
→ Verifique diferenças com a camada de Conhecimento e reflita os mesmos fatos
| Tipo de Mudança | Arquivo de Regra Alvo | Ação |
|---|---|---|
| Recurso bloqueado adicionado/removido | udonsharp-constraints.md | Atualizar lista de bloqueios / lista disponível |
| Mudanças de rede | udonsharp-networking.md | Atualizar modos de sincronização, limites, padrões |
| Mudanças de orçamento de dados | udonsharp-sync-selection.md | Atualizar valores de orçamento, árvore de decisão |
7b. Camada de Execução — Ganchos de Validação (hooks/)
Leia: skills/unity-vrc-udon-sharp/hooks/validate-udonsharp.sh
Leia: skills/unity-vrc-udon-sharp/hooks/validate-udonsharp.ps1
→ Adicione/remova/modifique regras com base nas mudanças de restrições
| Tipo de Mudança | Ação no Gancho |
|---|---|
| Recurso desbloqueado | Remover o padrão grep correspondente |
| Nova restrição adicionada | Adicionar um novo padrão grep |
| Valor de limite alterado | Atualizar o threshold (synced_count, etc.) |
| Novo anti-padrão | Adicionar uma nova regra de aviso |
Importante: .sh e .ps1 devem manter o mesmo conjunto de regras (não atualize apenas um).
7c. Camada de Execução — Templates (assets/templates/)
Leia: skills/unity-vrc-udon-sharp/assets/templates/BasicInteraction.cs
Leia: skills/unity-vrc-udon-sharp/assets/templates/SyncedObject.cs
Leia: skills/unity-vrc-udon-sharp/assets/templates/PlayerSettings.cs
Leia: skills/unity-vrc-udon-sharp/assets/templates/CustomInspector.cs
→ Remova padrões obsoletos e reflita novas melhores práticas
| Tipo de Mudança | Ação no Template |
|---|---|
| Nova API se torna recomendada | Atualizar template para usar a nova API |
| Padrão se torna obsoleto | Reescrever para o padrão recomendado |
| Nova melhor prática | Refletir no template relevante, ou criar um novo template |
Fase 8: Validação
- Unificar referências de versão do SDK em todos os arquivos
- Verificar links de referência cruzada entre ambos os skills
- Verificar a sintaxe dos exemplos de código
- Verificação de consistência de 3 camadas: Verificar se Conhecimento / Regras / Execução refletem os mesmos fatos
- As listas de restrições são consistentes em todas as 3 camadas
- Os valores de limite (contagem de variáveis sincronizadas, comprimento de string, etc.) são consistentes em todas as 3 camadas
- Templates não usam recursos bloqueados
Fontes Oficiais
Consulte references/changelog-sources.md para detalhes.
Fontes Primárias
| Fonte | URL | Conteúdo |
|---|---|---|
| Lançamentos do SDK | creators.vrchat.com/releases/ | Notas de lançamento oficiais |
| Blog do UdonSharp | udonsharp.docs.vrchat.com/news/ | Atualizações específicas do UdonSharp |
| VRChat Canny | feedback.vrchat.com/udon | Solicitações de recursos e status de conclusão |
Pesquisa na Web pela Documentação Oficial
# Pesquisar documentação oficial
WebSearch: "nome da API ou recurso site:creators.vrchat.com"
# Referência da API UdonSharp
WebSearch: "nome da API site:udonsharp.docs.vrchat.com"
Notas de Pesquisa
- O site oficial do VRChat pode retornar erros 403, portanto use WebSearch em vez de WebFetch
- Fontes em japonês (Qiita, etc.) podem ser úteis, mas priorize informações oficiais
- Verifique também a página de lançamentos do UdonSharp no GitHub
Template de Histórico de Renovação
Registre as renovações no seguinte formato:
## Histórico de Renovação
### AAAA-MM-DD - Resumo (ex.: Suporte SDK X.Y.Z / preenchimento de conhecimento / melhoria de qualidade)
**Preencher (Novas adições):**
- Conhecimento/seções adicionadas
**Atualizar (Atualizações/Correções):**
- Informações atualizadas / correções
**Melhoria de Qualidade:**
- Descrições melhoradas / exemplos adicionados
**Sincronização da Camada de Regras:**
- unity-vrc-udon-sharp/rules/udonsharp-constraints.md: mudanças
- unity-vrc-udon-sharp/rules/udonsharp-networking.md: mudanças
**Sincronização da Camada de Execução:**
- hooks/validate-udonsharp.sh: regras adicionadas/removidas
- hooks/validate-udonsharp.ps1: sincronizado com .sh
- assets/templates/SyncedObject.cs: padrão atualizado
**Arquivos Alterados:**
- unity-vrc-udon-sharp/file.md: mudanças
- unity-vrc-world-sdk-3/file.md: mudanças
**Consistência de 3 Camadas**: OK / NG (detalhes)