| name | setup-workspace |
| description | Instala e configura o workspace WriteTextAmp — executa scripts de setup, configura MCPs, instala Open Design |
Setup Workspace
Skill para instalação e configuração automatizada do workspace WriteTextAmp.
Quando Usar
- Primeira instalação do workspace
- Reconfiguração de serviços (FLUX, Pictify, Open Design)
- Atualização de API keys
- Instalação de novos componentes (Open Design)
- Validação de instalação
Workflow Automático
1. Executar Script de Setup
O script PowerShell faz tudo automaticamente:
# No diretório raiz do workspace
powershell -File scripts/setup.ps1
O que o script faz:
- ✓ Verifica prerequisites (Node.js, npm, Python, Git)
- ✓ Executa configuração interativa (Python)
- ✓ Instala Open Design (se habilitado)
- ✓ Atualiza opencode.jsonc com configurações
- ✓ Valida instalação
2. Configuração Interativa
O script Python (scripts/configure.py) pergunta:
- FLUX — Habilitar? (free tier em bfl.ai)
- Pictify — Habilitar? API key? (free tier em pictify.io)
- Open Design — Habilitar? Instalar do GitHub?
As respostas são salvas em .env.
3. Instalação do Open Design
Se habilitado, o script:
# Clona repositório
git clone https://github.com/nexu-io/open-design tools/open-design
# Instala dependências
cd tools/open-design
npm install
# Instruções para iniciar
npm start
Comandos Úteis
Setup Completo
# Setup padrão
powershell -File scripts/setup.ps1
# Setup forçado (reinstala tudo)
powershell -File scripts/setup.ps1 -Force
# Setup sem Open Design
powershell -File scripts/setup.ps1 -SkipOpenDesign
Reconfigurar Serviços
# Editar .env manualmente
notepad .env
# Ou executar configuração interativa
python scripts/configure.py
# Depois atualizar config
powershell -File scripts/setup.ps1
Instalar Open Design Manualmente
# Criar diretório
mkdir tools
cd tools
# Clonar repositório
git clone https://github.com/nexu-io/open-design
cd open-design
# Instalar dependências
npm install
# Iniciar
npm start
Arquivos de Configuração
.env (gerado pelo script)
FLUX_ENABLED=false
PICTIFY_ENABLED=false
PICTIFY_API_KEY=your_key
OPEN_DESIGN_ENABLED=false
OPEN_DESIGN_PORT=3333
opencode.jsonc (atualizado pelo script)
O script atualiza automaticamente:
- Habilita/desabilita MCPs baseado no
.env
- Adiciona API keys quando fornecidas
- Configura portas e endpoints
Troubleshooting
Node.js não encontrado
Solução:
# Instalar Node.js
# Download: https://nodejs.org/
# Ou via Chocolatey:
choco install nodejs
Python não encontrado
Solução:
# Instalar Python
# Download: https://www.python.org/
# Ou via Chocolatey:
choco install python
# Alternativa: configurar .env manualmente
copy .env.template .env
notepad .env
Git não encontrado (Open Design)
Solução:
# Instalar Git
# Download: https://git-scm.com/
# Ou via Chocolatey:
choco install git
# Ou instalar Open Design manualmente (download ZIP do GitHub)
npm install falha (Open Design)
Solução:
cd tools/open-design
# Limpar cache
npm cache clean --force
# Tentar novamente
npm install
# Se ainda falhar, verificar:
node --version # Deve ser 18+
npm --version # Deve ser 9+
Open Design não inicia
Solução:
cd tools/open-design
# Verificar se dependências instalaram
npm install
# Tentar iniciar com verbose
npm start -- --verbose
# Verificar porta (padrão 3333)
# Se porta em uso, mudar em .env:
# OPEN_DESIGN_PORT=3334
Validação
Após setup, verifique:
# 1. Diretórios existem
Test-Path projetos\_modelo
Test-Path _templates
Test-Path .opencode
# 2. Arquivos de config existem
Test-Path opencode.jsonc
Test-Path .env
# 3. Open Design instalado (se habilitado)
Test-Path tools\open-design
# 4. MCPs respondem (dentro do OpenCode)
# Use: @marketing-copywriter "teste"
Próximos Passos Após Setup
-
Criar primeiro projeto:
Copy-Item -Path projetos\_modelo -Destination projetos\meu-projeto -Recurse
-
Editar contexto:
projetos/meu-projeto/briefing.md
projetos/meu-projeto/brand-voice.md
projetos/meu-projeto/personas.md
-
Iniciar OpenCode:
cd projetos/meu-projeto
opencode
-
Testar agents:
@marketing-copywriter "Escreva um artigo teste sobre marketing digital"
Checklist de Instalação