用途
该技能提供一套解释现有 ADVPL/TLPP 代码的方法论,目标是用通俗语言说明代码在做什么。它针对三类不同的受众层次进行适配:
- 初级开发者:需要逐行细节的讲解。
- 高级开发者:需要业务逻辑摘要,并附带风险与技术债说明。
- 功能顾问:需要从业务角度出发、不含技术细节的描述,说明该例程做了什么。
主要能力
- 读取目标代码,判断用户请求(或被询问)的讲解层次。
- 按所选层次组织输出结构。
- 视需要引入原生函数含义、业务流程背景或 SQL 细节。
使用方式
当用户希望解释一个已有的例程、函数或代码片段时激活本技能。典型触发场景包括:新开发者入职、理解无文档的遗留代码、向功能顾问说明某项定制。
技能附带的参考文件 reference.md,在其说明中标注为「始终读取」,内容涵盖各讲解层次(初级/高级/功能)的结构,以及分析流程。
适用场景
- 新开发者入职时理解现有代码。
- 理解没有文档的遗留代码。
- 向功能顾问说明某项定制。
限制
该技能不覆盖以下内容:
- 生成正式文档产物,例如 Protheus.doc 头或完整例程规范(另见 documentation-patterns)。
- 单独查询原生函数语法(另见 protheus-reference)。
- 深入解释内嵌 SQL 宏语义(另见 embedded-sql)。
关于该技能的具体收费、价格、平台支持等信息,资料中暂未提供。