SuperAPI AI 工具集

wp-playground-development

测试与质量

查看项目

更新于 10-15 23:41

技能介绍

用途:为基于 WordPress Playground 的演示与可复现环境提供系统化评审指导。核心原则是 Playground 配置应具确定性、可移植,并仅凭 Blueprint 或 CLI 入口即可理解。评审范围涵盖 Blueprint 结构、本地 CLI 用法、嵌入式演示、复现环境以及演示专用的 WordPress 配置。

适用场景:审查 Blueprint JSON 文件;审计嵌入或链接 Playground 的文档;构建零配置的缺陷复现或演示;审查本地工作流或测试中的 Playground CLI 用法;为区块、插件或主题设计可重复环境。不适用于:不涉及 Playground 的常规区块或插件评审、Playground 之外的 WP-CLI 操作、单独的静态分析或 CI 配置。

评审流程:先识别 Playground 入口(Blueprint JSON、Playground CLI 命令、嵌入式 iframe 或 blueprint URL、用于复现问题的本地文档或脚本)。优先检查可复现性,包括必要处显式指定 WordPress 与 PHP 版本、步骤有序且自包含、Blueprint/文档之外无隐藏手动步骤。再审查安装与激活主题/插件、登录、站点选项、内容种子、文件写入/复制/挂载以及 Blueprint 内使用的 WP-CLI 步骤。随后评估开发者体验:他人能否无需猜测重跑、落地页是否有意义、本地与浏览器流程是否清晰分离。最后按严重程度分类发现:CRITICAL(不可复现、隐藏依赖、步骤顺序错误、未记录的外部假设)、WARNING(版本隐式、挂载脆弱、落地页混乱)、INFO(可简化步骤或使用更清晰的 Blueprint 模式)。

检测用搜索模式示例:rg -n "playground|blueprint|@wp-playground" . -g '.{md,json,js,ts,tsx,yml,yaml}';rg -n "run-blueprint|build-snapshot|@wp-playground/cli|npx @wp-playground/cli" . -g '.{md,js,ts,sh,yml,yaml}';rg -n "blueprint-url|playground.wordpress.net|wordpress.org/playground" . -g '*.{md,html,js,ts}'。

输出格式:每条发现需包含严重程度、文件与行号、复现或演示问题摘要、对可靠性或清晰度的影响、建议修复。若无问题,应明确说明,并指出残留不确定性,如版本漂移、缺少复现说明或脆弱的本地挂载。