WordPress 代码守卫
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/amelnagdy-guard-skills-wp-guard。
技能介绍
要解决什么问题
AI 生成的 WordPress 代码在演示里往往「能跑」,上线后却集中暴露同一类故障:请求数据未经 esc_* 直接 echo、AJAX 没有 nonce 与 current_user_can()、SQL 用字符串拼接、用户可见文案硬编码英文、posts_per_page => -1 在大站上拖死查询,以及用自写逻辑替代核心已提供的 API。这类问题 WPCS 能抓一部分样式问题,但无法替代你对 可利用漏洞 与 生产流量 的判断。
技能如何工作
WP Guard 在实现完成后做 guard-pass(也可在编写时 live 模式,或纯 review 模式 出结构化报告)。它会先对齐项目里的 CLAUDE.md、phpcs.xml、composer.json 与前缀约定,再按规则审查 diff 或目标文件:
- 安全(必须修):输出侧 escape、输入侧
wp_unslash+ sanitize、状态变更双重校验 capability 与 nonce、$wpdb->prepare()占位符查询 - 平台纪律:
wp_remote_*、enqueue、钩子存在性、公开符号前缀、ABSPATH门禁 - 国际化:用户可见字符串的可翻译包装、字面量 text domain、复数与日期/数字本地化
- 性能:禁止无界查询与循环内重复查库,远程调用与重计算走 transient/对象缓存
交付前还会跑 self-check(grep echo、未包装 i18n、未验证钩子等);与 clean-code-guard 同装时,通用代码质量归后者,WordPress 专项归本技能。
适用边界
它不跑 PHPCS、PHPStan 或 Plugin Check,也不替你定插件架构或业务逻辑;WooCommerce 场景若已装 woo-guard 应一并启用,否则需自行对照官方 HPOS/结账文档。
使用场景
- 用 Agent 生成主题或插件的 AJAX 回调后,在提交 PR 前对 diff 执行 guard-pass 并修掉无 nonce 的写操作
- 客户点名 audit 存量插件,按 review-checklist 分组输出 Must fix / Should fix 级 findings,不在 review 模式擅自改码
- WPML 或多语言站上新设置页,编写时 live 模式阻塞检查每个用户可见字符串是否具备可翻译包装
- 与 clean-code-guard 同时启用:合并补丁里先过通用整洁度,再用本技能过转义、权限与 `$wpdb->prepare`
适合人员
- 接 WordPress 定制单的自由开发者,习惯用 AI 批量改 `functions.php`,交付前要把 XSS/CSRF 类漏洞挡在客户环境之外
- 维护大型内容站的插件作者,站点文章量达百万级,需要禁止无界 `WP_Query` 与循环内重复 meta 查询
- 上架前自查安全的 WooCommerce 扩展开发者,在 HPOS 与结账流程里核对钩子是否存在、REST 路由权限是否非 `__return_true`
- Agency 内负责审查同事或 Bot 提交的插件补丁,项目已配 WPCS 但仍要补一层 WordPress 语义上的上线判断