1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | wp-interactivity-api（WordPress 官方 Agent Skills 合集子技能） | GitHub API |
| 作者/维护者 | WordPress.org 官方项目账号；子目录由 Automattic 员工共同维护，其中包括 WordPress Interactivity API 本身的架构师 Luis Herranz | GitHub API |
| 来源链接 | https://github.com/WordPress/agent-skills/tree/trunk/skills/wp-interactivity-api | — |
| 许可证 | GPL-2.0-or-later（仓库 LICENSE 文件明确写明） | 网页抓取（LICENSE 原文） |
| GitHub Stars / Forks | 1,953 / 288（整个合集仓库口径，覆盖 18 个子技能） | GitHub API |
| 最新版本 | README 自评 “v1”，无正式 Git Release/Tag | 网页抓取（README） |
| 安装方式 | npx skills add 单命令安装 / 仓库脚本批量安装 / 手动复制目录 |
网页抓取（README） |
2. 功能介绍与亮点
覆盖 WordPress Interactivity API（data-wp-* 指令、@wordpress/interactivity 的 store/state/actions、区块 viewScriptModule 集成）的开发与调试全流程：
- 六步排查流程：检测现有用法与集成方式（区块级/主题级/插件级）→ 定位 store 定义 → 服务端渲染最佳实践 → 安全修改指令 → 构建工具对齐 → 常见故障模式排查。
- 服务端渲染详解：用
wp_interactivity_state()、wp_interactivity_data_wp_context()在 PHP 端预渲染初始状态，避免“客户端 JS 加载前出现布局抖动”这类常见问题，并给出派生状态需在 PHP 端复制一份逻辑的具体写法。 - WordPress 6.9 版本变更提醒：
data-wp-ignore已废弃、同一元素上多个同类型指令可用---分隔符区分命名空间、新增AsyncAction/TypeYieldTypeScript 类型、客户端导航时getServerState()/getServerContext()会在页面切换间重置。 - 配套 3 篇参考文档：
server-side-rendering.md（服务端渲染详解）、directives-quickref.md（指令速查）、debugging.md（调试指南）。 - 该技能目录的 GitHub CODEOWNERS 指派由 Luis Herranz（Automattic，专职负责 WordPress Interactivity API）本人发起 Pull Request 提出，将其所在的
@WordPress/interactivity-api团队设为该目录的正式代码所有者——即这个 WordPress 核心前端特性的原班开发团队直接参与维护对应的 Agent 技能内容。
3. 适用场景
所属分类：前端与设计
面向 WordPress 主题、插件、区块开发者，尤其是使用 Claude Code、Codex 等 AI 编程助手处理 Interactivity API 相关任务的初中级开发者。典型场景：排查“指令写了但不触发”、“服务端渲染内容和客户端水合（hydration）后不一致导致首屏闪烁”等常见故障；把已有前端交互逻辑迁移到 Interactivity API 规范写法；升级到 WordPress 6.9 后确认代码是否踩中 data-wp-ignore 废弃等破坏性变更。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——官方 README 专门列出
.claude/skills/项目级与全局两种安装路径。 - Codex：✅ 原生支持——
.codex/skills/专属路径，仓库安装脚本明确以 Codex 为目标之一。 - OpenClaw：⚠️ 未见专门验证——README 明确列出的目标客户端为 Claude Code、Cursor、Codex、VS Code Copilot、Antigravity，未点名 OpenClaw；理论上可经通用第三方安装器（
npx skills add）尝试安装，但仓库自身文档未专门测试。 - Hermes Agent：⚠️ 同上，未见专门验证。
5. 推荐理由
WordPress Interactivity API 本身是较新且仍在快速演进的前端框架（6.9 版本刚引入过破坏性变更），开发者常在“指令为什么不触发”、“为什么会有首屏闪烁”这类问题上反复试错。这份技能把六步排查流程、服务端渲染要点与版本变更细节整理成可直接执行的procedure，而且其维护直接由该功能的原班架构团队通过 CODEOWNERS 机制接管，内容的准确性有直接背书，不是社区二次转译的说明文档。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 子目录自身 8 次提交、3 位作者（含 Automattic 员工），且 WordPress Interactivity API 的实际架构师 Luis Herranz 专门发起 Pull Request，提议将其所在团队设为该技能目录的正式 Code Owner；另有独立开发者 Derin Tolu 提交文档补充 Pull Request、Inpsyde 机构工程师 widoz 反馈兼容性问题，形成多个独立来源的真实参与 |
| 可用性 | 9 | 单份 SKILL.md（6,187 字节）+ 3 篇参考文档，完整覆盖排查流程、验证步骤与失败模式；子目录最近一次提交为 2026-07-08，近期仍在维护；WordPress 核心与该技能均免费，无付费依赖 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令及权限范围 | 无 scripts 目录、无 shell 执行；SKILL.md 中的 PHP/JS 代码均为示例片段，供开发者在自己项目中编写，技能本身不代为运行 |
| ② 运行时联网外发 | 无网络请求，纯本地代码编写指导 |
| ③ API Key/凭据存储 | 不涉及任何凭据 |
| ④ 可疑指令 | 未发现 prompt injection 或隐蔽指令迹象 |
| ⑤ 作者信誉 | WordPress.org 官方项目账号出品，Interactivity API 本人架构师参与维护，无造假迹象 |
| ⑥ License | GPL-2.0-or-later，明确 |
| ⑦ 最近维护 | 2026-07-08 有提交，非弃置项目 |
综合评分（三项均值）：8.33
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与本技能的差异 |
|---|---|---|
| WordPress Block Editor Handbook（官方静态文档） | 网页形式的 Interactivity API 参考手册 | 需要开发者自行阅读检索、手动比对项目代码，不含面向 AI Agent 的排查流程整理，也不会主动定位“指令不触发”一类问题的根因 |
@wordpress/create-block-interactive-template（官方脚手架模板） |
用 @wordpress/create-block 命令行生成新交互式区块的初始代码骨架 |
与本技能是互补关系：脚手架负责从零生成新区块的骨架代码，本技能负责调试与优化已有交互逻辑、服务端渲染与水合一致性，而非相互替代 |
| Automattic/wordpress-agent-skills | 实验性原型集合，专注“用自然语言描述直接生成整站主题并部署到本地 Studio 站点” | 聚焦一键生成整站原型，官方自述“早期阶段”，不涉及对已有 Interactivity API 代码的排查与优化 |
8. 用户评价
该技能子目录本身尚无第三方平台的具名用户评价。但可查证到独立开发者 Derin Tolu 通过 Pull Request（#15）尝试为其补充 WordPress 6.9 客户端导航相关的文档说明（未被合并）；Inpsyde 机构工程师 widoz 通过 issue（#16）反馈 compatibility 字段在部分 AI 客户端下会触发兼容性警告（该问题同时影响仓库内其他技能，官方尚未处理）。
9. 安装使用方式
- 单技能安装：
npx skills add WordPress/agent-skills --skill wp-interactivity-api - 批量/全局安装：克隆仓库后执行
node shared/scripts/skillpack-build.mjs --clean构建分发包，再执行node shared/scripts/skillpack-install.mjs --global（写入~/.claude/skills/等目录）或指定--dest=安装进具体项目 - 手动安装：直接复制
skills/wp-interactivity-api/目录到对应 AI 助手的技能目录 - 安装后注意：无需重启，AI 助手下次读取项目/全局技能目录时即可发现该技能；同仓库的
wp-block-development（区块开发）与wp-project-triage（自动项目类型检测）覆盖前端开发的其他环节，可按需搭配安装
10. 注意事项
- SKILL.md 声明面向 WordPress 7.0+（PHP 7.4.0+），部分工作流需要 WP-CLI 或
@wordpress/scripts构建环境 data-wp-ignore已在 WordPress 6.9 废弃，若项目仍运行在较旧版本需自行判断技能内容的适用范围- 内容由 AI 生成后经 WordPress 贡献者人工审核编辑，遇到跨版本细节仍建议对照官方 Interactivity API 文档做最终确认
- OpenClaw、Hermes Agent 的兼容性未经仓库官方文档专门验证
- 该技能所属
WordPress/agent-skills合集仓库整体 Stars/Forks 反映的是全部 18 个子技能的合计热度，不代表本技能单独的使用规模