用途
WordPress Router 用于在大多数 WordPress 任务的开始阶段进行仓库识别与任务路由。它帮助判断当前代码库属于哪种类型:插件、经典主题、区块主题、WP 核心检出,还是完整站点仓库,并据此选择合适的工作流、防护规则,以及委派给最相关的领域技能。
适用场景是:当用户询问 WordPress 代码库(插件、主题、区块主题、Gutenberg 区块、WP 核心检出),而需要快速对该仓库进行分类时。
主要能力
- 运行项目分诊脚本:
node skills/wp-project-triage/scripts/detect_wp_project.mjs - 读取分诊输出并分类:主要项目类型、可用工具链(PHP/Composer、Node、@wordpress/scripts)、现有测试(PHPUnit、Playwright、wp-env)、版本线索。
- 根据用户意图与仓库类型路由到对应领域工作流。决策树位于:
skills/wordpress-router/references/decision-tree.md。 - 在做出修改前应用防护规则。
使用方式
输入要求
- 仓库根目录(当前工作目录)。
- 用户意图(想修改什么)以及任何约束(目标 WP 版本、WP.com 特殊要求、发布要求)。
操作步骤
- 运行项目分诊脚本:
node skills/wp-project-triage/scripts/detect_wp_project.mjs。 - 读取分诊输出并进行分类:主要项目类型、可用工具链(PHP/Composer、Node、@wordpress/scripts)、现有测试(PHPUnit、Playwright、wp-env)、版本线索。
- 根据用户意图与仓库类型路由到领域工作流,决策树见
skills/wordpress-router/references/decision-tree.md。 - 在修改前应用防护规则:版本约束不明确时进行确认;构建/测试优先采用仓库已有工具链与约定。
验证方式
- 若创建或重构了重要文件,重新运行分诊脚本。
- 运行分诊输出推荐的仓库 lint/test/build 命令(如有)。
失败模式与调试
- 若分诊报告
kind: unknown,检查根目录下的composer.json、package.json、style.css、block.json、theme.json、wp-content/。 - 若仓库巨大,可考虑缩小扫描范围,或为分诊脚本添加忽略规则。
升级处理
若路由存在歧义,只需提出一个问题:“这是打算作为 WordPress 插件、主题(经典/区块),还是完整站点仓库?”
限制
该技能主要承担识别与路由职责,本身不描述具体功能实现细节。资料中未提供其收费、价格、平台支持范围、实际效果数据或更详细的使用步骤,这些信息暂未提供。