orbitwizard-walker - SKILL.md Agent Skill

name: orbitwizard-walker description: 生成 Walker 星座参数。用户需要根据种子轨道与星座构型参数快速生成 Walker 星座时使用。

OrbitWizard Walker 技能

注意walker星座的常用三参数表示法：T/P/F

T (Total)：星座中的卫星总数。
P (Planes)：轨道面的数量。所有的轨道面具有相同的轨道高度和倾角。
F (Phasing)：相位因子，定义了相邻轨道面之间卫星的相对位置(相位差）(0 ≤ F < P)。

注意和接口参数中NumPlanes，NumSatsPerPlane的区别:

P = NumPlanes
NumSatsPerPlane = T/P

接口

POST /OrbitWizard/Walker

输入参数 (Walker_Input)

参数名	类型	必须	说明
`SeedKepler`	object	是	种子轨道开普勒根数(见下表)
`WalkerType`	string	是	星座构型类型: `Delta` / `Star` / `Custom`
`NumPlanes`	integer	是	轨道面数量
`NumSatsPerPlane`	integer	是	每轨道面卫星数
`InterPlanePhaseIncrement`	integer	否	相位因子 F (`Delta`/`Star` 有效, 0 ≤ F < NumPlanes)
`InterPlaneTrueAnomalyIncrement`	number	否	相邻轨道面真近点角增量 deg (`Custom` 有效)
`RAANIncrement`	number	否	相邻轨道面 RAAN 增量 deg (`Custom` 有效)

WalkerType 说明

类型	RAAN 分布	相位关系	适用场景
`Delta`	均匀分布在 0°~360°	由 F 因子决定相邻面相位差	全球覆盖星座(如 GPS、Starlink)
`Star`	均匀分布在 0°~180°	由 F 因子决定相邻面相位差	极轨覆盖星座(如铱星)
`Custom`	由 `RAANIncrement` 自定义	由 `InterPlaneTrueAnomalyIncrement` 自定义	非均匀构型

种子轨道开普勒根数 (SeedKepler)

字段名	类型	说明
`SemimajorAxis`	number (double)	轨道半长轴 (m)
`Eccentricity`	number (double)	轨道偏心率
`Inclination`	number (double)	轨道倾角 (deg)
`ArgumentOfPeriapsis`	number (double)	近地点幅角 (deg)
`RightAscensionOfAscendingNode`	number (double)	升交点赤经 (deg)
`TrueAnomaly`	number (double)	真近点角 (deg)
`GravitationalParameter`	number (double)	引力常数 (m³/s²), 可省略使用默认地球值

输出参数 (Walker_Output)

字段名	类型	说明
`IsSuccess`	boolean	结果(True:成功;False:失败)
`Message`	string	失败原因或提示信息
`WalkerSatellites`	array	二维数组, `[i][j]` 为第 i 个轨道面第 j 颗卫星的开普勒根数

标准执行流程

参数预检
- 检查 SeedKepler 六根数是否完整(半长轴单位 m, 角度单位 deg)
- 检查 WalkerType 是否为 Delta/Star/Custom 之一
- Delta/Star 模式需要 InterPlanePhaseIncrement(默认 0)
- Custom 模式需要 InterPlaneTrueAnomalyIncrement 和 RAANIncrement
请求构造
- 向 {BASE_URL}/OrbitWizard/Walker 发送 JSON
结果判定
- 先看 HTTP 状态, 再看 IsSuccess
输出归一化
- 返回星座总卫星数 (NumPlanes × NumSatsPerPlane)
- 返回各轨道面的 RAAN 分布和卫星相位分布摘要

调用示例

Delta 模式 (4面×6星, F=1)

export BASE_URL=http://astrox.cn:8765
curl "${BASE_URL}/OrbitWizard/Walker" \
  --request POST \
  --header 'Content-Type: application/json' \
  --data-binary "@skills/orbitwizard-walker/fixtures/orbitwizard-walker-min.json"

Star 模式 (6面×11星, F=0)

curl "${BASE_URL}/OrbitWizard/Walker" \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "SeedKepler": {
    "SemimajorAxis": 7158137,
    "Eccentricity": 0.001,
    "Inclination": 86.4,
    "ArgumentOfPeriapsis": 0,
    "RightAscensionOfAscendingNode": 0,
    "TrueAnomaly": 0
  },
  "WalkerType": "Star",
  "NumPlanes": 6,
  "NumSatsPerPlane": 11,
  "InterPlanePhaseIncrement": 0
}'

Custom 模式 (3面×4星, 自定义RAAN和相位增量)

curl "${BASE_URL}/OrbitWizard/Walker" \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "SeedKepler": {
    "SemimajorAxis": 6878136.3,
    "Eccentricity": 0,
    "Inclination": 53,
    "ArgumentOfPeriapsis": 0,
    "RightAscensionOfAscendingNode": 0,
    "TrueAnomaly": 0
  },
  "WalkerType": "Custom",
  "NumPlanes": 3,
  "NumSatsPerPlane": 4,
  "InterPlaneTrueAnomalyIncrement": 30.0,
  "RAANIncrement": 120.0
}'