mcpField
W
wp-playground-development

wp-playground-development

github.com/jorgerosal开发11158 次安装20 周前更新
代码仓库

关于 wp-playground-development

面向使用 WordPress Playground 构建的演示和可复现环境的审查技能，帮助开发者检查 Blueprint、命令行工作流、嵌入式演示及设置步骤的清晰度与可复现性。

主要功能

  1. 01Blueprint 结构审查
  2. 02Playground 命令行工作流检查
  3. 03嵌入式演示审查
  4. 04设置可复现性检查
  5. 05按严重程度整理发现

适用场景

  1. 01审查 Blueprint JSON 文件
  2. 02构建可复现的错误报告
  3. 03检查 Playground 命令行用法
  4. 04设计可重复运行的插件或主题演示

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jorgerosal/wordpress-skills --skill wp-playground-development

安装后在 Claude Code 中输入/wp-playground-development确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
blueprint-patterns.md
cli-and-local-workflows.md
embedding-and-repros.md
sample-playground-blueprint.json

详细介绍

WordPress Playground 开发技能

概述

为基于 WordPress Playground 的演示和可复现环境提供系统化审查指南。核心原则： Playground 配置应具有确定性、可移植，并且仅凭 Blueprint 或 CLI 入口即可轻松理解。审查范围包括 Blueprint 结构、本地 CLI 用法、嵌入式演示、复现环境，以及演示专用的 WordPress 配置。

适用场景

适用于：

  • 审查 Blueprint JSON 文件
  • 审查嵌入或链接到 Playground 的文档
  • 构建零配置的 Bug 复现环境或演示
  • 审查本地工作流或测试中的 Playground CLI 用法
  • 为区块、插件或主题设计可重复使用的环境

不适用于：

  • 不涉及 Playground 的常规区块或插件审查
  • Playground 环境之外的 WP-CLI 操作
  • 单独进行静态分析或 CI 配置

代码审查工作流

  1. 确定 Playground 入口

    • Blueprint JSON
    • Playground CLI 命令
    • 嵌入的 iframe 或 Blueprint URL
    • 用于复现问题的本地文档或脚本

  2. 优先检查可复现性

    • 在需要时明确指定 WordPress 和 PHP 版本
    • 步骤有序且自包含
    • Blueprint 或文档之外没有隐藏的手动步骤

  3. 审查配置步骤

    • 主题或插件的安装与启用
    • 登录、站点选项、内容填充
    • 文件写入、复制或挂载
    • Blueprint 中使用的任何 wp-cli 步骤

  4. 审查开发者体验

    • 他人能否无需猜测即可重新运行？
    • 落地页是否有实际意义？
    • 本地流程和基于浏览器的流程是否明确区分？

  5. 对发现的问题分类

    • CRITICAL： 配置无法复现、存在隐藏依赖、步骤顺序错误、未记录的外部假设
    • WARNING： 版本未明确指定、挂载过于脆弱、落地页令人困惑、为一个小问题准备了过于庞大的复现环境
    • INFO： 可以简化步骤、将演示与测试数据拆分，或采用更清晰的 Blueprint 模式

按文件类型检查

Blueprint 文件
  • CRITICAL：缺少必要的配置步骤，导致 Blueprint 无法运行
  • WARNING：版本兼容性很重要，但未明确设置 preferredVersions
  • WARNING：复现依赖 Blueprint 同目录中的文件，但未作说明
  • INFO：可以设置更清晰的 landingPage
Playground CLI 工作流
  • WARNING：本地工作流使用 server 或 start，但挂载未作说明
  • WARNING：未明确说明 Blueprint 路径或自动挂载相关假设
  • INFO：可以使用 run-blueprint 或 build-snapshot，以获得更具确定性的流程
嵌入式演示和复现环境
  • CRITICAL：演示依赖 Blueprint 未记录的手动管理后台配置
  • WARNING：嵌入的示例对于所演示的问题而言过大或过于通用
  • INFO：可以将教学／演示内容与 Bug 复现内容拆分

快速检测的搜索模式（PG-21）

使用以下 rg 命令查找与 Playground 相关的文件和配置逻辑。

Playground 查找
rg -n "playground|blueprint|@wp-playground" . -g '*.{md,json,js,ts,tsx,yml,yaml}'
rg -n "\"steps\"|\"landingPage\"|\"preferredVersions\"" . -g '*.json'
CLI 和嵌入流程
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}'
复现步骤
rg -n "\"step\": \"(login|wp-cli|installPlugin|installTheme|writeFile|mkdir|cp|mv|enableMultisite)\"" . -g '*.json'

参考文件

  • references/blueprint-patterns.md - Blueprint 结构、步骤选择和确定性配置
  • references/cli-and-local-workflows.md - @wp-playground/cli、挂载、本地工作流和快照用法
  • references/embedding-and-repros.md - 嵌入式演示、Blueprint URL 和问题复现模式
  • references/sample-playground-blueprint.json - 用于本地测试或调整的最小可复现 Blueprint 示例文件

输出格式（PG-23）

每项发现都应包含：

  1. 严重性：CRITICAL、WARNING 或 INFO
  2. 文件和行号
  3. 复现或演示问题摘要
  4. 该问题为何影响 Playground 的可靠性或清晰度
  5. 建议的修复方案

如果未发现问题，请明确说明，并指出任何尚存的模糊之处，例如版本漂移、缺少复现说明或脆弱的本地挂载。

评论

支持 Markdown