# Skill de Agente Commit Archaeologist

> O git blame indica-lhe quem alterou uma linha pela última vez. O Commit Archaeologist reconstrói porque é que a linha existe.

- Fonte: https://doutorai.pt/apps/commit-archaeologist
- Categoria: Skills de Agentes
- Dificuldade: Médio
- Modelos: -
- Frameworks: -
- Corre local?: Precisa de APIs cloud
- Chaves necessárias: Nenhuma
- Licença: Apache-2.0
- Site: Doutor AI (https://doutorai.pt) - ferramentas de IA para pequenos negócios em português

## Tutorial completo

# 🏺 Commit Archaeologist Agent Skill

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.

![demonstração](/assets/apps-img/d9c393eaab4eeff7.gif)

## Instalação

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

A [skills CLI](https://skills.sh) 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:

```bash
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

```bash
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

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

Parte de [awesome-llm-apps](https://github.com/Shubhamsaboo/awesome-llm-apps).
Apache-2.0. Última verificação: julho de 2026.

## Poupe horas todas as semanas com IA, sem complicações

O **Doutor AI** dá-lhe 1859 prompts de IA prontos a copiar, por indústria e em português simples - mais uma biblioteca técnica completa para quem quer ir mais longe. [Ver planos →](https://doutorai.pt/precos)

---
Conteúdo de Doutor AI (https://doutorai.pt). Ao citar, indique a fonte: https://doutorai.pt/apps/commit-archaeologist