Corrige um item do WiseWork — um bug, uma task ou uma feature. Você passa a referência; o comando busca o item, assume, diagnostica a causa raiz, aplica a correção mínima e mantém o item atualizado.
O item do WiseWork é a fonte da verdade e o próprio acompanhamento: o comando não cria plano nem checklist paralelos no seu repositório.
Uso
/ww:fix #1234
/ww:fix 3f2a1c9e-... --status done
/ww:fix "botão de login não responde no Chrome"
/ww:fix "reformulação do checkout" --type feature
Argumentos
| Argumento | Obrigatório? | Descrição |
|---|
<ticket|id|title> | Sim | O item a corrigir: número do ticket (#1234), identificador colado ou um pedaço do título. Se mais de um item bater com o título, o comando pergunta qual você quis. |
--type task|feature | Opcional | Força o tipo do item quando a referência serve para os dois. Use feature para percorrer as tasks filhas — os bugs são os alvos principais. |
--status <key> | Opcional | Onde o item termina. Sem isso, ele vai para revisão — ou para concluído, quando o comando conseguiu verificar a correção. |
Notas
O comando nunca corrige algo que não buscou no WiseWork, e não refatora o que não tem a ver com o problema.
Quando existe um defeito registrado e você quer resolvê-lo sem transformar a correção em uma reforma.
- Número do ticket —
#1234 ou só 1234.
- Identificador colado — funciona para task e para feature.
- Um pedaço do título — “botão de login não responde no Chrome”. Se houver mais de um item parecido, o comando pergunta; se não houver nenhum, ele para e diz.
Antes de tocar no código, o comando assume o item: coloca no seu nome, move para “em andamento” e publica um comentário de abertura. Numa feature, faz isso com cada task filha que vai corrigir — os bugs são os alvos principais — e move a feature para “em andamento”.
Durante o trabalho, ele localiza os arquivos afetados, lê e diagnostica a causa raiz, aplica a correção mínima que resolve o problema — seguindo os padrões existentes e os guias de estilo de ~/.claude/style-guides/ —, confere relendo o que mudou e publica comentários de progresso descrevendo a causa e a correção.
Quando a correção mexe na interface ou no servidor, o comando carrega antes as regras de trabalho de frontend ou de backend do plugin (as duas, se o item cobre os dois lados). Elas orientam como mudar e como verificar, sem alargar o que é mudado.
No fim, valida os arquivos alterados: verifica os tipos com o verificador que o projeto já usa (detectado automaticamente), roda o lint quando o projeto tem um e o build só quando não há verificação de tipos, mais as verificações que as regras de frontend ou backend pedem. Os erros novos são corrigidos; os que já existiam em outros arquivos são relatados, não corrigidos.
Depois, anexa ao item a evidência que a correção gerou no projeto — capturas de antes e depois da tela afetada, logs de reprodução, relatórios de teste —, deixando de fora arquivos com credenciais ou acima de 20 MB. Por fim, publica um comentário final com causa raiz, arquivos alterados, resultado da validação e os anexos, e devolve o item com o status certo.
Por padrão, o item termina em revisão — ou em concluído, quando o comando conseguiu verificar a correção. Com --status, você escolhe outro status do seu produto.
Quando o destino é um status de conclusão, o comando registra também o motivo do fechamento e as notas — os mesmos campos que o WiseWork pede quando você fecha uma task pela tela — e a causa raiz que o diagnóstico encontrou, que é o que faz a correção valer como histórico. Um status intermediário não tem esse registro, porque não há nada a fechar.
Numa feature, cada task filha corrigida é fechada do mesmo jeito, e a feature fica “em andamento” enquanto sobrar task e “entregue” quando todas estiverem resolvidas.
O fix procura a causa raiz e faz o mínimo que resolve: preserva o comportamento existente, segue os padrões que já estão ali e não refatora o que não tem a ver com o problema. O implement constrói a entrega inteira do item.
- Ele não corrige nada que não tenha buscado antes. O item vem do WiseWork antes de qualquer mudança.
- A correção não passa do escopo. Arquivos alheios ao item não são tocados.
- Os comentários saem em seu nome, pelo seu acesso.
- O comando nunca esconde um erro.
