用途
changelog-patterns 是一个用于 TOTVS Protheus 平台的技能,专门从 ADVPL/TLPP 代码变更中生成结构化的变更日志、发布说明或交付文档。当用户希望基于一组代码变更生成面向客户或内部的变更日志、发布说明或交付文档时,可激活此技能。
主要能力
该技能定义了一套分析流程,用于处理 ADVPL/TLPP 代码变更(通过 git diff 或提供的文件列表),并产出结构化变更日志,具体包括:
- 变更类型分类:将变更归类为 NEW、FIX、CHANGE、REMOVE、REFACTOR,并使用葡萄牙语标签。
- 影响级别评估:评估变更的影响程度,分为 ALTO、MEDIO、BAIXO。
- 受影响数据库表检测:通过识别 DBSelectArea、RecLock、BeginSQL 等模式,检测变更所影响的数据库表。
- 输出格式:支持以 Markdown 或纯文本格式输出变更日志。
使用方式
当用户请求生成变更日志、发布说明或交付文档,且提供了代码变更(git diff 或文件列表)时,激活此技能。技能会依据 reference.md 中定义的变更类型、影响级别、Markdown/TXT 变更日志格式以及完整分析流程进行处理。reference.md 是该技能唯一的参考文件,应始终阅读。
适用场景
- 需要从一组代码变更生成面向客户的变更日志。
- 需要生成内部使用的发布说明。
- 需要生成交付文档。
限制
该技能不涵盖以下内容:
- 从无 diff 上下文的单一源文件生成文档头或技术例程规格——这更接近文档生成任务,不属于此技能的 diff 分析流程范围。
- 代码审查发现(参见 advpl-code-review)。
- .prw 到 .tlpp 转换的迁移清单(参见 advpl-to-tlpp-migration)。
关于收费、价格、平台支持等具体信息,资料中暂未提供。