用途:该技能用于在儿童夏令营筛选过程中,计算家庭住址、家长工作地址与各营地之间的通勤时间,并标出超出家庭设定的最长通勤阈值(max_commute_minutes)的营地,辅助筛选与优化日程。
主要能力:使用 Geoapify Route Matrix API 计算多个地点间的出行时间。支持完整通勤链建模,例如早上 Home -> Camp -> Work、晚上 Work -> Camp -> Home。支持多种出行方式,参数 --modes 可选 drive、transit、walk、bicycle,默认 drive,transit。输出人可读的通勤报告和供 schedule-optimizer 使用的结构化 JSON,包含每个营地每种方式的直达时间、通勤链时间、exceeds_max 标记以及 best_mode 和 best_chain_minutes。可选用 --update-providers 将各营地的 Distance & Commute 区分为手动数据(如是否公交可达、停车信息)与自动计算的 Computed 子段,每次运行自动更新计算部分、保留手动数据。含地理编码缓存 geocache.json,按规范化地址缓存,避免重复地理编码。
使用方式:需先配置 Geoapify API key,保存在 .claude/kids-camp-planner.local.md 的 apis.geoapify_api_key 下。API key 可在 https://myprojects.geoapify.com/ 获取,免费额度为每天 3,000 次矩阵请求、每月 90,000 次地理编码。工作流程为:读取配置与家庭档案(含 home_address、parents[].work_address、max_commute_minutes);扫描 providers 目录下的营地文件提取名称与地址;运行计算脚本:
python3 ${CLAUDE_PLUGIN_ROOT}/skills/commute-matrix/scripts/commute_calculator.py
--profile <research_dir>/family-profile.md
--providers <research_dir>/providers/
--api-key <GEOAPIFY_API_KEY>
--modes drive,transit
--output-md <research_dir>/commute-report.md
--output-json <research_dir>/commute-matrix.json
--update-providers
--geocache <research_dir>/geocache.json
随后查看结果:汇总表、约束违规列表与建议。
适用场景:儿童夏令营或其他需要比较多地点通勤的方案筛选、日程优化场景。
限制:依赖 Geoapify API key,免费额度有限,超限需等待或升级;地址格式需包含城市、省份、邮编,否则可能无法地理编码;数据可能过期,可删除 geocache.json 强制重新地理编码后再运行;若未配置 API key,需先按设置技能完成配置。其他具体限制资料未提供。