Skill 安装
多 Agent 安装npx skills add https://github.com/automattic/wp-calypso --skill dashboard-create-screen
使用 npx skills 快速安装,支持将 Skill 添加到多个兼容的 AI Agent。
Skill 调研报告
Skill 详细介绍
automattic/wp-calypso#dashboard-create-screen 是 WordPress.com 母公司 Automattic 开源前端项目 wp-calypso 仓库中的一个具体 Skill,聚焦于 Calypso 后台仪表盘的「创建类」界面(Dashboard Create Screen)。Calypso 是 WordPress.com 与 Jetpack 所使用的现代 JavaScript 单页应用控制台,采用 React、Redux、TypeScript 等技术栈,与传统的 WordPress wp-admin 后台是两套不同的前端。
需要明确的是:
– 它不是一个可以独立运行的软件,本身不提供 CLI,也不是 npm 包。
– 它是 wp-calypso 仓库中与「Dashboard Create Screen」相关页面 / 组件 / 交互逻辑配套的开发 Skill 或代码上下文能力,用来辅助 AI Agent 在理解 Calypso 代码规范的前提下处理该界面的开发任务。
– 它解决的核心问题:让 AI Agent 在涉及 Calypso 后台创建界面(如创建站点、创建页面、创建文章等 Dashboard Create 相关流程)时,能按仓库既有的目录结构、组件模式、状态管理和样式约定来生成或修改代码。
核心用途与典型任务:
– 在 wp-calypso 仓库中定位和理解 Dashboard Create Screen 相关组件
– 按 Calypso 现有约定新增或修改创建流程页面
– 与 Calypso 的 Redux 状态、路由、i18n 机制保持一致
– 遵循仓库的 TypeScript 类型与测试规范
适合的用户:
– 正在为 WordPress.com / Jetpack / Calypso 生态做前端开发的工程师
– 需要修改 Calypso 后台创建界面、希望 AI 输出符合仓库风格的开发者
不适合的需求:
– 想用 AI 管理 WordPress 网站的站长(那是 wp-admin 或 WordPress.com 后台的功能,不是这个 Skill)
– 想生成独立 WordPress 插件的开发者
– 想用 AI 操作 WordPress 数据的自动化需求
它与 Agent 自身能力的区别在于:普通 Agent 只能给出通用的 React 或前端建议,而该 Skill 提供的是 wp-calypso 仓库特定上下文,让输出贴近仓库的真实目录、组件模式与代码约定。
Skill 安全评估
总体判断:来源可信度较高,但使用时应控制 Agent 的文件写入与 Shell 权限范围。
从来源看,wp-calypso 是 Automattic 官方开源仓库,公开托管在 GitHub,代码可审查,供应链风险相对可控,但不代表该 Skill 本身经过任何第三方或官方安全审计,官方也没有针对该 Skill 发布单独的安全说明。
主要关注点:
– 文件读取与写入:如果 Agent 被授权直接修改本地 wp-calypso 仓库,可能会改动已有源码。建议先在干净分支或独立克隆副本上使用,并配合 Git 版本控制随时回退。
– Shell 权限:前端项目通常需要运行 `npm` / `yarn` / `pnpm` 安装依赖与构建。如果只是让 Skill 生成或审查代码,可以关闭 Agent 的自动执行 Shell 权限,由你手动运行安装和构建命令,避免 Agent 执行未经确认的脚本。
– 依赖安装风险:Calypso 依赖数量庞大,`node_modules` 安装属于供应链风险高发环节。建议使用锁文件(lockfile)固定版本,不要随意升级依赖。
– 网络访问:仅在安装依赖、拉取仓库时需要网络,通常无需向外部服务发送敏感数据。
– 凭证 / Token:如果 Agent 需要访问 GitHub 提交 PR 或使用 WordPress.com API,可能涉及 GitHub Token 或 WordPress.com 凭证。这类凭证应使用最小权限,且不要写入会被提交到仓库的文件。
– 对已有项目的影响:该 Skill 面向 wp-calypso,不应被误用于你其他项目的目录,否则可能生成与项目无关的代码或引入不兼容的改动。
实操建议:
– 在独立分支或 fork 中使用,先审查 diff 再合并。
– 不需要自动执行时,关闭 Agent 的 Shell 执行权限。
– 不要把 GitHub Token、WordPress.com 凭证交给 Agent 长期持有;用完即撤销。
– 不追求「无风险」,只需确保权限与任务匹配。
Skill 使用要求
一、Agent / 客户端
官方没有针对该 Skill 提供完整的第三方 Agent 兼容列表。它属于 wp-calypso 仓库配套的开发类 Skill,从 Agent Skill 的通用工作机制来看:
– 在支持 Skills 或自定义指令加载机制的环境中,可以优先尝试 Claude Code。
– Codex、Cursor、Trae、OpenClaw、WorkBuddy 等主流 Agent 若支持 Skills 或类似指令加载,通常也可以尝试,具体能否识别取决于各 Agent 当前版本对 Skill 的加载方式。
– 不同 Agent 的 Skill 加载路径与兼容程度不同,以对应 Agent 当前版本为准。
官方支持与「通常兼容」是两件事:官方并未声明完美适配上述任何具体 Agent。
二、运行环境 / 依赖
该 Skill 本身是一份面向 Calypso 的指令 / 代码上下文,通常不需要独立运行时。但若你打算在本地实际运行或修改 wp-calypso 项目,则项目侧需要以下环境(以便真实开发):
| 项目 | 要求 |
|—|—|
| Agent | Claude Code 优先,其他兼容 Agent 可尝试 |
| Git | 建议需要,用于克隆与管理 wp-calypso |
| Node.js / npm / yarn / pnpm | 由 wp-calypso 项目自身决定,具体版本以仓库当前 `package.json` / `.nvmrc` / 官方文档为准 |
| 网络 | 克隆仓库、安装依赖时需要 |
Skill 本身不需要 Node.js,项目运行才需要;具体版本以 wp-calypso 仓库当前的官方说明为准,本页不做猜测。
三、权限
– 文件读取:必需,用于读取 wp-calypso 源码与规范文件。
– 文件写入:可选,仅在需要修改代码时开启。
– Shell:可选,用于安装依赖、构建、跑测试;不需要自动执行时可关闭。
– 网络:可选,克隆仓库与安装依赖时需要。
– GitHub:可选,仅在需要提交或操作远程仓库时使用。
四、账号 / API Key
– Skill 自身不需要账号、API Key 或 Token。
– 只有当你把该 Skill 生成的代码用于 WordPress.com API、Jetpack 或 GitHub 操作时,才可能涉及 WordPress.com 凭证或 GitHub Token,这些属于项目侧需求,不是 Skill 的硬性要求。
最小使用条件
1. 一个支持 Skills 或自定义指令加载的 AI Agent。
2. 一份本地或可读取的 wp-calypso 仓库上下文。
3. 明确你只想改 Dashboard Create 相关界面,而不是整个仓库。
Skill 安装、使用与卸载教程
一、安装
可以直接复制本页面提供的 Skill 安装指令,粘贴到对应 Agent 或终端执行。
如果不清楚自己的 Agent 如何安装,可以直接问当前 Agent:
如何安装 automattic/wp-calypso#dashboard-create-screen?
也可以带上具体 Agent 名称:
如何在 Claude Code 中安装 automattic/wp-calypso#dashboard-create-screen?
如何在 Codex 中安装 automattic/wp-calypso#dashboard-create-screen?
如何在 Cursor 中安装 automattic/wp-calypso#dashboard-create-screen?
让当前 Agent 按它自己的 Skill 加载与管理机制来指导安装即可。该 Skill 与 wp-calypso 仓库关联,官方并未公布特殊安装条件,无需额外步骤。
二、安装后如何使用
安装后,在涉及 wp-calypso 后台创建界面的开发任务时,Agent 会依据该 Skill 提供的上下文来生成或修改代码。比较适合交给它的任务:
– 在 wp-calypso 中定位与 Dashboard Create 相关的页面或组件
– 按仓库约定新增或调整创建流程界面
– 检查某段 Calypso 前端代码是否符合仓库模式
使用示例:
使用 dashboard-create-screen,帮我定位 wp-calypso 里 Dashboard Create 相关的组件,并说明它们的目录结构。
使用 dashboard-create-screen,按 wp-calypso 的约定帮我新增一个创建页面的组件骨架,并保持 Redux 和路由一致。
使用 dashboard-create-screen,检查我这个创建流程的改动是否符合 Calypso 的代码规范。
向 Agent 描述需求时,尽量说清楚:改的是哪个创建流程、涉及哪些组件、是否要保留现有类型和 i18n 机制。
三、卸载
不同 Agent 的 Skill 安装位置与管理方式不同,通常有以下几种方式:
– 使用对应 Agent 或 Skill 管理器提供的删除 / 移除功能,删掉对应 Skill。
– 如果该 Skill 是通过复制文件安装的,删除对应 Skill 文件或目录即可。
– 如果无法确认统一卸载命令,直接问当前 Agent:
如何卸载 automattic/wp-calypso#dashboard-create-screen?
官方未提供统一卸载命令时,不建议自行猜测执行删除命令。
常见问题
1. 安装后 Agent 好像没识别到这个 Skill,怎么办?
先确认 Skill 是否放在当前 Agent 实际读取的 Skill 目录或配置中,再确认 Agent 版本是否支持 Skills。可以让 Agent 列出它当前已加载的 Skills 进行核对。
2. 可以同时安装到多个 Agent 吗?
通常可以。Skill 一般以文件形式存在,多份副本相互独立。需要注意不同 Agent 的读取路径不同,要分别放到位。
3. Skill 更新后是否需要重新安装?
如果 Skill 通过 Git 或管理器同步,通常拉取最新版本即可;如果是手动复制文件安装,需要重新复制新版本覆盖。具体以你使用的 Agent / 管理器机制为准。
4. 中国大陆使用是否有网络要求?
Skill 本身是本地指令类资源,不需要联网。但如果要实际运行 wp-calypso,克隆仓库、安装 npm 依赖可能需要访问 GitHub 与 npm 源,中国大陆环境下通常需要可用的网络或配置镜像,具体以你所在环境为准。
5. 这个 Skill 会修改我已有的项目吗?
不会主动改动与 wp-calypso 无关的项目。但如果你把 Agent 的工作目录指向其他项目并授权写入,可能生成不相关的代码。建议只在 wp-calypso 相关目录下使用。
6. 可以关闭 Agent 的 Shell 权限吗?
可以。如果只需要它生成或审查代码,关闭 Shell 自动执行后由你手动运行依赖安装和构建,是常见且更稳妥的做法。
7. 它和普通的 React / 前端开发 Skill 有什么区别?
普通前端 Skill 给的是通用 React 建议;这个 Skill 面向 wp-calypso 仓库特定上下文,输出会贴合 Calypso 的目录结构、组件模式和状态管理约定。脱离 wp-calypso 使用,它的针对性优势就不明显。