Comandos
/explain
Explica codigo ADVPL/TLPP em linguagem simples para desenvolvedores e consultores funcionais
/advpl-specialist:explain
Explica codigo ADVPL/TLPP em linguagem simples, adaptado ao nivel do publico.
Uso
/advpl-specialist:explain <target> [--level level]Niveis
| Nivel | Publico | Saida |
|---|---|---|
junior | Dev iniciante | Explicacao detalhada, linha por linha, sem assumir conhecimento previo |
senior | Dev experiente | Resumo focado na logica de negocio e decisoes de design |
funcional | Consultor funcional | Explicacao sem termos tecnicos, foco no impacto no negocio |
Se --level nao for fornecido, o padrao e junior.
Processo
- Analisar argumentos - Identificar arquivo/trecho alvo e nivel
- Carregar skill de explicacao - Invocar skill
code-explanation - Ler codigo alvo - Ler o arquivo ou interpretar o trecho
- Carregar skills de suporte - Carregar
protheus-reference,protheus-business,embedded-sqlconforme necessario - Analisar codigo - Identificar estrutura, funcoes, variaveis, operacoes de banco, regras de negocio
- Gerar explicacao - Seguir a estrutura apropriada ao nivel do skill
- Apresentar resultado - Explicacao clara e estruturada no idioma do usuario
Exemplos
# Explicar codigo para um desenvolvedor junior (padrao)
/advpl-specialist:explain src/MATA461.prw
# Explicar para um consultor funcional
/advpl-specialist:explain src/CustomFaturamento.prw --level funcional
# Explicar para um desenvolvedor senior
/advpl-specialist:explain src/JobProcessaNF.tlpp --level senior
# Explicar uma funcao especifica
/advpl-specialist:explain src/Utils.prw::fCalcDescontoSaida
Explicacao estruturada adaptada ao publico:
- Junior: Objetivo, includes, variaveis, fluxo passo a passo, funcoes nativas utilizadas, tabelas, avisos
- Senior: Objetivo, logica de negocio, tabelas, dependencias, riscos
- Funcional: O que faz, quando executa, quais dados le/altera, regras de negocio, impacto no modulo