Fluxos de Trabalho de Colaboração em Equipe

Configure o OpenCode para uso em equipe. Aprenda compartilhamento de configuração, acesso baseado em funções, padrões colaborativos e como manter consistência em sua equipe de desenvolvimento.

Por que Configuração em Equipe?

Benefício	Descrição
Consistência	Mesmo comportamento em toda a equipe
Compartilhamento de conhecimento	Skills e prompts compartilhados
Segurança	Permissões controladas
Rastreabilidade	Acompanhar uso da IA

Compartilhamento de Configuração

Estratégia de Controle de Versão

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

Configuração Compartilhada

Crie .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"
    }
  }
}

Configuração Baseada em Funções

Funções Diferentes, Configs Diferentes

Crie arquivos de configuração específicos para cada função:

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

Skills Compartilhadas

Criar Skills de Equipe

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

Compartilhar via Git

bash

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

Padrões Colaborativos

Fluxo de Trabalho de Revisão de Código

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

Programação em Par

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

Transferência de Conhecimento

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

Melhores Práticas de Segurança

Isolamento de Permissões

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"]
    }
  ]
}

Gerenciamento de Segredos

Prática	Implementação
Use variáveis de ambiente	`${API_KEY}` na configuração
Nunca commite segredos	Adicione .env ao .gitignore
Rotacione regularmente	Atualize chaves mensalmente
Audite acesso	Registre todas as chamadas de API

Monitoramento e Auditoria

Ativar 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

Onboarding de Novos Membros da Equipe

Lista de Verificação

Clone o repositório
Instale o OpenCode
Copie .env.example para .env
Adicione chaves de API
Execute opencode para verificar

Documentação

Crie 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