wp-project-triage – WordPress 项目诊断 Skill

Skill 详细介绍

wp-project-triage 是 Automattic 在 agent-skills 仓库中提供的一个 WordPress 项目分诊 Skill。它的定位不是插件，也不是一个可以单独运行的程序，而是一套写给 AI Agent 的项目分析指令集和方法论：让 Agent 在面对一个 WordPress 项目时，先按照既定流程做“分诊”，再决定后续行动。

“Triage”（分诊）这个词来自医疗场景，指在正式处理之前先快速判断问题的性质、紧急程度和归属。放到 WordPress 项目里，它对应的任务是：Agent 先摸清这个项目是什么类型、用了什么技术栈、有哪些可疑点、存在什么风险或待办，然后给出结构化的判断，而不是一上来就改代码。

核心用途

• 对一个 WordPress 项目做初步识别与分类，判断它属于主题、插件、完整站点、区块项目还是其他形态。
• 识别项目使用的关键技术栈和结构特征，例如主题/插件组织方式、区块相关文件、构建配置等。
• 把发现的问题、风险点和后续建议整理成有条理的结论，供人或其他 Skill 继续处理。
• 作为更大工作流的“前置步骤”，先分诊，再进入具体的修复、审查或开发任务。

它不是什么

• 不是 WordPress 插件，不装到 WordPress 站点里。
• 不是独立的 CLI 工具，没有自己的可执行程序。
• 不替代代码审查、漏洞扫描或自动化测试工具。
• 不会自动替你修改项目文件——它的重点是“判断”，而不是“动手改”。

典型任务

1. 拿到一个陌生的 WordPress 仓库，先让 Agent 说明这是什么项目、结构如何。
2. 在开始修复某个问题前，先做一次项目层面的分诊，确认影响范围。
3. 梳理一个 WordPress 项目的整体情况，形成给团队看的分诊摘要。
4. 作为多步骤工作流的第一步，为后续的代码审查、重构或开发任务铺路。

工作方式

它的本质是提示词 / 工作流性质的 Skill。安装后，Agent 会获得一套结构化的 WordPress 项目分诊思路，按这个思路去读取项目文件、归纳信息、输出判断。具体的执行能力仍然来自 Agent 本身（文件读取、代码理解、Shell 等），wp-project-triage 提供的是“怎么分诊”的方法和约束。

适合哪些用户

• 需要在陌生 WordPress 代码库里快速定位项目性质的人。
• 正在用 AI Agent 接手 WordPress 项目、希望先看清楚再动手的开发者。
• 把 WordPress 项目分诊作为自动化流程一环的团队。

不太适合的需求

• 想找一个能自动修 WordPress 漏洞或自动改代码的工具。
• 需要执行 WordPress 站点运行时诊断（那是 WP-CLI、Query Monitor 一类工具的事）。
• 非 WordPress 项目的分诊。

Skill 安全评估

总体判断：wp-project-triage 来自 Automattic 的 agent-skills 仓库，属于提示词 / 工作流性质的 Skill，本身不包含可执行二进制或后台服务。它的安全边界主要取决于 Agent 在分诊过程中被授予的权限。

与安全真正相关的几个点

• 来源可信度：Automattic 是 WordPress 背后的公司，agent-skills 是其官方仓库，来源相对可信。但仓库整体可信不代表可以忽略对具体内容的检查。
• 文件读取：分诊需要读取项目文件来判断项目类型和结构。这是该 Skill 正常用途的一部分，读取范围应限于被分诊的项目目录。
• 文件写入：分诊本身以“判断”为主，正常不需要写入或修改项目文件。如果 Agent 在分诊过程中尝试写入、删除或改动文件，通常不是该 Skill 的必要行为，值得警惕。
• Shell 权限：部分分诊信息（例如构建配置、依赖状态）可能需要运行命令来获得。可以给 Shell 权限，也可以只允许手动执行命令后再把结果交给 Agent。按需最小化授予即可。
• 网络访问：分诊一个本地项目一般不需要联网。如果 Agent 在执行分诊时发起网络请求，应当确认原因。
• 凭证 / API Key：该 Skill 用于项目分诊，正常不需要 API Key、Token 或 OAuth。若遇到要求提供凭证的情况，应先确认是否为该 Skill 的行为。
• Prompt Injection：分诊会读取项目中的文件内容。如果项目里含有恶意或误导性的文本，理论上可能影响 Agent 的判断。处理来源不明的仓库时，最好保持人工复核。

降低风险的实操建议

• 只让 Agent 分诊你信任或已备份的项目目录。
• 如果只需要分诊结论、不需要 Agent 动手，可以关闭自动执行 Shell 的权限，由你手动执行命令并把结果反馈给 Agent。
• 不要在分诊环境中暴露无关的凭证、密钥或敏感目录。
• 对分诊结论保持复核意识，尤其在处理来源不明的仓库时。

没有任何 Skill 可以被判定为绝对无风险。这里给出的是基于该 Skill 类别和用途的判断，具体行为仍以该 Skill 当前官方说明和你的 Agent 配置为准。

Skill 使用要求

一、Agent / 客户端

该 Skill 来自 Automattic 的 agent-skills 仓库。agent-skills 面向的是支持 Agent Skill / 自定义 Skill 机制的 AI Agent，Anthropic 的 Claude Code 是这类机制的代表环境之一，在这类环境中使用该 Skill 通常比较自然。

官方没有提供完整的第三方 Agent 兼容列表。从 Agent Skill 的工作方式看，在支持 Skills、自定义 Skill 或类似指令加载机制的 Codex、Cursor、Trae、OpenClaw、WorkBuddy 等主流 AI Agent 中，通常也可以尝试使用。不同 Agent 对 Skill 的加载方式、目录约定和触发方式可能不同，兼容程度以对应 Agent 当前版本为准。

二、运行环境 / 依赖

该 Skill 本身不要求特定的 Node.js、Python 或其他运行时版本；它是否需要用某个运行时，取决于你分诊的 WordPress 项目以及你要在分诊后继续做的任务。官方没有把某一版本作为该 Skill 的硬性要求。

三、权限

• 文件读取（必需）：读取待分诊的 WordPress 项目。
• 文件写入（一般不需要）：分诊以判断为主，正常不涉及写入或修改项目文件。
• Shell（可选）：用于获取构建、依赖等附加信息，可最小化授予。
• 网络（可选）：分诊本地项目一般不需要。

四、账号 / API Key

wp-project-triage 用于项目分诊，本身不需要账号、API Key 或 Token。是否需要凭证，取决于你分诊的 WordPress 项目后续要用到的服务，而不是这个 Skill 本身。这两者不要混为一谈。

最小使用条件

1. 一个支持 Skill 的 AI Agent。
2. 一个可读取的 WordPress 项目目录。
3. 对项目目录的读取权限。

Skill 安装、使用与卸载教程

一、安装

本页面已经提供该 Skill 的安装指令，直接复制安装指令，粘贴到对应 Agent 或终端执行即可。

如果你不确定自己的 Agent 如何安装，最稳妥的方式是直接问当前 Agent：

如何安装 automattic/agent-skills#wp-project-triage？

如果你使用特定 Agent，也可以这样问：

如何在 Claude Code 中安装 automattic/agent-skills#wp-project-triage？

如何在 Cursor 中安装 automattic/agent-skills#wp-project-triage？

不同 Agent 的 Skill 加载和管理机制不同，由 Agent 根据自己的机制给出安装步骤，通常比套用通用手册更准确。

二、安装后如何使用

安装后，在需要分析 WordPress 项目的场合，自然地把任务交给 Agent 即可。通常在提到 WordPress 项目分析、分诊、梳理项目结构这类任务时，Agent 会调用该 Skill。

它适合的任务：接手陌生 WordPress 项目、开始修复前先做项目层面判断、整理项目的分诊摘要、作为后续开发或审查步骤的前置环节。

使用示例：

使用 wp-project-triage，帮我分诊这个 WordPress 项目，告诉我它是什么类型的项目、结构如何、有哪些值得注意的地方。

使用 wp-project-triage，在开始修复这个问题之前，先对这个 WordPress 仓库做一次整体分诊。

使用 wp-project-triage，把这个 WordPress 项目的分诊结论整理成一份给团队看的摘要。

三、卸载

卸载方式取决于你使用的 Agent 和它的 Skill 管理机制：

1. 使用对应 Agent / Skill 管理器提供的删除方式，删除该 Skill；
2. 直接询问当前 Agent：

如何卸载 automattic/agent-skills#wp-project-triage？

不同 Agent 的 Skill 安装位置和管理方式可能不同。如果没有统一的卸载命令，直接询问当前 Agent 如何移除该 Skill 通常更稳妥。

常见问题

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

可以。该 Skill 本身只是提示词 / 工作流性质的资源，不绑定单一 Agent。在多个支持 Skill 的 Agent 中分别安装通常没问题，具体以各 Agent 的安装机制为准。

2. 更新后需要重新安装吗？

取决于你的 Agent 如何管理 Skill。有的 Agent 会自动同步仓库更新，有的需要你手动重新拉取。建议直接问当前 Agent：“wp-project-triage 更新后是否需要重新安装？”

3. 安装后 Agent 没识别到这个 Skill，怎么办？

常见原因是安装位置或目录约定不符合当前 Agent 的要求，或者 Agent 尚未重新加载 Skill 列表。先确认安装是否按该 Agent 的方式完成，再尝试让 Agent 重新识别或重启会话。仍不行就直接询问当前 Agent 如何排查。

4. 在中国大陆使用有网络要求吗？

wp-project-triage 本身用于本地项目分诊，正常不需要联网。安装阶段是否能顺利访问 GitHub，取决于你的网络环境。使用阶段基本不涉及对外的网络依赖。

5. 它会不会改动我的 WordPress 项目？

分诊以判断为主，正常不需要写入或修改项目文件。如果 Agent 在分诊过程中尝试改动文件，这通常不是该 Skill 的必要行为，建议暂停并确认原因。

6. 可以关闭 Shell 权限吗？

可以。文件读取是分诊的核心，Shell 更多用于获取构建、依赖等附加信息。如果只需要分诊结论，可以关闭自动 Shell 权限，由你手动执行命令并把结果交给 Agent。

7. 它和普通的代码审查有什么不同？

代码审查聚焦具体改动或代码质量，wp-project-triage 更偏项目层面的前置判断：先看清这是什么项目、状态如何、有哪些需要注意的点。两者可以配合使用——先分诊，再针对性地审查。