Skill de Agente Commit Archaeologist

O git blame diz-lhe quem alterou uma linha pela última vez. O Commit Archaeologist reconstrói o motivo pelo qual essa linha existe.

Aponte-o para um ficheiro monitorizado e para um intervalo de linhas opcional. O respetivo script Python local identifica o commit que introduziu a linha, ordena as modificações posteriores, classifica as mensagens de commit, resume a autoria atual, deteta ficheiros alterados repetidamente em conjunto e assinala referências a issues, reverts, soluções alternativas, escolhas temporárias e TODOs. O agente transforma essa evidência num histórico legível e numa nota de risco de alteração.

Instalação

npx skills add https://github.com/Shubhamsaboo/awesome-llm-apps/tree/main/agent_skills/commit-archaeologist

A skills CLI instala a pasta para agentes de programação compatíveis. Também pode copiar este diretório para o diretório de skills de um agente.

Executar

Pergunte ao seu agente:

Porque é que as linhas 40-72 de src/cache.py existem, e o que devo saber antes de as alterar?

Ou execute o núcleo determinístico a partir de um clone deste repositório:

python3 agent_skills/commit-archaeologist/scripts/archaeologist.py \
  /path/to/repo src/cache.py --lines 40-72 --json

Omita --lines para seguir todo o histórico do ficheiro. Omita --json para

obter um resumo compacto no terminal.

Saída

O relatório JSON do dig contém:

• a região normalizada, os aliases históricos de caminhos e o limiar de coalterações
• o commit de introdução
• uma cronologia do mais antigo para o mais recente, com os ficheiros alterados e as categorias de intenção
• as coalterações repetidas e os commits que as suportam
• as contagens atuais de linhas blame, juntamente com as contagens históricas de commits
• sinais de intenção baseados nos assuntos e nos corpos das mensagens de commit

Tudo é executado localmente com a biblioteca padrão do Python e o git. O script

é apenas de leitura e não efetua chamadas de rede.

Verificação

python3 agent_skills/evals/commit-archaeologist/test_archaeologist.py

O eval constrói o seu próprio repositório temporário e verifica a ordenação, os co-changes, a autoria, os sinais de intenção, o JSON determinístico e os erros de validação.

Ficheiros

commit-archaeologist/
|-- SKILL.md
|-- README.md
|-- scripts/archaeologist.py
`-- references/reading-git-history.md

Parte de awesome-llm-apps.

Apache-2.0. Última verificação: julho de 2026.