Flujos de Trabajo de Colaboración en Equipo

Configura OpenCode para uso en equipo. Aprende a compartir configuraciones, acceso basado en roles, patrones colaborativos y cómo mantener consistencia en tu equipo de desarrollo.

¿Por Qué Configuración en Equipo?

Beneficio	Descripción
Consistencia	Mismo comportamiento en todo el equipo
Compartir conocimiento	Habilidades y prompts compartidos
Seguridad	Permisos controlados
Auditabilidad	Rastrear uso de IA

Compartir Configuración

Estrategia de Control de Versiones

your-project/
├── .opencode/
│   ├── config.json          # ✅ Commit (team config)
│   ├── skills/              # ✅ Commit (shared skills)
│   └── memory/              # ❌ Don't commit (personal)
├── opencode.json            # ✅ Commit (legacy format)
└── .env                     # ❌ Don't commit (secrets)

.gitignore

git

# OpenCode
.env
.opencode/memory/
.opencode/sessions/
*.log

Configuración Compartida

Crea .opencode/config.json:

json

{
  "$schema": "https://opencode.ai/config.json",
  "agents": {
    "default": {
      "model": "gpt-4o",
      "description": "Team coding assistant"
    }
  },
  "permissions": [
    {
      "tool": "bash",
      "allow": ["npm *", "git *", "pytest *"],
      "deny": ["sudo *", "rm -rf /"]
    }
  ],
  "skills": {
    "code-review": {
      "manifest": ".opencode/skills/code-review/skill.yaml"
    }
  }
}

Configuración Basada en Roles

Diferentes Roles, Diferentes Configuraciones

Crea archivos de configuración específicos por rol:

bash

.config/
├── opencode-developer.json
├── opencode-reviewer.json
└── opencode-lead.json

Uso

bash

# Developer mode
opencode --config .config/opencode-developer.json

# Reviewer mode
opencode --config .config/opencode-reviewer.json

Habilidades Compartidas

Crear Habilidades del Equipo

.opencode/skills/
├── code-review/
│   ├── skill.yaml
│   └── skill.md
├── api-design/
│   ├── skill.yaml
│   └── skill.md
└── testing/
    ├── skill.yaml
    └── skill.md

Compartir vía Git

bash

git add .opencode/skills/
git commit -m "Add team skills"
git push

Patrones Colaborativos

Flujo de Trabajo de Revisión de Código

💡 Tip: Use Ctrl + Mouse Wheel to zoom, or click the fullscreen icon

Programación en Pareja

> Switch to pair mode
> Load shared project context
> Let's work on the authentication module together

Transferencia de Conocimiento

> Summarize our architecture decisions into a memory file
> Create a guide for new developers

Mejores Prácticas de Seguridad

Aislamiento de Permisos

json

{
  "permissions": [
    {
      "tool": "bash",
      "allow": ["npm test", "npm run lint"],
      "deny": ["npm publish", "git push --force"]
    },
    {
      "tool": "write",
      "allow": ["src/**", "tests/**"],
      "deny": [".env", "secrets/**", "*.key"]
    }
  ]
}

Gestión de Secretos

Práctica	Implementación
Usar variables de entorno	`${API_KEY}` en configuración
Nunca commitear secretos	Agregar .env a .gitignore
Rotar regularmente	Actualizar claves mensualmente
Auditar acceso	Registrar todas las llamadas a la API

Monitoreo y Auditoría

Habilitar Registro

json

{
  "logging": {
    "enabled": true,
    "level": "info",
    "file": "opencode-audit.log"
  }
}

Rastrear Uso

bash

# View audit log
tail -f opencode-audit.log

# Search for specific actions
grep "bash" opencode-audit.log

Incorporando Nuevos Miembros del Equipo

Lista de Verificación

Clonar repositorio
Instalar OpenCode
Copiar .env.example a .env
Agregar claves API
Ejecutar opencode para verificar

Documentación

Crea docs/opencode-setup.md:

markdown

# OpenCode Setup

## Prerequisites
- Node.js 18+
- API key from OpenAI or Anthropic

## Setup
1. npm install -g opencode
2. cp .env.example .env
3. Add your API key to .env
4. opencode --version

## Usage
- `opencode` - Start interactive session
- `opencode run "task"` - Run single prompt