尧图网页设计 
WordPress Agent Skills 静态分析PHPStan 配置、基线管理与 WordPress 类型注解完整指南【免费下载链接】agent-skillsExpert-level WordPress knowledge for AI coding assistants - blocks, themes, plugins, and best practices项目地址: https://gitcode.com/gh_mirrors/agents/agent-skills本文介绍WordPress Agent Skills项目中的wp-phpstan技能它教会 AI 编程助手如何在 WordPress 插件/主题中正确配置PHPStan 静态分析、管理phpstan-baseline 基线并用 WordPress 专用的PHPDoc 类型注解修复类型错误。适合刚接触静态分析的 WordPress 开发者阅读。什么是 wp-phpstan 技能agent-skills是一套WordPress 专家知识包每个技能都是可移植的说明清单脚本集合。其中 wp-phpstan 技能专门覆盖四类场景新建或更新phpstan.neon/phpstan.neon.dist配置生成与维护phpstan-baseline.neon基线用 WordPress 友好的类型注解修复 PHPStan 报错REST 请求、钩子、查询结果安全处理第三方插件的类stubs / autoload / 定向忽略该技能要求先运行wp-project-triage完成项目识别再进入 PHPStan 工作流程。快速上手一条命令探测 PHPStan 入口动手改配置前先弄清这个仓库是用什么命令跑 PHPStan 的——优先复用仓库已有的composer脚本配置、内存限制、bootstrap 都更一致而不是自己猜。运行检测脚本即可生成一份结构化报告node skills/wp-phpstan/scripts/phpstan_inspect.mjsphpstan_inspect.mjs 会扫描composer.json中调用 PHPStan 的脚本、检测vendor/bin/phpstan、定位配置文件与基线文件并给出推荐执行命令例如composer run phpstan。WordPress 项目的 phpstan.neon 推荐配置参考 configuration.md 中的保守模板核心原则只有三条只分析第一方代码paths聚焦插件/主题自身目录排除生成与第三方代码vendor/、node_modules/、构建产物ignoreErrors保持窄而分组按依赖归类并加注释说明parameters: level: 5 paths: - src/ - includes/ excludePaths: - vendor/ - node_modules/ - tests/ ignoreErrors: # 仅在必要时添加定向例外另外绝大多数 WordPress 仓库必须加载核心 stubs如szepeviktor/phpstan-wordpress或php-stubs/wordpress-stubs否则会收到大量未知核心函数的报错。WordPress 类型注解让 PHPStan 理解钩子与 REST APIWordPress 的动态特性让 PHPStan 难以推断类型wordpress-annotations.md 给出了四类高频场景的注解模式REST 端点用phpstan-param WP_REST_Requestarray{...}标注请求参数PHPStan 随即知道get_param()返回的类型钩子回调为add_action回调的每个参数写准确的param类型数据库结果用arrayobject{id: int, name: string}等形状描述查询返回Action Scheduler为任务回调的$args声明数组形状小技巧复杂的请求参数可以定义phpstan-type复用类型避免重复书写。处理第三方插件类先 stubs后定向忽略遇到 Class WC_Order not found 这类报错时third-party-classes.md 给出了明确的优先级确认依赖真实存在该插件确实被安装/需要优先使用 stub 包如php-stubs/woocommerce-stubs、php-stubs/acf-pro-stubs并通过scanFiles/bootstrapFiles确保 PHPStan 真的扫描到它们最后才是定向ignoreErrors正则只覆盖特定 vendor 前缀如Elementor\并覆盖unknown class、invalid type等错误变体每条都要加注释仓库内的评测场景 phpstan-fix-third-party-class.json 就完整演练了未知第三方类 → 优先 stubs → 窄化忽略的标准流程。基线管理迁移工具不是垃圾堆对遗留代码一次性生成基线、之后逐步消化是正确姿势vendor/bin/phpstan analyse --generate-baseline phpstan-baseline.neon三条纪律来自 configuration.md不要把新引入的错误加进基线新代码直接修基线变更视同代码变更在 PR 中审查修复根因后及时从基线中删除对应条目基线只减不增常见故障排查症状处理方向启用后错误量爆炸缩小paths、增加excludePaths、从低 level 起步再逐步提高Class not found先检查 autoloading/stubs再考虑窄忽略模式钩子/REST 参数类型不一致加显式 PHPDoc 注解而非运行时防御代码小结wp-phpstan技能把 WordPress 静态分析的最佳实践浓缩为一条清晰流水线探测入口 → 加载 stubs → 保守配置 → 注解修错 → 窄化忽略 → 基线只减不增。将这些技能安装到你的 AI 编程助手中它就能按同样的规范帮你搭建和维护 PHPStan而不是随手ignoreErrors一把梭。更多技能的设计理念与打包方式可参阅 docs/principles.md 和 docs/packaging.md。【免费下载链接】agent-skillsExpert-level WordPress knowledge for AI coding assistants - blocks, themes, plugins, and best practices项目地址: https://gitcode.com/gh_mirrors/agents/agent-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 WordPress Agent Skills 静态分析：PHPStan 配置、基线管理与 WordPress 类型注解完整指南
WordPress Agent Skills 静态分析PHPStan 配置、基线管理与 WordPress 类型注解完整指南【免费下载链接】agent-skillsExpert-level WordPress knowledge for AI coding assistants - blocks, themes, plugins, and best practices项目地址: https://gitcode.com/gh_mirrors/agents/agent-skills本文介绍WordPress Agent Skills项目中的wp-phpstan技能它教会 AI 编程助手如何在 WordPress 插件/主题中正确配置PHPStan 静态分析、管理phpstan-baseline 基线并用 WordPress 专用的PHPDoc 类型注解修复类型错误。适合刚接触静态分析的 WordPress 开发者阅读。什么是 wp-phpstan 技能agent-skills是一套WordPress 专家知识包每个技能都是可移植的说明清单脚本集合。其中 wp-phpstan 技能专门覆盖四类场景新建或更新phpstan.neon/phpstan.neon.dist配置生成与维护phpstan-baseline.neon基线用 WordPress 友好的类型注解修复 PHPStan 报错REST 请求、钩子、查询结果安全处理第三方插件的类stubs / autoload / 定向忽略该技能要求先运行wp-project-triage完成项目识别再进入 PHPStan 工作流程。快速上手一条命令探测 PHPStan 入口动手改配置前先弄清这个仓库是用什么命令跑 PHPStan 的——优先复用仓库已有的composer脚本配置、内存限制、bootstrap 都更一致而不是自己猜。运行检测脚本即可生成一份结构化报告node skills/wp-phpstan/scripts/phpstan_inspect.mjsphpstan_inspect.mjs 会扫描composer.json中调用 PHPStan 的脚本、检测vendor/bin/phpstan、定位配置文件与基线文件并给出推荐执行命令例如composer run phpstan。WordPress 项目的 phpstan.neon 推荐配置参考 configuration.md 中的保守模板核心原则只有三条只分析第一方代码paths聚焦插件/主题自身目录排除生成与第三方代码vendor/、node_modules/、构建产物ignoreErrors保持窄而分组按依赖归类并加注释说明parameters: level: 5 paths: - src/ - includes/ excludePaths: - vendor/ - node_modules/ - tests/ ignoreErrors: # 仅在必要时添加定向例外另外绝大多数 WordPress 仓库必须加载核心 stubs如szepeviktor/phpstan-wordpress或php-stubs/wordpress-stubs否则会收到大量未知核心函数的报错。WordPress 类型注解让 PHPStan 理解钩子与 REST APIWordPress 的动态特性让 PHPStan 难以推断类型wordpress-annotations.md 给出了四类高频场景的注解模式REST 端点用phpstan-param WP_REST_Requestarray{...}标注请求参数PHPStan 随即知道get_param()返回的类型钩子回调为add_action回调的每个参数写准确的param类型数据库结果用arrayobject{id: int, name: string}等形状描述查询返回Action Scheduler为任务回调的$args声明数组形状小技巧复杂的请求参数可以定义phpstan-type复用类型避免重复书写。处理第三方插件类先 stubs后定向忽略遇到 Class WC_Order not found 这类报错时third-party-classes.md 给出了明确的优先级确认依赖真实存在该插件确实被安装/需要优先使用 stub 包如php-stubs/woocommerce-stubs、php-stubs/acf-pro-stubs并通过scanFiles/bootstrapFiles确保 PHPStan 真的扫描到它们最后才是定向ignoreErrors正则只覆盖特定 vendor 前缀如Elementor\并覆盖unknown class、invalid type等错误变体每条都要加注释仓库内的评测场景 phpstan-fix-third-party-class.json 就完整演练了未知第三方类 → 优先 stubs → 窄化忽略的标准流程。基线管理迁移工具不是垃圾堆对遗留代码一次性生成基线、之后逐步消化是正确姿势vendor/bin/phpstan analyse --generate-baseline phpstan-baseline.neon三条纪律来自 configuration.md不要把新引入的错误加进基线新代码直接修基线变更视同代码变更在 PR 中审查修复根因后及时从基线中删除对应条目基线只减不增常见故障排查症状处理方向启用后错误量爆炸缩小paths、增加excludePaths、从低 level 起步再逐步提高Class not found先检查 autoloading/stubs再考虑窄忽略模式钩子/REST 参数类型不一致加显式 PHPDoc 注解而非运行时防御代码小结wp-phpstan技能把 WordPress 静态分析的最佳实践浓缩为一条清晰流水线探测入口 → 加载 stubs → 保守配置 → 注解修错 → 窄化忽略 → 基线只减不增。将这些技能安装到你的 AI 编程助手中它就能按同样的规范帮你搭建和维护 PHPStan而不是随手ignoreErrors一把梭。更多技能的设计理念与打包方式可参阅 docs/principles.md 和 docs/packaging.md。【免费下载链接】agent-skillsExpert-level WordPress knowledge for AI coding assistants - blocks, themes, plugins, and best practices项目地址: https://gitcode.com/gh_mirrors/agents/agent-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考