Skill 安装
多 Agent 安装npx skills add https://github.com/automattic/wordpress-activitypub --skill integrations
使用 npx skills 快速安装,支持将 Skill 添加到多个兼容的 AI Agent。
Skill 调研报告
Skill 详细介绍
automattic/wordpress-activitypub#integrations 是 WordPress ActivityPub 插件仓库中 integrations(第三方集成) 这一子模块相关的 Skill 标识。它对应的真实项目是 Automattic 官方维护的 WordPress ActivityPub 插件,该插件让 WordPress 站点接入 Fediverse(联邦宇宙),也就是 Mastodon、Misskey、Pleroma、Pixelfed 等去中心化社交网络所在的 ActivityPub 协议生态。
需要先说明的是:它不是一套独立运行的软件,也不是一个可以在命令行里单独启动的程序。它依附于 WordPress 站点本身运行。WordPress ActivityPub 插件本质是一个 WordPress 插件(Plugin),安装激活后由 WordPress 的 PHP 后端加载,负责把站点的文章、作者、评论等内容按 ActivityPub 协议对外发布,同时接收来自 Fediverse 的互动。
#integrations 这一部分,关注的是插件与第三方服务、第三方插件、第三方平台的对接与集成能力。围绕这个插件,常见的集成方向包括:
- WordPress 站点与 Mastodon 等 Fediverse 实例的账号映射与关注关系同步
- 与缓存插件、CDN、安全插件、SEO 插件的兼容处理
- 与其它 WordPress 多站点、多作者、自定义内容类型(Custom Post Type)的集成
- 与 WebFinger、NodeInfo 等联邦协议端点相关的站点级配置
- 与 ActivityPub 生态中其它实现的互操作性适配
它主要解决的问题是:把原本封闭的 WordPress 博客或内容站点,变成 Fediverse 里可被关注、可被转发、可被评论的联邦节点。安装并正确配置后,Agent 或站点管理员获得的能力,通常是围绕插件的部署、配置、排障、兼容性检查给出建议或操作指引,而不是由 Agent 自己变成社交机器人。
它不是什么:
- 不是 Mastodon 客户端,不替代负责发帖的社交 App
- 不是通用 WordPress 管理 Skill,只针对 ActivityPub 这一插件的联邦与集成能力
- 不是独立的 Node/Python 工具,也不是 MCP Server
- 不是内容抓取或舆情监控工具
适合的用户:
- 运营 WordPress 独立博客、希望内容同步到 Fediverse 的站长
- 自建 Mastodon / Misskey 实例,希望和自己的 WordPress 站点互相打通的人
- 需要排查 ActivityPub 联邦失败、WebFinger 报错、跨站互动异常的技术人员
不太适合的需求:
- 只想在普通社交平台做批量发帖运营
- 完全不使用 WordPress、也不想接触 PHP 环境
- 希望用纯自然语言一键搞定所有联邦协议细节,且不打算了解站点端任何配置
Skill 安全评估
总体判断:这个 Skill 对应的上游项目来自 Automattic,属于信誉良好、长期维护的开源组织,来源层面的可信度较高;风险主要集中在 WordPress 站点本身的运行权限和联邦协议暴露面,而不是 Skill 自身会偷偷做危险操作。
围绕这个 Skill,真正需要关注的安全点如下。
一、来源可信度
WordPress ActivityPub 插件由 Automattic 维护,托管在公开的 GitHub 仓库中。使用时应以官方仓库和 WordPress 官方插件目录为唯一来源,不要从第三方打包、汉化站、来历不明的镜像下载安装包,否则容易引入被篡改的插件代码。
二、运行权限
WordPress 插件运行在网站服务器的 PHP 环境中。ActivtyPub 插件一旦激活,会注册 REST 端点、改写部分请求路由、参与站点内容对外暴露。这意味着它是运行在网站进程内的代码,权限等同于 WordPress 站点的权限。如果站点本身已经存在漏洞,插件的联邦端点也可能成为攻击面之一。
三、网络与公网暴露
这个插件的核心作用就是把内容发布到公网、并允许外部 Fediverse 实例来访问。也就是说,它会主动扩大站点的公网可见范围。这不是漏洞,而是功能本身。使用前应确认:
- 站点是否允许内容被联邦分发
- 是否有需要隐藏的私密内容、内部信息
- 是否配置了合理的 robots / 缓存 / 限流策略
四、数据与隐私
作者名称、站点域名、文章公开内容、部分互动信息会随联邦协议传播到其它实例,并且一旦被其它实例缓存,通常无法回收。这是去中心化协议的固有特性,不是插件缺陷。发布前应想清楚哪些内容适合联邦、哪些不适合。
五、第三方集成风险
#integrations 涉及与缓存插件、安全插件、CDN 的配合。这类集成可能在改动后导致联邦端点被缓存、被误拦截或签名校验失败。修改站点配置后,应回归测试 WebFinger、Actor 端点、跨站关注是否仍然正常。
降低风险的建议:
- 只在可信来源安装插件,核对插件目录中的官方条目
- 先在测试站点(staging)验证联邦行为,再上生产站点
- 不要用管理员账号随便安装来路不明的“集成增强”插件
- 如果只是让 Agent 帮助生成配置或排障思路,可以让 Agent 只做建议、不自动执行 Shell 命令,由你自己手动执行
不存在“绝对安全”的插件。是否安全,取决于你的站点运维水平、内容敏感程度,以及你如何管理服务器权限。
Skill 使用要求
一、Agent / 客户端
这个 Skill 的官方来源是 WordPress 插件项目,本身并不绑定某一个特定 AI Agent。它与 Claude Code 这类能直接读文件、执行 Shell、修改项目代码的 Agent 配合时比较顺手,因为联邦排障往往需要查看站点目录、日志、配置文件。
官方没有提供完整的第三方 Agent 兼容列表。从 Agent Skill 的一般工作方式看,在支持自定义 Skill、文件读写或命令执行机制的 Codex、Cursor、Trae、OpenClaw、WorkBuddy 等环境中,通常也可以尝试使用,但不同 Agent 的 Skill 加载方式和权限模型不同,实际效果可能不一样,具体以对应 Agent 当前版本为准。
二、运行环境 / 依赖
| 项目 | 要求 |
| Agent | Claude Code 等可读写项目的 Agent 更合适,其他兼容 Agent 可尝试 |
| WordPress | 需要,插件的实际运行平台 |
| PHP | 需要,WordPress 运行依赖;具体版本以官方插件要求为准 |
| 数据库 | 需要,WordPress 自带依赖 |
| 网络 | 需要,联邦功能要求站点可被公网访问 |
如果只是让 Agent 帮助分析代码、查阅文档、给出配置建议,本地不一定需要完整的 WordPress 环境。如果要做实际部署和排障,就需要一个可运行的 WordPress 站点。
三、权限
- 文件读取:可选,用于查看插件代码、配置、日志
- 文件写入:可选,只有在你希望 Agent 直接改文件时才需要
- Shell:可选,用于执行 WP-CLI、查看服务状态、跑测试
- 网络:可选,用于查询官方文档、检查联邦端点
- 数据库:可选,站点排障时可能用到
四、账号 / API Key
Skill 本身不需要任何账号、API Key 或 Token。如果你要真正运行 WordPress ActivityPub,需要的是:
- 一个 WordPress 站点的管理员权限
- (可选)一个 Fediverse 账号,用于验证联邦是否正常
这些是站点侧的需要,不是 Skill 本身的需要。
最小使用条件
- 一个 AI Agent(优先支持文件读取的)
- 一个可访问的 WordPress 站点(做实际部署时)
- 站点管理员权限(做实际配置时)
Skill 安装、使用与卸载教程
一、安装
本页面已提供该 Skill 的安装指令,直接复制并粘贴到对应的 Agent 或终端执行即可。
如果你不清楚自己的 Agent 该如何安装,可以直接这样问它:
如何安装 automattic/wordpress-activitypub#integrations?
如何在 Claude Code 中安装 automattic/wordpress-activitypub#integrations?
如何在 Cursor 中安装 automattic/wordpress-activitypub#integrations?
让当前 Agent 根据它自己的 Skill 加载与管理机制来指导安装,通常比自己拼命令更稳妥。
需要区分两层含义:一层是把这个 Skill 装进你的 AI Agent;另一层是在真实 WordPress 站点上装 WordPress ActivityPub 插件。后者应通过 WordPress 后台的插件安装界面,或官方插件目录来完成,不要用第三方来源的安装包。
二、安装后如何使用
安装之后,任务的触发方式通常是:你在对话中直接描述和 WordPress ActivityPub 相关的需求,Agent 就会按这个 Skill 的指引去处理。适合交给它的任务包括:
- 解读插件的配置项与联邦行为
- 排查 WebFinger、Actor 端点、跨站关注等联邦问题
- 分析与缓存、CDN、安全插件的兼容性
- 给出多站点、多作者场景下的集成建议
自然语言使用示例:
使用 wordpress-activitypub 的 integrations 能力,帮我检查这个 WordPress 站点接入 Fediverse 的配置是否正确。
使用 wordpress-activitypub 的 integrations 能力,分析一下为什么我的站点在 Mastodon 上搜不到。
使用 wordpress-activitypub 的 integrations 能力,看看这个缓存插件会不会影响联邦端点。
三、卸载
分两种情况。
如果你要卸载的是 AI Agent 里的 Skill:不同 Agent 的 Skill 安装位置和管理方式不一样。比较稳妥的做法是直接问当前 Agent:
如何卸载 automattic/wordpress-activitypub#integrations?
也可以使用 Agent 或 Skill 管理器自带的删除方式移除对应 Skill。
如果你要卸载的是 WordPress 站点上的 ActivityPub 插件:在 WordPress 后台的插件列表里停用并删除即可,这属于 WordPress 的标准操作,不依赖任何外部命令。
常见问题
问:这个 Skill 会不会自动改我的 WordPress 站点?
不会自动改。Skill 本身只是给 Agent 提供处理此类任务的指引与知识。真正是否修改文件、执行命令,取决于你给 Agent 的权限以及你的指令。如果只想让它分析、不动站点,可以在提问时明确说明“只分析,不要执行任何修改”。
问:我的 WordPress 站点在后台装了 ActivityPub 插件,还需要装这个 Skill 吗?
两者不是一回事。WordPress 插件是站点本身的功能;这个 Skill 是给你在 AI Agent 里做配置、排障、集成分析时用的辅助能力。是否需要,取决于你是否希望让 Agent 参与这项工作。
问:可以同时把这个 Skill 装到多个 Agent 里吗?
从一般的 Skill 机制看通常可以,具体能否共用同一份配置、是否会冲突,取决于各 Agent 的 Skill 加载方式。如有疑问,直接问对应 Agent 最准确。
问:中国大陆使用有网络要求吗?
这个 Skill 对应的上游项目不在中国大陆平台,核心目标也不是中国本土生态。如果只是让 Agent 分析、给建议,通常不涉及特殊网络要求;如果要访问上游 GitHub 仓库或 WordPress 官方插件目录,能否顺畅访问取决于你的网络环境。
问:为什么安装后 Agent 好像没识别到这个 Skill?
常见原因有:Skill 未放在 Agent 约定的加载目录、Agent 当前版本尚未支持 Skill 机制、或安装后没有重启 / 重新加载。先确认 Agent 是否支持 Skill,再确认安装位置,最后尝试让 Agent 自己列出已加载的 Skill。
问:这个 Skill 更新后需要重新安装吗?
不太可能自动完成。多数 Agent 的 Skill 更新方式是按 Skill 逐个处理的,是否需要重装,取决于是何种安装方式。稳妥做法是问当前 Agent:“如何更新这个 Skill?”
问:它和普通的 WordPress 管理类 Skill 有什么区别?
普通 WordPress 管理类 Skill 通常覆盖文章、用户、主题、通用插件的日常操作;这个 Skill 专门针对 ActivityPub 与 Fediverse 联邦、以及第三方集成兼容问题。它的知识面更窄,但在联邦协议排障上更聚焦。