Agent skill

changelog-patterns

Use when generating changelogs from code changes - git diffs, file comparisons, release notes

View SKILL.md on GitHub Repository
Stars 116
Forks 22

Install this agent skill to your Project

npx add-skill https://github.com/thalysjuvenal/advpl-specialist/tree/main/skills/changelog-patterns

SKILL.md

Changelog Patterns

Overview

Patterns for generating structured changelogs from ADVPL/TLPP code changes on TOTVS Protheus. Analyzes diffs, identifies change types, and produces formatted release notes.

When to Use

  • Generating changelog for a delivery to the client
  • Creating release notes for a patch or update
  • Documenting what changed between versions
  • Auditing code changes for compliance

Change Types

Type Label Description
NEW [NOVO] Nova funcionalidade ou rotina
FIX [CORRECAO] Correcao de bug
CHANGE [ALTERACAO] Melhoria ou modificacao de comportamento existente
REMOVE [REMOCAO] Funcionalidade ou codigo removido
REFACTOR [REFATORACAO] Mudanca estrutural sem alterar comportamento

Impact Levels

Level Description
ALTO Altera fluxo de negocio, tabelas, ou integracao entre modulos
MEDIO Altera validacoes, calculos, ou comportamento de rotina existente
BAIXO Mudanca cosmetica, refatoracao, ou correcao pontual

Changelog Format — Markdown

markdown
# Changelog — [Nome do Projeto/Pacote]
Data: DD/MM/YYYY
Versao: X.Y.Z

## Resumo
[1-2 frases descrevendo o escopo das mudancas]

## Alteracoes

### [NOVO] Descricao da nova funcionalidade
- **Arquivo:** CadOrdemServico.prw
- **Impacto:** ALTO
- **Detalhes:** Cadastro MVC de Ordens de Servico com tabela customizada ZA1
- **Tabelas afetadas:** ZA1 (nova)

### [CORRECAO] Descricao do bug corrigido
- **Arquivo:** MATA461.prw:145
- **Impacto:** MEDIO
- **Detalhes:** RecLock sem MsUnlock causava lock permanente na SF2
- **Tabelas afetadas:** SF2

### [ALTERACAO] Descricao da melhoria
- **Arquivo:** RelVendas.prw
- **Impacto:** BAIXO
- **Detalhes:** Adicionada coluna de desconto no relatorio
- **Tabelas afetadas:** SC6 (leitura)

Changelog Format — TXT (plain text)

CHANGELOG — [Nome do Projeto/Pacote]
Data: DD/MM/YYYY | Versao: X.Y.Z
============================================

RESUMO: [1-2 frases]

[NOVO] Descricao
  Arquivo: CadOrdemServico.prw
  Impacto: ALTO
  Tabelas: ZA1 (nova)

[CORRECAO] Descricao
  Arquivo: MATA461.prw:145
  Impacto: MEDIO
  Tabelas: SF2

Analysis Process

  1. Get the list of changed files (git diff, file list, or user input)
  2. For each changed file: a. Read the current version b. If git available, get the diff (git diff -- ) c. Identify what changed: new functions, modified functions, removed functions d. Detect tables affected (DBSelectArea, RecLock, BeginSQL patterns) e. Classify the change type (NEW, FIX, CHANGE, REMOVE, REFACTOR) f. Assess impact level (ALTO, MEDIO, BAIXO)
  3. Group changes by type
  4. Generate changelog in the requested format

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

thalysjuvenal/advpl-specialist

advpl-to-tlpp-migration

Use when migrating ADVPL procedural code to TLPP object-oriented code, converting functions to classes, or modernizing legacy Protheus code

116 22
Explore
thalysjuvenal/advpl-specialist

protheus-reference

Use when looking up Protheus native functions, SX data dictionary tables, REST API endpoints, MV parameters, or TOTVS framework documentation

116 22
Explore
thalysjuvenal/advpl-specialist

documentation-patterns

Use when generating technical documentation for ADVPL/TLPP code - Protheus.doc headers, routine docs, API docs

116 22
Explore
thalysjuvenal/advpl-specialist

embedded-sql

Use when writing SQL queries in ADVPL/TLPP using BeginSQL/EndSQL blocks, %table%, %notDel%, %xfilial%, %exp% macros, or when choosing between Embedded SQL and TCQuery string concatenation

116 22
Explore
thalysjuvenal/advpl-specialist

protheus-business

Use when consulting Protheus ERP business processes, module workflows, routines, integrations, or understanding how business operations work in TOTVS Protheus

116 22
Explore
thalysjuvenal/advpl-specialist

advpl-refactoring

Use when refactoring ADVPL/TLPP code - extract functions, simplify logic, remove dead code, improve naming

116 22
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results