route-builder

nadavyigal 的头像作者 nadavyigal

生成与应用地图层兼容的路线规格(距离、海拔、限制)。

📖 中文导读:生成与应用地图层兼容的路线规格(距离、海拔、限制)。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: route-builder description: Generates route specifications (distance, elevation, constraints) compatible with the app’s mapping layer. metadata: short-description: Builds runnable routes with safety constraints and map-ready specs.

When Codex should use it

  • When the user requests a new route for a target distance/time.
  • During plan creation if a route is missing for an upcoming workout.

Invocation guidance

  1. Provide target distance/time, surfaces, elevation preferences, and start location/constraints.
  2. Return route spec with segments, elevation notes, and safety considerations.
  3. Ensure output is compatible with v0/lib/routeHelpers.ts and mapConfig.ts.

Input schema

See references/input-schema.json.

Output schema

See references/output-schema.json.

Integration points

  • UI: Route selector modal; map layer in v0/lib/mapConfig.ts.
  • API: v0/app/api/route/build (new) backed by existing mapping helpers.

Safety & guardrails

  • Exclude unsafe surfaces if flagged; avoid steep grades for beginners.
  • If location data missing, request clarification and emit SafetyFlag: missing_data.
  • No medical advice; suggest shorter routes if heat/injury risk.

Telemetry

  • Emit ai_skill_invoked with distance, surface, safety_flags.