SKILL.md
readonly只读
name
wp-playground
description
用作 WordPress Playground 路由包装器,处理模糊的 Playground 工作、使用 @wp-playground/cli 的本地 CLI 运行、playground.wordpress.net 分享链接、浏览器预览、快照、挂载、版本切换和 Xdebug。对于 Blueprint JSON 编写或审查,请直接使用 blueprint 技能。
WordPress Playground
这是一个轻量级路由包装器。使用它来选择正确的 Playground 工作流,然后仅加载任务所需的聚焦参考或技能。
步骤
- 识别用户意图:Blueprint 编写/审查、本地 CLI 执行、仅浏览器网站/分享链接工作流、Xdebug/卡住的 CLI 运行,或混合 Playground 请求。
- 路由到下面的聚焦源,仅当请求有多个不同部分时才加载多个源。
- 对于混合请求,将 Blueprint JSON 工作委托给
blueprint,然后返回此处获取运行时、CLI、调试或共享指导。
- Blueprint JSON、模式、步骤、资源、捆绑包或 Blueprint 审查:直接使用
blueprint技能。不要在此处重复 Blueprint 模式细节。 - 本地 CLI 执行:阅读
references/cli.md了解@wp-playground/cli服务器、run-blueprint、build-snapshot、挂载、版本切换和本地验证。 - Xdebug 或卡住的 CLI 运行:阅读
references/debugging.md了解 Xdebug、运行时日志、工作进程标志和卡住的 CLI 运行。 - 仅浏览器 Playground 网站工作流:阅读
references/website.md了解playground.wordpress.net、分享 URL、Blueprint 编辑器、托管捆绑包和浏览器限制。
所需输入
- 预期的工作流:Blueprint 编写、本地 CLI 运行、网站/分享链接、快照或调试。
- 如果需要挂载或打包本地代码,提供项目或捆绑包路径。
- 如果兼容性重要,提供所需的 WordPress/PHP 版本。
- 如果需要本地服务器,提供端口偏好。
- 是否需要仅浏览器共享或本地文件系统访问。
护栏
- Playground 实例是一次性的、基于 SQLite 的环境;切勿将其指向生产数据。
- 将 Blueprint JSON 指导保留在
blueprint中,以便模式和示例有单一事实来源。 - 对于本地 CLI 工作,在运行命令前验证 Node.js 20.18+ 和
npm/npx。 - 仅浏览器 Playground 无法读取本地文件系统路径;请使用公共 URL、托管的 ZIP 捆绑包或内联 Blueprint JSON。
验证
- 对于 Blueprint 内容,根据已发布的模式进行验证,并遵循
blueprint技能的验证。 - 对于本地 CLI 运行,在 Playground 实例中验证挂载的插件/主题或 Blueprint 副作用。
- 对于分享链接,打开生成的 URL 并确认预期的着陆页和已安装的资源加载正常。
失败模式
- Blueprint 工作路由到这里:停止并使用
blueprint技能处理模式键、步骤、资源、捆绑包、验证或 Blueprint 审查。 - 仅浏览器工作流中需要本地文件系统:使用
references/cli.md;playground.wordpress.net无法读取本地文件系统路径。 - 从本地 CLI 工作流请求可共享的浏览器链接:使用
references/website.md;本地服务器 URL 不是可移植的分享链接。 - 调试被视为第二跳参考:直接阅读
references/debugging.md了解 Xdebug、日志、工作进程标志和卡住的 CLI 运行。
升级
- 如果任务需要 Playground 无法提供的 PHP 扩展、原生数据库访问、持久性或类似生产的基础设施,请使用完整的 WordPress 栈,例如 wp-env、Docker 或项目提供的环境。






