diagnostico
Skill0 starsChanged 3 days agoMITView on GitHub
Faz o gancho das lições achar o Python da máquina. Pergunta ao usuário se ele tem Python e onde, procura nos lugares de costume do Windows, grava o caminho no golem.local.toml da pasta principal e testa o gancho. Use quando aparecer o aviso "Gancho das lições falhou (nenhum Python 3.8+ encontrado...)", quando o usuário disser "diagnóstico do Golem", "o gancho não acha o Python", "configurar o Python" ou invocar /diagnostico.
- Installs packages
1 other project uses a version of this.
Adopted by
Most recently taken up by
- guiloureiromkt/ultra-skillstheir own version, first seen Oct 21, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- guiloureiromkt/ultra-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository15 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- adrSkill
- auditar-specsSkill
- changelogSkill
- configurarSkill
- constituicaoSkill
- implementar-faseSkill
- iniciar-conversaSkill
- iniciar-sddSkill
- licaoSkill
- replanejar-roadmapSkill
- sessao-gerenteSkill
- spec-de-faseSkill
- validar-faseSkill
The file
Files
Diagnóstico do Golem: o Python do gancho
Lê: o golem.local.toml da pasta principal do repositório, se existir.
Escreve: a linha python = '<caminho>' do golem.local.toml da pasta principal e, com o ok do
usuário, a linha golem.local.toml no .gitignore, se faltar, e, com o sim ao modo sem Python, a
linha gancho = "desligado" no golem.toml da raiz da sessão (que viaja no git) e a linha do
gancho no bloco "Como o Golem trabalha aqui" do AGENTS.md. Não instala nada.
Decide: nada sozinha. Pergunta antes de procurar, e grava o que achou só depois do ok do
usuário. Esta é a versão mínima: o resto do diagnóstico (o sh, o git, o índice) fica para depois.
Por que existe: o gancho procura o Python na linha python, no .venv, no PATH e nos lugares do
instalador do Windows. Fora disso, ele não acha, e o aviso dele diz onde procurou, não que a
máquina não tem Python (lição sem-python-no-path-nao-e-maquina-sem-python).
1. Ver o que já existe
principal=$(dirname "$(git rev-parse --path-format=absolute --git-common-dir)")
grep -Hn '^[[:space:]]*python[[:space:]]*=' "$principal/golem.local.toml" 2>/dev/null
git -C "$principal" check-ignore -q golem.local.toml && echo ignorado || echo "NÃO ignorado"- A pasta principal é a do repositório, e não a do worktree: o
golem.local.tomlnão viaja para os worktrees, e o gancho o procura lá se a raiz da sessão não tiver a linha. - Se já há uma linha
pythonna pasta principal, mostre-a ao usuário: ela será substituída no fim. - Se o arquivo não está ignorado pelo git, diga isso e proponha a linha
golem.local.tomlno.gitignoreantes de gravar. O caminho é desta máquina e traz o nome do usuário.
2. Perguntar
Pergunte com botões (no Claude Code, a ferramenta de pergunta), ou em texto numerado onde não houver botões: "Você tem Python instalado nesta máquina?"
- Sim, e sei onde
- Sim, mas não sei onde
- Não sei
- Não
3. Agir conforme a resposta
| Resposta | O que fazer |
| Sim, e sei onde | Peça o caminho do python.exe (ou do python). Tire as aspas duplas, se ele colar com elas. Se o caminho tiver aspa simples ('), recuse e peça outro: a linha não a aceita. Teste (passo 4). Se rodar, grave (passo 5). Se não rodar, diga isso e ofereça a busca. |
| Sim, mas não sei onde | Procure (passo 4). Mostre o que achou e grave depois do ok. Se não achar nada, dê o comando de instalação (passo 6). |
| Não sei | O mesmo que a anterior. |
| Não | Faça a mesma busca. Se achar, pergunte: "Achei um em .... Quer usar este?". Se não achar, dê o comando de instalação (passo 6). |
4. Procurar e testar
Um candidato só vale se rodar um Python 3.8+. O teste imprime o caminho completo do Python que
rodou, e é esse caminho que se grava, sempre: o gancho só aceita um arquivo que existe, e não um
nome solto (python3) nem um caminho relativo.
"<candidato>" -c 'import sys; sys.exit(1) if sys.version_info < (3, 8) else print(sys.executable)'Para o py.exe, o lançador, ponha -3 depois do caminho: a linha python não leva o -3, e por
isso se grava o Python que ele acha, e não o próprio py.exe.
A busca olha o PATH e os lugares do instalador oficial do Windows, que costumam ficar fora dele:
command -v python3 python py
ls "$LOCALAPPDATA"/Programs/Python/Python3*/python.exe \
"$LOCALAPPDATA"/Programs/Python/Launcher/py.exe \
"$PROGRAMFILES"/Python3*/python.exe 2>/dev/null- Teste cada um. Um
pythonemWindowsAppscostuma ser o atalho da Microsoft Store, que não roda sem o Python da loja instalado: o teste decide. - Fora do Windows, a busca é só o PATH.
5. Gravar
No golem.local.toml da pasta principal, troque a linha python que já houver. Se o arquivo
existe sem ela, acrescente-a. Se não existe, crie-o com:
# Gravado pela skill diagnostico do Golem. Fica fora do git: o caminho é desta máquina.
python = 'C:\Users\<usuario>\AppData\Local\Programs\Python\Python312\python.exe'O caminho vai entre aspas simples: no TOML, elas guardam a barra invertida do Windows como
está. Aspas duplas tornam o \U inválido. Um caminho com aspa simples (') não se grava, venha
ele do usuário ou da busca: o gancho o cortaria nela. Diga isso ao usuário e peça outro Python.
6. Nada achado: o comando de instalação
Mostre o comando e peça que o usuário o rode no terminal dele. Não o rode você.
winget install -e --id Python.Python.3.14 --scope user- O número no id muda a cada versão do Python:
winget search Python.Pythonlista as que existem. - O
--scope userinstala só para este usuário, sem pedir administrador. Depois, o passo 4 acha o Python novo, onde quer que ele tenha ficado. - Sem o
winget, o instalador está em python.org. Fora do Windows, use o do sistema (brew install python,sudo apt install python3).
Depois da instalação, volte ao passo 4.
Se o usuário não quiser instalar agora, ofereça o modo sem Python: a linha
gancho = "desligado" no golem.toml da raiz desliga o gancho e o aviso, e as lições passam a
ser buscadas à mão em docs/licoes/. Com o sim, ponha a linha gancho = "desligado" no
golem.toml da raiz (crie o arquivo se não existir), mostrando a mudança antes; o resto da
configuração fica como está (docs/guia-configuracao.md). Sem Python, o aplicar não roda: troque
à mão, no bloco "Como o Golem trabalha aqui" do AGENTS.md, só a linha do gancho por esta, que é
a que o aplicar gera:
- **Gancho das lições:** desligado: antes de editar um arquivo ou rodar um comando, procure em `docs/licoes/` as lições que citam o nome dele.Com o modo sem Python, pule o passo 7: o gancho desligado sai vazio sem procurar o Python, e
a saída vazia não diz nada sobre ele. Diga ao usuário que as lições ficam para buscar à mão em
docs/licoes/. Quando esta pergunta vem pela skill configurar, é ela quem oferece o modo sem
Python.
7. Testar o gancho
echo '{"tool_input":{"command":"pytest -q"}}' | sh "$(git rev-parse --show-toplevel)/.claude/hooks/gancho.sh"- A entrada vai sem
session_id: assim, o gancho não esconde a lição nem o aviso numa segunda rodada. - Leia o motivo entre parênteses, e não só a palavra "falhou":
- "nenhum Python 3.8+ encontrado": o gancho ainda não acha o Python. Volte ao passo 2.
- "licoes_relevantes.py saiu com código N": o Python foi achado e rodou. Mostre o motivo ao usuário; ele fica para o diagnóstico completo.
- "não achei .claude/hooks/licoes_relevantes.py": o gancho parou antes de procurar o Python, e o teste não diz nada sobre ele. Mostre o motivo ao usuário: falta o arquivo do kit.
- Se a saída traz uma lição, ou sai vazia, o Python rodou. Vazia quer dizer só que nenhuma lição
casa com
pytestneste projeto.
Conte ao usuário o que foi gravado e onde, e o resultado do teste.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

