技能介绍

要解决什么问题

做格斗/电竞赛事复盘、写战报或做数据分析时，数据往往散落在 start.gg 页面上：赛事列表、项目（event）、报名名单、分组/池子、对阵表和最终排名。手工翻页复制既慢，也容易漏字段或搞错 slug。本技能把查询收敛到 start.gg GraphQL API，在 Agent 里按「搜赛事 → 进 event → 查选手/池子 → 看 sets 或 standings」走完整链路。

技能如何工作

执行任何请求前，必须先确认环境变量 STARTGG_API_KEY 已设置；若没有，应提示用户到 start.gg 开发者设置申请 token，并说明如何配置变量，不要在未授权时调用 API。

接口固定为 POST https://api.start.gg/gql/alpha，请求头使用 Authorization: Bearer $STARTGG_API_KEY 与 application/json。

优先使用封装好的高阶 action，而不是手写 GraphQL：

search_tournaments(name, per_page)：按名称搜赛事，得到带 tournament/ 前缀 的 slug
get_tournament(slug)：拉取赛事详情与 events 列表
list_event_entrants / search_event_entrants：分页或按 filter: { name: ... } 查参赛者
seed_pool(seed_id)：由 seed 定位 pool / phaseGroup（如 displayIdentifier）
phasegroup_sets(phase_group_id, ...)：某池子的对阵（sets）
event_standings(event_id, ...)：项目排名

仅在 schema 字段不够时，再用 gql(query, variables) 发原始查询。典型路径：搜索 slug → 取 event ID → 查 entrant 得 seedId → 查 phaseGroup → 查 sets 或 standings。

适用边界与注意点

Slug：必须是 tournament/ceo-2026 这类格式，不能省略 tournament/ 前缀。
字段路径：选手名在 Entrant.participants[].gamerTag；池子标识在 Seed.phaseGroup.displayIdentifier。
Connection 类型：phaseGroups、entrants、sets、standings 等列表通过 .nodes 读取。
分页：使用 page 与 perPage；未开赛或未锁定报名阶段，列表可能为空，需结合赛事状态判断。