SuperAPI AI 工具集

changelog-patterns

编程与开发

查看项目

更新于 10-16 02:09

技能介绍

用途

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)。

关于收费、价格、平台支持等具体信息,资料中暂未提供。