wp-project-triage

用途

wp-project-triage 用于在修改 WordPress 仓库之前，快速确定当前仓库的类型以及应遵循的命令和约定。它提供一种确定性的检查方式，适用于插件、主题、区块主题、WordPress 核心、Gutenberg 以及完整站点等 WordPress 项目。

主要能力

该技能通过运行检测脚本，输出 JSON 格式的报告。报告内容涵盖项目类型、PHP/Node 工具链是否存在、测试是否存在、版本线索及其来源等信号。这些信息可用于选择工作流护栏，帮助开发者在正确的上下文中进行后续操作。

使用方式

在仓库根目录（当前工作目录）下，运行以下命令：

node skills/wp-project-triage/scripts/detect_wp_project.mjs

该命令会将 JSON 输出到标准输出。如果需要了解确切的输出契约，可以阅读：

skills/wp-project-triage/references/triage.schema.json

根据报告选择工作流护栏时，可参考以下信息：项目类型、PHP/Node 工具链是否存在、测试是否存在、版本线索及其来源。如果报告缺少所需的信号，应更新检测器，而不是进行猜测。

验证

输出的 JSON 应可解析，并包含 project.kind、signals 和 tooling 字段。在影响结构或工具链的更改（例如添加 theme.json、block.json、构建配置）之后，应重新运行检测。

失败模式与调试

如果报告显示 unknown，请检查仓库根目录是否正确。如果扫描速度较慢，可以在脚本中添加或扩展忽略目录。