wordpress-router
作者 WordPresswordpress-router 是一个用于 WordPress 分流判断的技能，能在修改前快速识别仓库类型，并将代理路由到合适的工作流。它适用于插件、经典主题、区块主题、Gutenberg、WordPress core 检出仓库以及完整站点仓库，因此很适合用于 Agent Orchestration。
该技能得分 77/100，说明它很适合作为目录用户的 WordPress 工作入口路由器。仓库提供了足够的真实工作流价值证据，能帮助代理识别 WordPress 代码库，并以比通用提示更少的猜测，将任务路由到正确的下游技能；但它并不是一个端到端的完整工作流技能。
- 触发条件明确：描述直接面向 WordPress 代码库以及多数 WordPress 任务的起点，并清楚列出了仓库类型和意图。
- 操作性强：SKILL.md 提供了分步流程，包括运行 triage 脚本并使用决策树进行路由。
- 安装决策价值高：决策树引用和护栏说明了具体的路由行为，而不是空泛的占位内容。
- 路由依赖外部 triage 脚本 (`wp-project-triage/scripts/detect_wp_project.mjs`)，因此用户需要能使用配套工具。
- 该技能侧重分类与分派，而不是直接实现；对于期待独立任务工作流的用户来说，可能会显得功能有限。
wordpress-router 技能概览
wordpress-router 是一个 WordPress 分流技能，帮助 agent 快速归类仓库，并在动手修改前选择正确的下游工作流。它最适合用户需求比较宽泛，或者代码库可能是 plugin、classic theme、block theme、Gutenberg package、WordPress core checkout，或完整站点仓库的场景。
这个 wordpress-router 技能是做什么的
wordpress-router 的作用是“分流”，不是“编辑”。它的任务是通过识别仓库类型、可用工具、可能会跑哪些测试，以及下一步最适合使用的领域技能，来减少前期猜测。
谁应该安装它
如果你经常处理 WordPress 代码库，并且需要 agent 判断一个仓库应该按 blocks、theme.json、REST、WP-CLI、安全、测试还是发布打包来处理，那么就应该安装 wordpress-router。它尤其适合在混合型 WordPress 仓库之间做 agent orchestration。
为什么它很重要
如果没有 router，agent 很容易套用错误的心智模型：把 block theme 当 classic theme 来理解，把 site repo 当 plugin 来处理，或者直接做泛化修改，而不是走正确的 WordPress 工作流。这个技能增加了一道实用的分类步骤，能提升下游提示词质量，并降低不必要改动的概率。
如何使用 wordpress-router 技能
安装并找到决策路径
先按文档中说明的路径安装 wordpress-router，然后从 SKILL.md 开始阅读。仓库里还指向了 references/decision-tree.md，这是后续理解分流决策最有用的补充阅读。
提供给技能正确的输入
当你提供以下信息时，wordpress-router 的效果最好：
- 仓库根目录或当前工作目录，
- 用户的真实意图，
- 版本约束，例如 WordPress 目标版本或 WP.com 要求，
- 对工具链、发布流程或测试的任何硬性限制。
像“修一下这个 WordPress 仓库”这样的弱请求，很难被准确分流。更强的请求会像这样：“这是一个 wp-content 仓库；请判断应该按 block theme 还是 plugin 工作流处理，然后为一个带现有测试的模板修改规划最安全的路径。”
首次使用时建议的工作流
- 运行
SKILL.md中描述的项目分流步骤。 - 阅读分流输出，确认项目类型、工具链和测试覆盖情况。
- 打开
references/decision-tree.md，把意图映射到下一步工作流。 - 编辑前先遵守仓库约定，尤其是已有的构建和测试命令。
在仓库里先检查什么
对于 wordpress-router 指南，优先顺序应当是：
SKILL.md：查看分流流程和护栏，references/decision-tree.md：查看基于意图的路由规则，- 只有在你已经确认项目类型之后，再看仓库特定文档。
这个顺序很重要，因为这个技能本来就是先缩小路径，再去看其他内容。
wordpress-router 技能常见问题
wordpress-router 能替代领域技能吗？
不能。它是 Agent Orchestration 的前置决策技能。它帮助你选对 WordPress 工作流，但一旦仓库类型已经明确，它不能替代 block、theme、plugin 或 testing 相关技能。
什么时候不该用 wordpress-router？
当任务已经很窄、很明确时就可以跳过，比如在一个清晰定义的工作流里修改单个已知文件。只要没有分流歧义，它的价值就会明显下降。
初学者安装 wordpress-router 值不值？
值得，前提是初学者很可能会接触多种 WordPress 仓库类型。它比通用提示词更安全，但仍然要求用户把意图和约束说清楚。
它和普通 prompt 比有什么优势？
普通 prompt 可能只会要求做某个改动；wordpress-router 会先判断这是什么类型的 WordPress 系统，以及应该由哪种工作流来约束这次改动。这个额外的分类步骤，就是 wordpress-router 技能的核心优势。
如何改进 wordpress-router 技能
提供更清晰的意图，而不只是一个任务
最好的输入会同时说明目标结果和仓库上下文。例如，不要只说“让它更快”，而要说“这是一个 WordPress plugin 仓库；请判断性能工作应按 plugin、REST 还是 block 工作流处理，然后给出最安全的起始路径”。
补充会影响分流的约束
如果你提供 WordPress 版本目标、发布要求和工具限制，这个技能的表现会更好。这些细节能帮助它判断仓库应该按 core、site、theme、plugin，还是 Gutenberg 相关工作来处理。
留意常见失败模式
最常见的问题是上下文不足。如果 agent 无法判断自己面对的是 block theme、classic theme、plugin 还是 site repo，那么下一步工作流就可能选错。另一个失败模式是跳过决策树，直接开始改代码。
第一次分类后继续迭代
第一轮结束后，让 agent 复述：
- 仓库类型，
- 最可能的下游技能，
- 它用来做判断的文件，
- 仍然未解决的主要不确定性。
这样能让 wordpress-router 在 Agent Orchestration 中更有用，因为你可以在代码修改开始之前先纠正路线。