Resolver problemas ao trabalhar um caso

Esta página é para um aprendiz cuja sessão funciona e cujos comandos existem, mas cujo caso não funciona. Se nenhum comando /fito- aparece, comece por Resolver problemas de instalação.

Cada sintoma abaixo nomeia a causa e aponta para a página que traz o relato completo.

Antes de começar

Quatro coisas são verdade em um caso que funciona, e a maior parte dos sintomas daqui é uma delas sendo falsa:

• Você está logado no Fito pelo terminal.
• O gh está instalado e autenticado na conta ligada ao seu perfil do Fito.
• O caso está aberto em ~/.fito/cases/<case-id>/.
• O seu trabalho está commitado no branch de trabalho do caso.

Um caso não abre

O que você vê	O que significa	O que fazer
Um relatório de “case source malformed”, e nenhum branch	A própria .case/ do caso não valida. Nada está errado do seu lado	Tente mais tarde, ou reporte o caso
Uma recusa nomeando um caso aposentado	O caso foi retirado	Escolha outro. Não contorne
⚠ This case has been deprecated…, e então uma abertura normal	O caso está de saída, mas ainda é trabalhável	Siga em frente
Ele não sobrescreve um checkout não vazio	Você já tem este caso aberto	Trabalhe em ~/.fito/cases/<case-id>/
GitHub CLI is not ready — install gh and run 'gh auth login'.	O gh falta ou está deslogado	Instale e rode gh auth login

O relato completo está em Abrir e trabalhar um caso.

O tutor não responde

O que você vê	O que significa
Ele aponta para /fito-case-open e para	Nenhum caso está aberto. O tutor lê o seu clone, e não há o que ler
Unknown tool: subagent	O pi-subagents falta — veja Resolver problemas de instalação
Uma recusa	Você pediu a solução exemplar, o gabarito do quiz ou a chave de pontuação da rubrica

A recusa é estrutural, não é humor

A persona do tutor não tem ferramenta de sistema de arquivos. Ela lê documentos por uma chave enumerada, e a solução, a rubrica e o quiz não têm chave nesse conjunto. Não existe formulação que chegue neles, então insistir não vale o seu tempo. Faça uma pergunta mais estreita — Pergunte ao tutor lista as que funcionam.

Uma avaliação não roda

O /fito-evaluate roda inteiramente no seu disco. Não precisa de login, então login nunca é a causa.

O que você vê	O que significa	O que fazer
Ele não acha o caso	O clone em ~/.fito/cases/<case-id>/ sumiu	Abra o caso de novo
Unknown tool: subagent	Os critérios ai e hybrid da rubrica são julgados por uma persona trabalhadora	Instale o pi-subagents
Um critério tira 0 com a saída capturada	O comando de um critério automated falhou	Leia a saída — ela é mostrada para isso

Um ensaio não registra nada. Rodar de novo também não custa nada. Veja Como um caso é avaliado.

Um envio é recusado

O /fito-submit verifica a sua identidade antes de empurrar qualquer coisa, então uma recusa aqui significa que nada chegou ao GitHub.

O que você vê	O que significa	O que fazer
Your Fito account has no linked GitHub identity…	Nada está ligado	Entre na aplicação web e escolha Continue with GitHub
GitHub account mismatch: your Fito-linked account is @… but gh is authenticated as @…	Duas contas, e o Fito não adivinha	Mova um dos lados para bater com o outro
GitHub CLI is not ready — install gh and run 'gh auth login'.	O próprio gh não está pronto	É problema de instalação, não de conta
The push was rejected: your fork's '<branch>' branch has diverged…	A sua bifurcação já carrega uma tentativa anterior	Não force o push. Abra o caso de novo e escolha Retomar ou Recomeçar

As duas recusas de identidade, e a razão de a verificação vir primeiro, estão em Enviar e ler o seu resultado.

Nunca force um push no branch de um caso

Um push forçado destrói o histórico da tentativa anterior, que é a evidência em que o envio se apoia. Abrir o caso de novo dá a você a mesma escolha com segurança, em duas opções nomeadas: Retomar mantém a branch e o pull request aberto; Recomeçar apaga a branch da bifurcação, o que fecha aquele pull request. As duas estão descritas em Abrir e trabalhar um caso.

Nada aparece no seu perfil

Um envio é registrado depois que o pull request é aberto e a rubrica é pontuada, e não no momento em que você roda o comando.

O que você vê	O que significa
O comando terminou e o perfil não mudou	Rode /fito-submit de novo. É seguro: ele reaproveita o pull request existente e tenta o registro outra vez
As suas tentativas somem da página do caso	Você está deslogado no navegador. /cases/<id> mostra tentativas só a quem está logado
Uma competência não subiu	Um patamar registrado nunca desce, e um resultado menor o deixa onde estava

Onde os resultados aterrissam está em Enviar e ler o seu resultado e em Suas análises de aprendizagem.

Se nada disso resolveu

Junte isto antes de pedir ajuda:

• O comando exato que você rodou, com o id do caso.
• A primeira linha do erro, literal.
• Se ~/.fito/cases/<case-id>/ existe, e se o seu trabalho está commitado lá.
• A saída de gh auth status.

O que vem depois

• Resolver problemas de instalação — quando o problema é a sessão ou os comandos.
• Resolver problemas de autoria — quando você está escrevendo conteúdo em vez de trabalhar um caso.