intermediate⏱45 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í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
gitignore
# OpenCode
.env
.opencode/memory/
.opencode/sessions/
*.logConfiguraçã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.jsonUso
bash
# Developer mode
opencode --config .config/opencode-developer.json
# Reviewer mode
opencode --config .config/opencode-reviewer.jsonSkills 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 pushPadrões Colaborativos
Fluxo de Trabalho de Revisão de Código
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.logOnboarding de Novos Membros da Equipe
Lista de Verificação
- Clone o repositório
- Instale o OpenCode
- Copie
.env.examplepara.env - Adicione chaves de API
- Execute
opencodepara 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 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
- 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%