SKILL.md
只读
名称
wordpress-router
描述
当用户询问关于 WordPress 代码库(插件、主题、块主题、Gutenberg 块、WP 核心检出)且你需要快速分类仓库并路由到正确的工作流/技能(块、theme.json、REST API、WP-CLI、性能、安全、测试、发布打包)时使用。
WordPress Router
何时使用
在大多数 WordPress 任务开始时使用此技能,以:
- 识别这是哪种 WordPress 代码库(插件 vs 主题 vs 块主题 vs WP 核心检出 vs 完整站点),
- 选择正确的工作流和防护措施,
- 委托给最相关的领域技能。
所需输入
- 仓库根目录(当前工作目录)。
- 用户的意图(他们想要更改什么)以及任何约束(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 插件、主题(经典/块)还是完整站点仓库?”






