mcpField
A
advpl-code-review

advpl-code-review

github.com/thalysjuvenal测试与质量19150 次安装6 周前更新
代码仓库

关于 advpl-code-review

用于审查现有 ADVPL 和 TLPP 项目的代码审查技能，面向评估质量、安全性、性能和现代化程度的开发者。结果包含规则 ID、严重级别、位置、问题说明和修复建议，并可映射到 TOTVS SonarQube 质量门禁。

主要功能

  1. 01最佳实践检查
  2. 02性能与安全审查
  3. 03现代化评估
  4. 04规则 ID 与严重级别
  5. 05映射 TOTVS SonarQube 规则

适用场景

  1. 01合并前审查变更
  2. 02部署前检查代码
  3. 03入职期间审计代码库
  4. 04评估迁移到 TLPP 的准备情况

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/thalysjuvenal/advpl-specialist --skill advpl-code-review

安装后在 Claude Code 中输入/advpl-code-review确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

reference.md
rules-best-practices.md
rules-modernization.md
rules-performance.md
rules-security.md
sonarqube-rules-catalog.md

详细介绍

ADVPL/TLPP 代码审查

此技能为现有 ADVPL/TLPP 代码提供系统化的代码审查方法，生成的发现项会标注规则 ID（BP-*、PERF-*、SEC-*、MOD-*）、严重级别（CRITICAL/WARNING/INFO）、文件和行号、问题及修复方案。审查涵盖四个类别：最佳实践、性能、安全性和现代化，并可将发现项映射到官方 TOTVS SonarQube 质量门禁。

当用户希望检查现有代码的质量、合规性、安全性或性能问题时，启用此技能——例如合并前、部署前、入职审计期间，或评估从 .prw 迁移到 .tlpp 的准备情况。此技能不涵盖生成新代码（参见 advpl-code-generation）、诊断具体的运行时或编译错误（参见 advpl-debugging）、在不添加功能的情况下重构代码（参见 advpl-refactoring），或实际执行从 .prw 到 .tlpp 的转换（参见 advpl-to-tlpp-migration）。

参考文件阅读时机
reference.md始终阅读——审查类别、输出格式、严重级别、审查流程、规则 ID 前缀
rules-best-practices.md检查 RecLock/MsUnlock 配对、变量作用域、区域管理、错误处理、文档（BP-* 规则）
rules-performance.md检查 Embedded SQL 效率、循环效率、字符串操作、索引使用（PERF-* 规则）
rules-security.md检查 SQL 注入、输入验证、凭据泄露、敏感数据日志记录（SEC-* 规则）
rules-modernization.md检查 TLPP 迁移候选项、命名空间使用、OOP 模式、现代 UI 框架（MOD-* 规则）
sonarqube-rules-catalog.md将发现项与官方 TOTVS SonarQube 规则集对齐（G1-G5 组、CA/BG/CS 代码）

评论

支持 Markdown