Respuesta rápida
reglas de OpenCode: Respuesta rápida
Las reglas de OpenCode son instrucciones duraderas para una sesión. Usa reglas de proyecto para las convenciones del repositorio, reglas globales para hábitos personales estables y referencias URL solo cuando la fuente sea confiable y revisada.
El conjunto de Similarweb para `opencode rules` muestra una intención de configuración: archivos de reglas, reglas globales y reglas de proyecto. La documentación oficial separa rules de skills, agents, permissions y config; esta guía explica cuándo usar cada límite.
Primero define el alcance y prueba un caso de solo lectura. Una regla breve y verificable es más segura que un bloque largo que mezcla procedimientos, permisos y despliegue.
Guías relacionadas: OpenCode Skills, OpenCode Agents, OpenCode Permissions, OpenCode Config.
1. Elige el alcance mínimo para tus reglas
Una regla de proyecto contiene comandos de prueba, carpetas generadas, propiedad de archivos y límites de seguridad. Una regla global debe expresar un hábito personal que funcione en muchos repositorios. Una URL añade una frontera de red y procedencia: revisa el dominio, conserva una copia local para los controles críticos y no permitas que la red cambie una política sin revisión.
| Alcance | Uso | Riesgo |
|---|---|---|
| Proyecto | Convenciones del repositorio | Regla obsoleta |
| Global | Hábito personal | Sorpresas entre proyectos |
| URL | Contexto externo confiable | Cambios sin revisión |
2. Confirma dónde descubre reglas OpenCode
La página oficial de Rules cubre inicialización, tipos, prioridad, instrucciones personalizadas y archivos externos. Usa la inicialización de la versión instalada y confirma el camino real; no copies directorios de otro framework. Mantén junto al proyecto la explicación de qué protege la regla y cómo desactivarla.
3. Trata la prioridad como una decisión revisable
Las reglas globales y del proyecto pueden contradecirse. Escribe un pequeño ejemplo de conflicto y observa qué instrucción se aplica según la documentación actual. Conserva la frontera de seguridad del proyecto, elimina duplicados y anota el motivo en el cambio.
4. Escribe instrucciones personalizadas como contratos cortos
Una regla útil indica cuándo aplica, qué debe hacer el agente, qué debe evitar, qué evidencia demuestra el resultado y cómo revertirla. Separa hechos del repositorio de preferencias personales; una preferencia de estilo pertenece mejor a una skill o regla global.
5. Comprueba la confianza antes de referenciar archivos externos
Un archivo externo puede aportar contexto compartido, pero su contenido puede cambiar sin revisión. Comprueba transporte, propietario, historial y disponibilidad. Usa primero fuentes externas para contexto de bajo riesgo; deja secretos, despliegues y comandos destructivos en reglas locales.
6. Separa rules de skills, agents, permissions y config
Rules expresan restricciones duraderas; skills contienen procedimientos; agents definen roles y herramientas; permissions decide allow, ask o deny; config controla proveedores y rutas. No ocultes un flujo de publicación automático en una regla: deja el procedimiento explícito y exige aprobación para acciones de alto impacto.
7. Valida las reglas efectivas antes de editar
Prueba una regla en una rama desechable: pide una explicación, ejecuta una tarea de solo lectura, haz un cambio pequeño y revisa el diff. Documenta la ruta de rollback y repite la prueba después de quitar la regla para comprobar que el comportamiento cambia.
Preguntas frecuentes sobre las reglas de OpenCode
¿Qué son las reglas de OpenCode?
Son instrucciones duraderas aplicadas dentro de un alcance como proyecto, usuario global o referencia externa confiable.
¿Dónde pongo las reglas de proyecto?
Confirma la ruta con la documentación Rules o la inicialización de tu versión y mantén el archivo en el repositorio para revisarlo con el código.
¿Rules y skills son lo mismo?
No. Rules define restricciones duraderas y skills describe procedimientos reutilizables con pasos y ejemplos.
¿Una regla global puede sobrescribir la del proyecto?
Depende del tipo y la prioridad documentados. Prueba un conflicto pequeño y conserva explícita la frontera del proyecto.
¿Son seguras las reglas URL?
Solo si la fuente es confiable, revisada y apropiada. Las reglas críticas deben tener una copia local y fallar de forma visible sin red.
Fuentes oficiales
La documentación de Rules, Config, Permissions, Skills y Agents se revisó el 31 de octubre de 2026. Confirma la sintaxis en la página oficial de tu versión.