WordPress PHPStan 存根基线分析

问题背景

在 WordPress 插件、主题或站点仓库中引入 PHPStan 时，常见的失败模式并不是“不会跑”，而是跑出来的结果不可用：核心与第三方 API 的存根（stubs）缺失或版本不符，导致大量误报；配置里的路径过宽，把 vendor/、构建产物、生成文件都扫进来；当团队用 baseline 或 ignoreErrors 处理噪音时，又常把规则开成“大口袋”，把真正的回归也一起吞掉。结果是静态分析有数字、没洞见。

技能如何工作

该技能将 WordPress/agent-skills 中关于 WP PHPStan 的指导整理为一条受控的代理工作流，目标是让分析输出尽快变得可读、可追、可回归：

• 检查现有设置：先审阅仓库当前的 PHPStan 配置、扫描路径与已有忽略项，弄清现状再决定改什么。
• 补齐 WordPress 感知的存根：添加或校验与 WordPress 运行环境匹配的 stubs，让全局函数、钩子与常用 API 的类型信息更贴近真实运行时。
• 收紧配置路径：明确 paths 与扫描范围，避免把不相关目录卷入分析，减少无意义的报告面。
• 只做窄忽略与基线修订：对必须忽略的问题，优先采用窄规则限定到具体标识符、消息或路径；baseline 只做让输出可用所必需的改动，并保留可审计的记录。

适用边界与注意点

• 前置条件是本机已有 PHP、Composer、PHPStan，以及一个真实的 WordPress 插件/主题/站点仓库。
• 它解决的是“分析配置与忽略策略”层面的问题，不是自动修完所有类型错误；仍需开发者逐项确认并修复真实缺陷。
• 基线会随代码演进而变化，应作为阶段性工具纳入评审，避免长期把已知问题固化为“隐形规范”。
• 窄忽略规则依赖消息与标识符的稳定性；当第三方库升级或存根替换时，可能需要同步更新规则。
• 该工作流不承诺覆盖主题与插件生态中的每一种构建方式，不同目录结构仍可能需要人工微调配置。