Resposta rápida
regras do OpenCode: Resposta rápida
As regras do OpenCode são instruções duradouras para uma sessão. Use regras de projeto para convenções do repositório, globais para hábitos pessoais estáveis e URLs somente quando a fonte for confiável e revisada.
O conjunto Similarweb `opencode rules` indica intenção de configuração sobre arquivos de regras e escopos global e de projeto. A documentação oficial separa rules, skills, agents, permissions e config; este guia explica os limites.
Defina o escopo e teste com leitura apenas. Uma regra curta e verificável é mais segura que um bloco que mistura procedimentos, permissões e deploy.
Guias relacionados: Guia de skills do OpenCode, Guia de agents do OpenCode, Guia de permissões do OpenCode, Configuração do OpenCode.
1. Escolha o menor escopo útil
Regra de projeto guarda comandos de teste, pastas geradas, responsabilidades e limites de segurança. Regra global é um hábito pessoal. URL adiciona uma fronteira de rede: valide o domínio e mantenha uma cópia local para controles críticos.
| Escopo | Uso | Risco |
|---|---|---|
| Projeto | Convenções do repositório | Regra desatualizada |
| Global | Hábito pessoal | Surpresa entre projetos |
| URL | Contexto externo confiável | Mudança sem revisão |
2. Confirme onde o OpenCode encontra regras
A página Rules cobre inicialização, tipos, prioridade, instruções personalizadas e arquivos externos. Use a inicialização da versão instalada e confirme o caminho real; não copie diretórios de outro framework.
3. Trate a prioridade como decisão revisável
Regras globais e de projeto podem conflitar. Crie um exemplo pequeno e observe a prioridade documentada. Preserve o limite de segurança do projeto e remova duplicações.
4. Escreva instruções curtas
Uma regra útil diz quando se aplica, o que fazer e evitar, qual evidência esperar e como reverter. Separe fatos do repositório de preferências pessoais.
5. Verifique a confiança antes de arquivos externos
Um arquivo externo pode mudar sem revisão. Verifique transporte, dono e histórico; use-o primeiro para contexto de baixo risco e mantenha segredos e deploy localmente.
6. Separe rules, skills, agents, permissions e config
Rules expressa restrições, skills procedimentos, agents papéis e ferramentas, permissions allow/ask/deny e config ajustes. Não esconda um release automático em uma regra.
7. Valide as regras efetivas antes de editar
Teste em uma branch descartável: explicação, leitura, pequena alteração e revisão do diff. Documente rollback e repita após remover a regra.
Perguntas frequentes sobre as regras do OpenCode
O que são regras do OpenCode?
Instruções duradouras aplicadas em um escopo de projeto, global ou externo confiável.
Onde coloco regras de projeto?
Confirme o caminho na documentação Rules da sua versão e mantenha o arquivo no repositório.
Rules e skills são iguais?
Não. Rules define restrições e skills descreve procedimentos reutilizáveis.
Uma regra global substitui a do projeto?
Depende do tipo e da prioridade documentados; teste um conflito pequeno.
Regras por URL são seguras?
Somente com fonte confiável e revisada; regras críticas devem permanecer locais.
Fontes oficiais
A documentação de Rules, Config, Permissions, Skills e Agents foi verificada em 31 de outubro de 2026. Confirme a sintaxe na página oficial da sua versão.