WordPress 仓库结构诊断与安全路由跟进

解决什么问题

WordPress 代码库的形态远不止一种：它可能是单个插件、一个 block 主题、完整的站点、WordPress 核心检出，或是几种形态混在一起的工作区。当 agent 接到一个仓库时，如果直接上手改文件、跑命令，很容易在错误的上下文里操作——比如把插件当作整站来走主题流程，或在 core checkout 里执行只对插件有意义的构建步骤。这类误判的代价通常是一次失败的运行，甚至更糟。这个技能要解决的就是第一步的确定性：先把“这是什么类型的项目”变成一组明确信号，再决定后续动作。

技能如何工作

• 识别项目类型：扫描代码库结构，判断仓库属于 plugin、block theme、site、core checkout 还是 mixed workspace，避免靠猜。
• 返回前置信号：输出 agent 在触碰文件或运行工具之前需要的关键信息，把首遍检查从试错变成确定性的第一次通过。
• 环境依赖：需要 Node.js 和文件系统访问；WP-CLI 是可选的，主要用于下游工作流的衔接。

适用边界

• 这是一个只读的诊断入口，不负责生成代码或执行修改，后续工作仍需结合返回的信号推进。
• 在混合工作区中，各类组件的信号会同时出现，需要逐项确认范围，而不是当作单一项目处理。
• 上游文档基于 WordPress agent-skills 仓库，跨版本或深度定制的环境可能需要重新核对识别结果。