intermediate45 minLição 6 de 6

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.

Fluxos de Trabalho de Colaboração em Equipe

Por que Configuração em Equipe?

BenefícioDescrição
ConsistênciaMesmo comportamento em toda a equipe
Compartilhamento de conhecimentoSkills e prompts compartilhados
SegurançaPermissões controladas
RastreabilidadeAcompanhar 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

gitignore
# 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

100%

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áticaImplementação
Use variáveis de ambiente${API_KEY} na configuração
Nunca commite segredosAdicione .env ao .gitignore
Rotacione regularmenteAtualize chaves mensalmente
Audite acessoRegistre 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

  1. Clone o repositório
  2. Instale o OpenCode
  3. Copie .env.example para .env
  4. Adicione chaves de API
  5. 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

Practice 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

  • Controle de versão de configuração compartilhada e skills, mas não de segredos
  • Configuração baseada em funções fornece permissões apropriadas para cada membro da equipe
  • Skills compartilhadas em .opencode/skills/ garantem comportamento consistente
  • Regras de negação previnem operações perigosas como force push ou exclusão de dados
  • Ative registro para trilhas de auditoria e rastreamento de uso
  • Documente procedimentos de configuração para novos membros da equipe
  • Arquivos de memória pessoais não devem ser commitados no controle de versão
Progresso100%