Agent Skills for WordPress
Agent Skills for WordPress 是一套便携式的指令、检查清单和辅助脚本集合，旨在教导 AI 助手如何“正确地”构建 WordPress，让它们能够理解 WordPress 的开发模式、避开常见陷阱并严格遵循最佳实践。
🤔 为什么我们需要 Agent Skills？
尽管 AI 编程助手能力出众，但在 WordPress 开发中，它们经常会出现以下“幻觉”或疏漏：
- 生成过时的代码模式：仍然使用 Gutenberg 之前或 Block Themes 之前的旧版 WordPress 模式。
- 忽视安全考量：在插件开发中遗漏关键的安全检查机制。
- 跳过区块弃用（Deprecations）：导致前端出现“无效区块（Invalid block）”的报错。
- 无视现有工具链：忽略项目中已经配置好的构建、测试或代码规范工具。
Agent Skills 通过将“专家级 WordPress 知识”转化为 AI 能够直接读取和执行的标准化格式，完美解决了上述痛点。
🛠️ 核心技能库一览
Agent Skills 涵盖了现代 WordPress 开发的方方面面，以下是目前可用的核心技能：
| 技能名称 | 教授内容 |
|---|---|
| wordpress-router | 识别 WordPress 仓库类型并路由到正确的工作流 |
| wp-project-triage | 自动检测项目类型、工具链和版本号 |
| wp-block-development | Gutenberg 区块开发：block.json、属性、渲染与弃用处理 |
| wp-block-themes | 区块主题：theme.json、模板、模式（Patterns）与样式变体 |
| wp-plugin-development | 插件架构、钩子（Hooks）、设置 API 与安全机制 |
| wp-rest-api | REST API 路由/端点、Schema、认证与响应数据塑形 |
| wp-interactivity-api | 使用data-wp-* 指令和 Store 实现前端交互 |
| wp-abilities-api | 基于能力的权限控制与 REST API 认证 |
| wp-abilities-audit | 审计插件的 REST 接口并提出 Abilities API 注册建议 |
| wp-abilities-verify | 验证插件的 Abilities API 注册是否与其声明的注解一致 |
| wp-wpcli-and-ops | WP-CLI 命令、自动化、多站点管理与搜索替换 |
| wp-performance | 性能分析、缓存策略、数据库优化与 Server-Timing |
| wp-phpstan | 针对 WordPress 项目的 PHPStan 静态分析（配置、基线、WP 专属类型） |
| wp-playground | WordPress Playground 路由、CLI 运行、浏览器预览与快照 |
| wpds | WordPress 设计系统 (Design System) |
| wp-plugin-directory-guidelines | WordPress 插件目录官方指南 |
| blueprint | 用于声明式环境设置的 WordPress Playground Blueprints |
| wp-env | 使用@wordpress/env 进行本地开发：配置、WP-CLI、Xdebug 与故障排除 |
⚙️ 它是如何工作的？
每个 Skill 都是一个独立的文件夹，包含主指令、参考文档和可选的辅助脚本。当要求 AI 助手处理 WordPress 代码时，它会读取这些 Skill 并遵循文档中记录的标准化流程，而不是“凭空猜测”。
skills/wp-block-development/
├── SKILL.md # 主指令文件（使用时机、操作流程、验证方法）
├── references/ # 特定主题的深度参考文档
│ ├── block-json.md
│ ├── deprecations.md
│ └── ...
└── scripts/ # 确定性辅助脚本（如检测、验证工具）
└── list_blocks.mjs
Agent Skills for WordPress 填补了通用 AI 模型与 WordPress 专业开发领域之间的知识鸿沟。通过引入这套技能包，您和您的团队可以大幅提升 AI 辅助编程的准确性与代码质量，让 AI 真正成为懂 WordPress 的“高级开发专家”。
v1.0.1
2026-09-22
下载