路由与分诊：WordPress Agent Skills 如何自动识别项目类型并匹配工作流

路由与分诊WordPress Agent Skills 如何自动识别项目类型并匹配工作流【免费下载链接】agent-skillsExpert-level WordPress knowledge for AI coding assistants - blocks, themes, plugins, and best practices项目地址: https://gitcode.com/gh_mirrors/agents/agent-skillsWordPress Agent Skills是一个开源技能包它为 Claude、Copilot、Cursor 等 AI 编程助手注入专家级 WordPress 知识。其中最核心的机制是「自动路由与项目分诊」当你让 AI 接手一个 WordPress 仓库时它会先自动扫描项目结构识别出这是插件、主题、区块主题还是整站仓库再精准匹配到对应的开发工作流避免 AI 盲目猜测、写出不符合项目规范的代码。为什么需要自动识别项目类型WordPress 生态的项目形态差异很大AI 助手最常见的翻车原因就是用错了套路项目类型典型特征该套用的工作流经典插件根目录 PHP 文件带Plugin Name头hooks、设置页、安全校验区块插件含block.jsonblock.json 属性、渲染、弃用声明区块主题含theme.json templates/patterns 目录theme.json、模板、样式变体经典主题根目录style.css带Theme Name头functions.php、模板继承整站仓库存在wp-content/目录主题 插件混合维护如果 AI 不分诊就直接开写很容易把区块主题当经典主题处理或漏掉仓库里已有的构建与测试工具。Agent Skills 用「分诊 → 路由 → 护栏」三步走解决了这个问题。第一步wp-project-triage 自动分诊分诊能力由 wp-project-triage 技能提供其核心是一个确定性的检测脚本检测脚本detect_wp_project.mjs报告契约triage.schema.json评估场景triage-output-contract.json运行方式只有一条命令在项目根目录执行node skills/wp-project-triage/scripts/detect_wp_project.mjs脚本会自动完成以下体检全程无需人工判断识别项目类型检查wp-includes/version.php核心检出、packages/block-editorGutenberg 仓库、wp-content/整站、style.css主题头、PHP 插件头、block.json、theme.json等关键文件识别工具链检测 Composer、package.json、包管理器npm/yarn/pnpm/bun、是否使用wordpress/scripts识别测试设施PHPUnit、wp-env、Playwright、Jest探测技术信号是否使用 Interactivity API、Abilities API、InnerBlocks、WP-CLI 等推测版本号从核心检出或 Gutenberg 包中提取 WordPress / Gutenberg 版本生成建议命令根据检测到的工具链直接给出lint、test、build、composer install等推荐命令。最终输出一份结构化 JSON 报告包含project.kind可能是多种类型的组合、project.primary按优先级选出的主类型、signals、tooling、versions和recommendations几大板块。类型优先级为gutenberg wp-core wp-site wp-block-theme wp-block-plugin wp-theme wp-mu-plugin wp-plugin保证多类型命中时取最具体的一个。第二步wordpress-router 决策树精准路由拿到分诊报告后wordpress-router 技能接棒按照 decision-tree.md 中的决策树完成路由规则一先看仓库类型再看用户意图。即使用户在整站仓库里提需求也会根据关键词把任务路由到最相关的领域技能你的需求关键词路由到的技能block.json、区块属性、序列化wp-block-developmenttheme.json、全局样式、模板、图案wp-block-themes插件、hooks、设置 API、激活钩子wp-plugin-developmentREST 端点、register_rest_routewp-rest-apiWP-CLI 命令、wp-cli.ymlwp-wpcli-and-opsdata-wp-* 指令、Interactivity APIwp-interactivity-apiPHPStan、静态分析wp-phpstan性能、缓存、查询分析wp-performanceBlueprint JSON、Playgroundblueprint / wp-playground规则二护栏检查Guardrails。路由后 AI 会先确认工具链Composer 还是 npm、优先复用仓库已有的 lint/test 脚本、版本约束不明时主动询问目标 WordPress 与 PHP 版本——而不是直接开工。规则三歧义时只问一个问题。当路由无法确定时它会问一句这是一个 WordPress 插件、主题经典/区块还是整站仓库把打扰降到最低。完整走一个例子为 theme.json 添加排版预设评估用例 router-route-theme-json.json 演示了完整链路新手可以直接对照理解路由启动触发 wordpress-router 对仓库分类自动分诊运行检测脚本发现theme.json存在类型判定识别为区块主题wp-block-theme或含 theme.json 的站点仓库精准路由路由到 wp-block-themes 技能给出建议编辑settings.typography.fontSizes配置排版预设复用工具链调用仓库已有的 build/lint/test 命令验证最终确认检查预设是否出现在编辑器的排版设置中。整个过程 AI 只问了你一个问题要加什么排版预设其余全靠自动识别。如何安装到你的项目安装非常轻量一条命令即可把整套路由分诊能力交给你的 AI 助手npx skills add WordPress/agent-skills --skill wordpress-router也可以同时装上下分诊技能npx skills add WordPress/agent-skills --skill wordpress-router wp-project-triage wp-block-themes安装范围可选全局~/.claude/skills/等目录所有项目通用或项目级.claude/skills/等目录提交进版本库后团队共享。若某技能在两个范围都存在项目级优先生效方便团队针对自己的仓库定制流程。如果希望手动构建与安装可先克隆仓库git clone https://gitcode.com/gh_mirrors/agents/agent-skills cd agent-skills node shared/scripts/skillpack-install.mjs --dest../your-wp-project --targetsclaude,cursor分诊结果不准时怎么办SKILL.md 中给出了明确的排查路径报告kind: unknown时检查根目录的composer.json、package.json、style.css、block.json、theme.json是否齐全确认仓库根目录是否正确仓库很大导致扫描慢或截断时可为检测脚本添加忽略目录默认已忽略node_modules、vendor、dist等创建或重构了重要文件后重新跑一次分诊让报告保持最新。关键文件速查文件作用skills/wordpress-router/SKILL.md路由技能主文档何时用、流程、升级策略skills/wordpress-router/references/decision-tree.md完整决策树类型分类 意图路由 护栏清单skills/wp-project-triage/SKILL.md分诊技能主文档skills/wp-project-triage/scripts/detect_wp_project.mjs检测脚本源码可阅读了解全部检测信号skills/wp-project-triage/references/triage.schema.jsonJSON 报告输出契约eval/scenarios/路由与分诊的评估场景集可对照学习预期行为docs/skill-set-v1.md技能集整体设计说明小结这套「分诊 → 路由 → 护栏」的机制本质上是把资深 WordPress 开发者的判断流程固化成了 AI 可执行的步骤自动识别一条命令摸清项目类型、工具链与测试设施精准匹配按类型优先级与意图关键词把任务路由给最合适的领域技能️护栏兜底动手前先确认工具链与版本约束歧义时只问一个问题。对新手来说这意味着你不需要先搞懂我这个项目该用哪套开发套路——AI 会先替你做完这一步判断再按正确的工作流开始工作。【免费下载链接】agent-skillsExpert-level WordPress knowledge for AI coding assistants - blocks, themes, plugins, and best practices项目地址: https://gitcode.com/gh_mirrors/agents/agent-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考