intermediate⏱45 minLección 6 de 6
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.
Flujos de Trabajo de Colaboración en Equipo
¿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
gitignore
# OpenCode
.env
.opencode/memory/
.opencode/sessions/
*.logConfiguració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.jsonUso
bash
# Developer mode
opencode --config .config/opencode-developer.json
# Reviewer mode
opencode --config .config/opencode-reviewer.jsonHabilidades 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 pushPatrones Colaborativos
Flujo de Trabajo de Revisión de Código
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.logIncorporando Nuevos Miembros del Equipo
Lista de Verificación
- Clonar repositorio
- Instalar OpenCode
- Copiar
.env.examplea.env - Agregar claves API
- Ejecutar
opencodepara 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 promptPractice Questions
Practice Question
Which files should be committed to version control?
Practice Question
How do you share skills with your team?
Practice Question
What is the benefit of role-based configuration?
Practice Question
How do you prevent accidental deletion of production data?
Practice Question
What should you do when onboarding a new team member?
Success
Key Takeaways
- Versiona la configuración compartida y habilidades, pero no los secretos
- La configuración basada en roles proporciona permisos apropiados para cada miembro del equipo
- Las habilidades compartidas en
.opencode/skills/aseguran comportamiento consistente - Las reglas de denegación previenen operaciones peligrosas como push forzado o eliminación de datos
- Habilita el registro para pistas de auditoría y seguimiento de uso
- Documenta los procedimientos de configuración para nuevos miembros del equipo
- Los archivos de memoria personales no deben versionarse
Progreso100%