Erros comuns e como remediar
Compatível com ww1.4.0
Erros comuns e como remediar
Seção intitulada “Erros comuns e como remediar”Esta página é o índice de remediação: cada erro aponta para o comando que resolve.
A regra geral: STOP + mensagem apontando para o comando certo
Seção intitulada “A regra geral: STOP + mensagem apontando para o comando certo”Quando a skill workforce-context detecta um problema, ela NÃO tenta contornar. Ela para (STOP) e mostra uma mensagem que aponta para o comando que resolve. Você sempre vê o caminho de saída.
Tabela de erros
Seção intitulada “Tabela de erros”| Erro / sintoma | Causa mais comum | Comando que resolve | Onde investigar |
|---|---|---|---|
| ”MCP server ‘workforce’ not found” | Claude Code não foi reiniciado após config:mcp, ou o servidor não foi registrado | /ww:config:mcp e reiniciar o Claude Code | — |
| “WORKFORCE_TOKEN inválido” / 401 | Token expirado ou revogado | /ww:config:mcp (re-rodar) | Pedir um novo token ao admin |
| ”Nenhum contexto pinado” / “project not set” | init nunca rodou, ou rodou em outro projeto | /ww:init | — |
| “Membro não encontrado” | O token não tem um membro válido | /ww:config:mcp ou pedir ao admin | — |
| “Cache stale (X > 60 min)“ | O init rodou há mais de 1 hora e mudanças externas ainda não refletem | /ww:init de novo | — |
| “Status inválido: X” (em escrita) | Você usou um status que não existe neste projeto | Ver os status válidos do projeto | Conceito: ticket × título + enums |
| ”Projeto não encontrado” | Nome ou UUID errado, ou projeto de outro tenant | /ww:init nome-do-projeto | Confira o nome exato do projeto |
”Ticket não encontrado” (em task:claim, task:status) | Ticket não existe ou você não tem acesso | Pedir a lista com /ww:task:list | O número pode ser de outro projeto |
”Múltiplos matches” (em backlog:show, features:show) | O trecho do título bateu com mais de um | Digitar mais contexto ou colar o UUID | A mensagem do comando lista os candidatos |
”Review bloqueada” (em /ww:review:task) | Comando indisponível | Usar /ww:review:pr | Referência review:pr |
”Build falhou” (em implement, fix) | Erro de compilação ou typecheck | Corrigir o erro e re-rodar | npm run typecheck / npm run build |
”Permission denied” no ~/.claude.json | Permissão de leitura do arquivo | chmod 600 ~/.claude.json | — |
Diagnóstico passo a passo
Seção intitulada “Diagnóstico passo a passo”Quando algo não funciona e a mensagem não está na tabela acima:
- Rode
/ww:initde novo. Quase sempre resolve. - Se persistir, rode
/ww:config:mcppara ver se o servidor está registrado. - Se persistir, abra uma issue com: o comando exato, a mensagem completa, o output de
/ww:init(sem token).