关于 code-explanation
用于解释现有 ADVPL 和 TLPP 代码的技能,适合需要理解例程或代码片段的开发者与业务顾问。它会针对初级、高级或非技术受众调整说明,也可补充原生函数、业务流程或 SQL 背景。
主要功能
- 01面向三类受众的说明
- 02初级开发者逐行讲解
- 03高级开发者逻辑与风险摘要
- 04面向顾问的业务说明
- 05可选原生函数与 SQL 背景
适用场景
- 01帮助开发者熟悉现有代码
- 02理解缺少文档的旧例程
- 03向顾问说明定制功能
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ thalysjuvenal/ advpl-specialist --skill code-explanation安装后在 Claude Code 中输入/code-explanation确认已加载。
附带文件reference.md
详细介绍
ADVPL/TLPP 代码说明
此技能提供了一套用通俗语言说明现有 ADVPL/TLPP 代码的方法,面向三个受众层级:需要逐行详细说明的初级开发者、需要了解业务逻辑概要及风险和技术债务的高级开发者,以及需要从业务角度了解例程功能的非技术职能顾问。
当用户希望了解现有例程、函数或代码片段时,请启用此技能,例如为新开发者提供入门指导、理解没有文档的旧代码,或向职能顾问介绍定制内容。此技能会读取目标代码,确定用户指定的(或询问用户后确定的)说明层级,并据此组织输出;必要时还会补充原生函数的含义、业务流程背景或 SQL 细节。
此技能不适用于生成正式文档类交付物,例如 Protheus.doc 标头或完整的例程规格(请参阅 documentation-patterns),也不适用于单独查询原生函数语法(请参阅 protheus-reference),或深入说明嵌入式 SQL 宏的语义(请参阅 embedded-sql)。
| 参考文件 | 阅读时机 |
|---|---|
| reference.md | 始终阅读——说明层级、各层级的结构(初级/高级/职能顾问)以及分析流程 |
评论
支持 Markdown