Pergunte ao tutor

Quando você travar dentro de um caso, pergunte ao tutor:

/fito-tutor como devo abordar isso?

Ele responde sobre o caso que você tem aberto e sobre o conhecimento que aquele caso referencia, e sobre mais nada. Esta página é sobre trabalhar com esse limite em vez de contra ele.

Antes de começar

• O caso está aberto. O tutor lê o seu checkout em ~/.fito/cases/<case-id>/; se ele não existir, a sessão aponta para o /fito-case-open e para.
• Um provedor de LLM está configurado no pi. O tutor roda na sua assinatura, não na do Fito — o servidor não guarda nenhuma chave de LLM.

Fazer uma pergunta

/fito-tutor [<case-id>] [pergunta]

Você raramente precisa nomear o caso. O comando usa o primeiro destes que resolver a questão:

1. um id de caso dado como primeiro argumento
2. o caso aberto antes nesta conversa
3. o checkout em que você está, quando o seu diretório de trabalho fica dentro de ~/.fito/cases/<id>/
4. o único checkout aberto, quando ~/.fito/cases/ tem exatamente um

Quando nenhum deles resolve, o tutor lista o que está aberto — cada caso nomeado pelo seu título e tipo, nunca por um id cru — e pergunta qual você quis dizer. Ele nunca adivinha, porque uma resposta confiante sobre o caso errado parece exatamente uma resposta certa.

Três coisas podem voltar

Uma resposta. Ela mantém os ids dos componentes de conhecimento e os arquivos .case/ em que se apoiou, para você ir às mesmas fontes.

Uma devolução. A sua pergunta está fora do propósito do caso — uma dúvida geral de linguagem, ou algo sobre o seu próprio ferramental. O tutor diz isso e devolve; leve a pergunta à sua própria sessão e siga em frente. A conversa com o tutor continua onde estava.

Uma recusa. Três coisas nunca são entregues: a solução exemplar, o gabarito do quiz e a chave de pontuação da rubrica.

Por que a recusa é estrutural

Essa recusa não é educação, e não é uma regra que se pede ao tutor para cumprir.

A persona do tutor não tem ferramenta de shell nem de sistema de arquivos. A única forma de ela ler algo é uma busca que serve documentos por 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 até eles, porque não existe formato de requisição que os nomeie.

Isso importa quando você está travado. Insistir não vai funcionar, e não vale o seu tempo. Faça outra pergunta:

• “Qual componente de conhecimento este critério cobre?” — dentro do escopo.
• “O que este execution fact quer dizer de fato em tempo de execução?” — dentro do escopo.
• “O que o documento de situação está me dizendo que eu talvez esteja pulando?” — dentro do escopo.
• “Me mostre a solução” — recusado, estruturalmente.

Ele lembra da conversa

A primeira pergunta abre uma conversa, e cada /fito-tutor seguinte volta para o mesmo trabalhador, que ainda guarda tudo o que foi dito até ali. As perguntas de acompanhamento podem ser tão curtas quanto você faria com uma pessoa.

A conversa dura o tempo desta sessão do pi. Feche o terminal e o próximo /fito-tutor começa uma nova — e a sessão avisa você, em vez de deixar você descobrir por um tutor que esqueceu onde vocês estavam.

Uma conversa nova não é um caso perdido

O seu checkout, a sua branch e os seus commits não são tocados por nada disso. Só a conversa recomeça.

O que vem a seguir

• Abrir e trabalhar um caso — o que o tutor consegue ler, e por quê.
• Componentes de conhecimento — o vocabulário que o tutor cita.
• Como um caso é avaliado — a rubrica que o tutor não vai te mostrar.