Agent Skills
返回列表
💻

WordPress 代码守卫

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 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 语义上的上线判断