小鹏汽车交付周期监控 Skill

目标

查询指定小鹏车型各配置版本的交付周期信息，以表格形式输出。交付周期单位为周。

技术实现

所有网络请求通过 scripts/ 目录下的 Node.js 脚本执行，使用 Bash 工具运行 node \x3Cscript>.js。不使用 Python、curl 或其他方式。

脚本目录：.claude/skills/xpeng-china-delivery/scripts/

fetch_delivery_period.js 用法

该脚本根据车型类型使用不同的 API 策略：

脚本自动根据 carSeriesCode 判断使用 Case 1 还是 Case 2。

核心流程

步骤一：获取全部车型列表

运行 scripts/fetch_car_series.js，解析输出获取全部车型列表。

输出格式（每行一个）：序号|carSeriesCode|carSeriesName

步骤二：识别用户想监控的车型

根据用户的问题识别用户想要监控哪几个（一个或多个）carSeriesCode。匹配时支持用户说车型名称（如"G6"）或完整名称（如"2026款G6"），做模糊匹配。

如果用户没有提供具体车型，或提供的车型名无法匹配，则使用 AskUserQuestion 工具展示全部车型列表并让用户选择：

序号	carSeriesCode	carSeriesName
1	GX	GX
2	M03_2026	M03
...	...	...

请告诉我您想查询哪些车型的交付周期？可以提供车型名称或序号，支持多个（如：1,3,5 或 GX,G7）。

步骤三：获取每个车型的配置版本列表

针对用户选中的每个 carSeriesCode，运行 scripts/fetch_car_versions.js \x3CcarSeriesCode>。

输出格式（每行一个）：carVersionCode|carVersionName

步骤四：查询每个配置版本的交付周期

根据车型是否为 GX/M03/P7 系列，使用不同的查询方式。脚本会根据 carSeriesCode 自动判断。

Case 1：GX/M03/P7 系列车型

针对每个 carVersionCode，运行：

node scripts/fetch_delivery_period.js \x3CcarVersionCode> \x3CcarSeriesCode>

脚本内部逻辑：

1. 请求 listSpecGroupAndSpecList?carVersionSn=${carVersionCode} 获取可选配置规格列表
2. 遍历每个配置组，在 specList 中找到 isDefault=1 的默认规格，收集其 carSpecificationCode
3. 组成排序后的 carSpecificationCode 列表，作为该车型的默认配置规格（列表可以为空，表示无默认选中配置）
4. 请求 listCarInfoList?carVersionSn=${carVersionCode} 获取 SKU 列表
5. 对每个 SKU，提取其 specList 中所有 specCode 组成列表并排序
6. 找到 specCode 列表与默认配置列表完全匹配的 SKU（应唯一）
7. 输出该 SKU 的 minDeliveryPeriod、maxDeliveryPeriod 和 carName

输出格式：OK|minDeliveryPeriod|maxDeliveryPeriod|carName 或 NO_DATA|0|0| 或 ERROR|0|0|

Case 2：其他车型

推荐方式（批量查询）： 运行一次即可获取该车型所有版本的交付周期：

node scripts/fetch_delivery_period.js \x3CcarSeriesCode> --all

脚本内部逻辑：

1. 请求 allInOne?carSeriesSn=${carSeriesCode} 获取全部数据
2. 从响应中提取 carSpecGroupVoMap（配置规格）和 carInfoVoMap（SKU 信息），两者均以 carVersionCode 为 key
3. 对每个 carVersionCode：
   • 从 carSpecGroupVoMap 中找到默认配置规格（同 Case 1 的匹配逻辑）
   • 从 carInfoVoMap 中找到匹配的 SKU
   • 输出该版本的交付周期

输出格式（每行一个版本）：carVersionCode|OK|minDeliveryPeriod|maxDeliveryPeriod|carName 或 carVersionCode|NO_DATA|0|0|

备选方式（单版本查询）： 也可按版本逐一查询：

node scripts/fetch_delivery_period.js \x3CcarVersionCode> \x3CcarSeriesCode>

输出格式同 Case 1：OK|minDeliveryPeriod|maxDeliveryPeriod|carName 或 NO_DATA|0|0| 或 ERROR|0|0|

如何选择 Case

脚本自动判断，规则如下：

• Case 1：carSeriesCode 以 GX、M03、P7（不区分大小写）开头
• Case 2：其他所有车型

步骤五：输出结果

以表格形式输出每个车型下的交付周期。脚本输出中最后一个 | 后的字段即为 carName，必须将完整的 carName 原样输出到表格的"车辆名称"列，不得省略或截断。

执行约束

1. 严格遵守流程：按步骤一至步骤五顺序执行，不跳过任何步骤。
2. 单位为周：交付周期单位是周，不要理解为"天"或做任何转换。
3. 默认配置匹配：交付周期取默认配置规格对应 SKU 的数据，不是取 SKU 列表第一个元素。
4. 统一使用 Node.js 脚本：所有请求通过 scripts/ 下的脚本执行，不使用 curl 或 Python。
5. Case 2 优先批量：对于非 GX/M03/P7 车型，优先使用 --all 模式一次获取全部版本，减少 API 请求次数。
6. 容错：某个车型请求失败时，输出该车型查询失败，继续查询其他车型，不中断整个流程。
7. 完整输出 carName：脚本输出的最后一个字段是 carName，输出表格时必须将其完整填入"车辆名称"列，不得省略、截断或简写。

异常处理