CommunityEscrita e Ediçãogithub.com

razamwende/doc-agent

Agente Python que documenta código automaticamente: geração de docstrings via LLM (Claude / Ollama), injeção AST, README e CHANGELOG automáticos. Série TP6 de Ferramentas de IA para Desenvolvedores.

O que é doc-agent?

O razamwende/doc-agent é um agente Python especializado em documentação automática de código. Ele utiliza modelos de linguagem (LLMs), como Claude ou Ollama (via execução local), para gerar docstrings completas e precisas, que são injetadas diretamente no código-fonte usando análise de AST (Abstract Syntax Tree). O agente também cria e atualiza, de forma autônoma, arquivos README.md, CHANGELOG.md e outros documentos de projeto. Para desenvolvedores que trabalham com Python, este agente elimina a tarefa repetitiva de escrever documentação manualmente, garantindo que o código, os cabeçalhos de funções, classes e módulos estejam sempre atualizados e padronizados. A ferramenta é ideal para integração em fluxos CI/CD ou como parte de uma esteira de desenvolvimento, sendo compatível com ambientes locais (Ollama) ou APIs de LLMs como Claude. Seu funcionamento baseia-se na análise do código-fonte, extração de assinaturas e tipos, e geração de descrições contextualizadas pelo LLM, que são depois inseridas de volta no código via AST.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add razamwende/doc-agent

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que doc-agent faz?

Agente Python que documenta código automaticamente: geração de docstrings via LLM (Claude / Ollama), injeção AST, README e CHANGELOG automáticos. Série TP6 de Ferramentas de IA para Desenvolvedores.

Fonte: https://github.com/razamwende/doc-agent

Descoberto durante a caça diária de skills agente em awesomeskills.dev.

Habilidades Relacionadas