SuperAPI AI 工具集

code-explanation

编程与开发

查看项目

更新于 10-16 02:19

技能介绍

用途

该技能提供一套解释现有 ADVPL/TLPP 代码的方法论,目标是用通俗语言说明代码在做什么。它针对三类不同的受众层次进行适配:

  • 初级开发者:需要逐行细节的讲解。
  • 高级开发者:需要业务逻辑摘要,并附带风险与技术债说明。
  • 功能顾问:需要从业务角度出发、不含技术细节的描述,说明该例程做了什么。

主要能力

  • 读取目标代码,判断用户请求(或被询问)的讲解层次。
  • 按所选层次组织输出结构。
  • 视需要引入原生函数含义、业务流程背景或 SQL 细节。

使用方式

当用户希望解释一个已有的例程、函数或代码片段时激活本技能。典型触发场景包括:新开发者入职、理解无文档的遗留代码、向功能顾问说明某项定制。

技能附带的参考文件 reference.md,在其说明中标注为「始终读取」,内容涵盖各讲解层次(初级/高级/功能)的结构,以及分析流程。

适用场景

  • 新开发者入职时理解现有代码。
  • 理解没有文档的遗留代码。
  • 向功能顾问说明某项定制。

限制

该技能不覆盖以下内容:

  • 生成正式文档产物,例如 Protheus.doc 头或完整例程规范(另见 documentation-patterns)。
  • 单独查询原生函数语法(另见 protheus-reference)。
  • 深入解释内嵌 SQL 宏语义(另见 embedded-sql)。

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