site-specification – WordPress 站点规范文档生成 Skill

Skill 详细介绍

automattic/wordpress-agent-skills#site-specification 是 Automattic 官方 wordpress-agent-skills 仓库中的一个 Skill，用于为 WordPress 站点生成一份标准化的站点规格说明（Site Specification）。它本身不是插件、不是独立程序，而是一套交给 AI Agent 执行的指令集/工作流，帮助 Agent 按统一结构梳理并产出一份描述 WordPress 站点目标、结构、内容模型和功能范围的规格文档。

它不是什么：它不是 WordPress 安装器，不会自动搭建站点；不是主题或插件生成器；也不是页面构建器。它只负责“把站点的定义写清楚”，后续是否据此开发，由用户和 Agent 的下一步决定。

核心用途：在动手建站或改站之前，先把“这个站点要做什么、有哪些内容类型、哪些页面、哪些功能、边界在哪里”以结构化方式写下来，作为后续开发、设计或内容生产的共同依据。这解决的正是 WordPress 项目里最常见的问题——需求散落在对话、笔记和脑暴里，没有一份统一、可复用的规格。

安装后 Agent 增加的能力：Agent 会按照该 Skill 定义的结构和流程，引导你梳理站点需求，并输出一份可读、可继续加工的站点规格说明，而不是随意拼凑一份泛泛的需求清单。

典型任务：

• 为新 WordPress 站点起草站点规格说明
• 把零散的需求描述整理成结构化规格
• 明确内容类型、页面结构、导航和功能范围
• 作为开发前的一致参考文档

适合的用户：准备新建或重构 WordPress 站点的开发者、站长、代理机构，以及需要先对齐需求再开发的小团队。不适合的需求：希望一键生成成品站点、或要求 Skill 直接产出可运行主题/插件的场景——这些不在该 Skill 的职责范围内。

与 Agent 自身能力的区别：普通 Agent 也能聊站点需求，但输出结构不稳定、每次不一样。这个 Skill 的价值在于把“站点规格”固化成一套可重复的结构和流程，让输出更一致、更完整、更便于交接。

需要说明的是，写作时的公开资料有限，该 Skill 的具体字段、模板细节与完整流程，请以 Automattic 官方仓库中该 Skill 当前的说明为准。

Skill 安全评估

总体判断：这是一个以文本产出为主的 Skill，来源为 Automattic 官方仓库，从功能定位看风险较低，不涉及高危操作。但它由 AI Agent 执行，实际风险主要取决于你授予 Agent 的权限范围。

来源可信度：来自 Automattic（WordPress 母公司）的官方 GitHub 仓库，属于一手官方来源，可信度较高。相比来源不明的第三方同名或转载版本，官方仓库更值得优先使用。

权限相关：

• 文件读取：梳理需求时可能需要读取项目现有文件或文档，属正常用途。
• 文件写入：若要让 Agent 把规格说明保存为文件，需要写权限。是否开启由你决定。
• Shell / 命令执行：该 Skill 的核心任务是生成规格文档，通常不要求执行 Shell。如果 Agent 被授予自动执行 Shell 的权限，建议按需收紧。
• 网络访问：梳理需求阶段一般不需要联网。若 Agent 额外联网查询，属于 Agent 自身行为，非该 Skill 必需。

第三方 API / 凭证：就功能定位而言，该 Skill 不依赖第三方 API，也不需要 API Key、Token 或 OAuth。如果它后续生成的项目涉及这些，那是项目本身的需求，不是该 Skill 的要求。

实际建议：

• 从官方仓库安装，避免使用来源不明的同名版本。
• 只授予完成“写规格文档”所需的权限，不必开启自动执行 Shell。
• 若输出将被写入现有项目，先确认目标路径，避免覆盖已有文件。

该 Skill 不涉及删除文件、命令注入、公网监听等高危行为。总体属于低风险，但“低风险”依赖你合理配置 Agent 权限，而非绝对安全。

Skill 使用要求

一、Agent / 客户端

该 Skill 来自 Automattic 的 wordpress-agent-skills 仓库，遵循 Agent Skill 的通用工作方式，因此它高度适配 Claude Code，可优先在 Claude Code 中使用。官方未提供完整的第三方 Agent 兼容列表。从 Agent Skill 的通用加载机制来看，在支持 Skills 或类似自定义指令加载机制的 Codex、Cursor、Trae、OpenClaw、WorkBuddy 等主流 AI Agent 中，通常也可以尝试使用，但各 Agent 的加载方式与兼容程度可能不同，具体以对应 Agent 当前版本为准。

二、运行环境 / 依赖

以上仅为通用判断，具体以官方说明为准。

三、权限

• 文件读取：可选，用于读取现有资料。
• 文件写入：可选，用于保存规格说明。
• Shell：通常非必需。
• 网络：非必需。
• GitHub / 浏览器 / Docker：非必需。

四、账号 / API Key

该 Skill 本身不需要账号、API Key 或 Token。如果它产出的规格说明后续要被用于需要凭证的 WordPress 服务或第三方平台，那属于项目侧需求，与该 Skill 无关，两者不要混为一谈。

最小使用条件：

1. 一个支持 Skills 或类似机制的 AI Agent（推荐 Claude Code）。
2. 已安装该 Skill。
3. 能描述你的 WordPress 站点目标或现有需求。

Skill 安装、使用与卸载教程

一、安装

可以直接复制本页面提供的 Skill 安装指令，粘贴到对应 Agent 或终端执行。这是最省事的方式。

如果你不确定自己的 Agent 该如何安装，可以直接问它：

如何安装 automattic/wordpress-agent-skills#site-specification？

如何在 Claude Code 中安装 automattic/wordpress-agent-skills#site-specification？

如何在 Codex 中安装 automattic/wordpress-agent-skills#site-specification？

如何在 Cursor 中安装 automattic/wordpress-agent-skills#site-specification？

让 Agent 根据自己的 Skill 加载与管理机制，给出对应安装步骤。不同 Agent 的安装位置和方式可能不同，以 Agent 当前版本为准。

二、安装后如何使用

安装后，当你的任务涉及“梳理 WordPress 站点需求、定义站点结构”时，Agent 会按该 Skill 的结构来组织输出。你只需用自然语言描述目标即可。

使用 site-specification，帮我为新的企业官网 WordPress 站点写一份站点规格说明。

使用 site-specification，把这个博客改版需求整理成结构化的站点规格。

使用 site-specification，帮我明确这个站点的内容类型、页面结构和功能范围。

如果 Agent 没有自动触发，可以直接在提问里点名该 Skill，效果通常更稳定。

三、卸载

不同 Agent 的 Skill 安装位置和管理方式可能不同。可以直接使用对应 Agent 或 Skill 管理器提供的删除方式移除该 Skill；如果没有统一卸载命令，直接问当前 Agent 通常更稳妥：

如何卸载 automattic/wordpress-agent-skills#site-specification？

一般删除对应 Skill 目录或条目即可，不需要额外清理操作。

常见问题

1. 这个 Skill 会直接帮我生成 WordPress 站点吗？

不会。它只产出站点规格说明，不搭建站点、不生成主题或插件。后续开发需要你或 Agent 另行进行。

2. 它需要联网吗？会产生额外费用吗？

生成规格的过程通常不需要联网，也不依赖付费 API，因此一般不产生额外费用。安装阶段按 Agent 要求可能需要联网获取仓库。

3. 可以同时安装到多个 Agent 吗？

通常可以，各 Agent 独立管理自己的 Skill。不过不同 Agent 的加载方式不同，逐一安装并分别验证是否被识别即可。

4. Skill 更新后需要重新安装吗？

如果 Agent 的 Skill 来源直接指向官方仓库，更新通常可通过重新拉取完成；若是从本地副本安装，则需要重新获取最新版本。具体以 Agent 的 Skill 管理机制为准。

5. 为什么安装后 Agent 没识别这个 Skill？

常见原因：安装路径不符合该 Agent 的要求、Skill 未启用、或当前 Agent 不支持 Skills 机制。可以先确认安装位置，再重启 Agent 或新开会话；仍不行就询问 Agent 如何正确加载该 Skill。

6. 它能和哪些 WordPress 相关 Skill 搭配使用？

它定位在“需求定义”阶段，通常适合与后续负责开发或内容生产的 WordPress 相关 Skill 配合，作为前置规格输入。具体搭配取决于你实际的工作流。

7. 中国大陆使用是否有网络要求？

该 Skill 本身不依赖中国大陆特定平台或服务，生成规格阶段一般无特殊网络要求。安装时若访问 GitHub 受限，可能需要按你的网络环境调整访问方式。