用途：把编码规范文档转成可执行的 PMD 规则，并通过真实 SonarQube 服务器流程验证。完成需端到端链路：规范解析、L1/L2/L3/L4 分类、L1-L2 的 PMD 规则集生成、L3 自动化计划、L4 审查计划、自定义 sonar-pmd 插件打包、Docker 启动 Sonar、测试项目扫描与服务端验证。
主要能力：按分类契约处理条款——L1 用 PMD 内置规则，L2 用 PMD AST XPath 规则，L3 用格式化器、钩子、CI、Checkstyle、Semgrep、ArchUnit 或构建插件等自动化工具，L4 需人工或 AI 审查。每条规范记录 SPEC-ID、原文、目标语言、级别、检测目标、触发条件、例外、严重度、主工具、执行阶段、实现计划，L4 必填审查备注。产出治理工件（mapping/spec-to-governance.csv、rulesets/custom-<lang>-ruleset.xml、automation/l3-tooling-plan.md、manual-review/l4-review-checklist.md、README.md）、自定义插件源码与 JAR、Docker 启动命令与运行证据、测试项目扫描命令与结果摘要、验证报告。
使用方式：需提供规范文件路径、目标语言、插件工作区路径、测试项目路径，可选输出目录（默认 pmd-governance/）与 profile 名（默认 custom-spec-profile）。先读 references/workflow-playbook.md，按需读 plugin-packaging-blueprint.md、docker-sonar-validation.md、sonar-api-evidence-checklist.md，用 scripts/verify_sonar_plugin.sh 做 API 冒烟验证。扫描示例：mvn -DskipTests sonar:sonar -Dsonar.host.url=http://localhost:9000 -Dsonar.token=<token>。可选环境变量包括 ELITEFORGE_SKILL_SONAR_PMD_HOST、TOKEN、PROJECT_KEY、PLUGIN_KEY、RULE_REPO_KEY、PROFILE_KEY，token 不得打印。
适用场景：规范转 PMD 规则、条款自动分级、构建或扩展自定义 Sonar PMD 插件与 profile、用 Docker 与真实扫描验证插件行为、证明自定义规则在 Sonar 中可见并产生问题。
限制：目标语言须被 PMD 及 Sonar 集成路径支持，否则候选归 L3 或 L4 并推荐替代分析器；不得手工伪造 PMD 报告，发现须来自真实分析；L3 不得强塞进 PMD；首次上线默认非阻塞，除非用户明确要求 CI 门禁；未提供 Docker Sonar 与真实扫描证据则验证不完整。