🟦 advpl-dev — Claude Skill para Desenvolvimento ADVPL/TLPP

Skill para o Claude.ai que transforma o assistente em um especialista em desenvolvimento ADVPL e TLPP para o ecossistema TOTVS Protheus.

---

📌 O que é uma Skill do Claude?

Skills são arquivos de conhecimento especializado que você instala no Claude.ai para que ele responda como um expert em um domínio específico. Esta skill ensina o Claude as boas práticas, convenções, padrões e armadilhas do desenvolvimento no ecossistema TOTVS Protheus.

---

✨ O que esta Skill cobre

Área	Conteúdo
Fundamentos	Tipos de dados, Notação Húngara, escopos de variáveis, limite de 10 chars
Estrutura	Protheus.doc, User/Static/Public Function, organização de fontes
Banco de Dados	RecLock/MsUnlock, BeginTran/EndTran, TCQuery, xFilial(), D_E_L_E_T_
Pontos de Entrada	PE convencional (PARAMIXB) e PE MVC (IDPonto/cIDModel)
MVC	ModelDef, ViewDef, Controller, FwMBrowse, FWFormModel
REST API	TLPP com @Get/@Post annotations e WSRestful clássico
Tratamento de Erros	Begin Sequence/Recover, Try/Catch TLPP, ErrorBlock
Performance	Regras críticas de performance, locks, SQL vs ISAM
Nomenclatura	Padrões para fontes, funções, variáveis, classes, includes
TLPP	Tipagem forte, namespaces, nomes longos, annotations REST
Funções	Catálogo de ~60 funções essenciais com exemplos
Tabelas SX	Dicionário de dados: SX2, SX3, SX5, SX6, SB1, SA1 e mais
Erros Comuns	Diagnóstico e soluções para os erros mais frequentes

---

📁 Estrutura do Repositório

advpl-dev/
├── SKILL.md                          ← Skill principal (carregada pelo Claude)
├── README.md                         ← Este arquivo
└── references/
    ├── funcoes-essenciais.md         ← ~60 funções ADVPL com exemplos
    ├── tabelas-sx.md                 ← Tabelas SX* e tabelas de dados do ERP
    └── erros-comuns.md               ← Erros frequentes e como resolver

O arquivo advpl-dev.skill (bundle instalável) está disponível na aba Releases.

---

🚀 Como Instalar no Claude.ai

Pré-requisito

Você precisa de uma conta Claude.ai Pro ou superior para usar o recurso de Skills.

Passo a passo

1. Baixe o arquivo da skill

   • Vá até a aba Releases deste repositório
   • Baixe o arquivo advpl-dev.skill da versão mais recente

2. Acesse as configurações do Claude

   • Abra claude.ai
   • Clique na foto do seu perfil (canto superior direito)
   • Selecione Settings (Configurações)

3. Instale a Skill

   • No menu lateral, clique em Skills
   • Clique em Install skill ou Upload skill
   • Selecione o arquivo advpl-dev.skill baixado

4. Ative e use

   • A skill aparecerá na sua lista com o nome advpl-dev
   • Agora basta conversar com o Claude sobre ADVPL/TLPP que ele usará o conhecimento desta skill automaticamente

---

💬 Exemplos de Uso

Depois de instalar, experimente perguntar ao Claude:

"Crie um ponto de entrada MVC para a rotina MATA010 que valide o campo B1_PESO"

"Como fazer uma consulta SQL no Protheus filtrando por filial e sem registros excluídos?"

"Qual a diferença entre RecLock e DBAppend? Quando usar cada um?"

"Crie uma API REST em TLPP que retorne o saldo em estoque de um produto"

"Quais são as boas práticas de nomenclatura de variáveis em ADVPL?"

"Como fazer tratamento de erro em ADVPL para garantir que o MsUnlock sempre seja chamado?"

---

📚 Fontes e Referências

Esta skill foi construída com base nas documentações oficiais da TOTVS:

• 📖 TDN TOTVS — Guia de Boas Práticas ADVPL
• 📖 TDN TOTVS — Tipos de Dados
• 📖 TDN TOTVS — REST / TLPP
• 📖 TDN TOTVS — Funções AdvPL
• 📖 TDN TOTVS — Criação de Variáveis
• 📖 Central de Atendimento TOTVS — PE MVC
• 📖 Central de Atendimento TOTVS — Lista de PE MVC
• 📖 TOTVS Developers — ADVPL Dúvidas Básicas
• 📖 TOTVS Blog — TLPP

---

🤝 Contribuindo

Contribuições são muito bem-vindas! Se você encontrou algo desatualizado, quer adicionar uma nova seção (ex.: relatórios com FWMSPrinter, integração SOAP, WebAgent) ou corrigir algum exemplo:

1. Faça um fork do repositório
2. Crie uma branch: git checkout -b feature/nova-secao
3. Edite os arquivos .md em advpl-dev/
4. Abra um Pull Request com descrição do que foi alterado

O que ainda pode ser adicionado

• Seção de relatórios com FWMSPrinter / SetPrintServer
• Integração com WebService SOAP
• Configuração do ambiente TDS / VS Code
• Padrões para WebAgent e portais
• Exemplos de classes OO avançadas
• Integração com TEF e NFe

---

📄 Licença

Distribuído sob a licença MIT. Veja LICENSE para mais informações.

---

Nota: TOTVS, Protheus, ADVPL e TLPP são marcas registradas da TOTVS S.A. Este projeto é uma contribuição independente da comunidade e não tem vínculo oficial com a TOTVS.