前言¶

在 Agent 里做旅行规划，常见做法是反复追问出发地、天数和预算，再让模型输出一段 Markdown。若要交给同事或打印，往往还要手工整理成表格或 Word。若你希望 Agent 在识别自然语言行程需求后，直接产出结构化的 Excel、Word、Markdown 文件，并可选接入地图与模型 API 丰富内容，可以把 travel planner v2.2.0 装进当前环境的 Skills 目录，按包内说明调用本地 Python 入口。

这是什么¶

travel planner v2.2.0（坐标 @user_6e3628ef/travel-planner-v）是 SkillHub 社区源（community）上的 life-service 类 Skill，当前版本 2.2.0，由发布者 user_6e3628ef 维护。包内 config.json 将其描述为智能旅行规划工具，支持多格式输出；SKILL.md 说明其根据出发地、目的地、天数、预算等输入，生成含行程、预算、景点与美食推荐、实用信息等章节的规划文档。

SkillHub 页面标注 requires_api_key=false（安装 Skill 本身不要求平台 API Key）；运行时可选择在 config.json 中配置高德地图与 GLM 的密钥，未配置时使用内置模拟数据仍可生成文件。

核心功能¶

以下能力均来自包内 SKILL.md、readme.md 与 config.json：

1. 输入解析：支持多种中文表述，例如 从沈阳到大连3天3000元、沈阳-大连3天3000元、沈阳 大连 3天 3000元 等。
2. 多格式导出：默认生成 Excel（openpyxl）、Word（python-docx）、Markdown；可通过 --formats 指定子集。
3. 文档结构：基本信息（出发地/目的地、天数、预算、人数、季节等）、按日行程（主题、上下午安排、景点与美食、住宿建议）、预算明细（交通、住宿、餐饮、门票、购物及总计）、实用信息（天气、交通、物品、注意事项）。
4. 可选外部数据：utils/api_client.py 面向高德地图与 GLM；未配置密钥时走模拟数据（SKILL.md 注明无密钥时景点/美食可能为大连相关默认值）。
5. v2.2 相对早期版本的说明（readme.md）：修复「沈阳到大连」等目的地被误解析等问题，并改进 API 配置、错误处理与文件生成逻辑。

触发场景（Agent 侧）：用户提到「帮我规划一次旅行」「生成旅行攻略」「制定旅行行程」「做一个从 XX 到 XX 的旅行规划」等需求时，可启用该 Skill。

安装与启用¶

通过 SkillHub 安装到 Agent¶

官方页面给出的安装提示为：参照 SkillHub 安装说明，安装 @user_6e3628ef/travel-planner-v。

若本机已安装 skillhub CLI，在当前 Agent 的 skills 目录下执行（目录需与所用客户端一致，否则技能不会被加载）：

skillhub install travel-planner-v --namespace user_6e3628ef --dir ~/.cursor/skills/

常见路径（摘自 SkillHub 安装文档，按实际客户端替换 --dir）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装完成后，按各客户端要求重启或刷新 Agent，使其读取新 Skill。

Python 依赖与配置¶

进入技能包根目录（安装后的 @user_6e3628ef/travel-planner-v），安装依赖：

pip install -r requirements.txt

依赖版本要求（SKILL.md / requirements.txt）：openpyxl>=3.0.0、python-docx>=0.8.11、requests>=2.25.0；需要 Python 3.x。

可选编辑 config.json：

{
  "amap_api_key": "您的高德地图API密钥",
  "glm_api_key": "您的GLM API密钥",
  "output_format": ["excel", "word", "markdown"],
  "output_dir": "./output"
}

config.json 中还声明天数范围 1–30、预算上限字段 max_budget: 10000（与 SKILL.md 中「预算 100–100,000 元」的说明并存时，以运行时的校验逻辑为准；使用前可用小样本输入自测）。

典型用法¶

在技能包目录下，用一条自然语言调用主程序：

python main.py "从沈阳到大连3天3000元"

只生成 Excel：

python main.py "沈阳到大连3天3000元" --formats excel

生成 Word 与 Markdown：

python main.py "沈阳到大连3天3000元" --formats word markdown

指定配置文件：

python main.py "从沈阳到大连3天3000元" --config config.json

查看 CLI 帮助：

python main.py --help

输出文件写入 output/（或 config.json 中的 output_dir），命名形如：出发地到目的地旅行规划_YYYYMMDD_HHMMSS.xlsx / .docx / .md。

在 Cursor 等 Agent 中，安装 Skill 后，用户用自然语言描述行程即可；Agent 按 SKILL.md 的触发场景调用上述脚本或等价步骤生成文件。

适用场景与注意¶

适合：需要快速把「出发地 + 目的地 + 天数 + 预算」整理成可分享的 Office 或 Markdown 文档；希望在 Agent 对话里统一走同一套规划模板与输出目录的团队或个人。

限制与注意：

• SKILL.md 要求出发地与目的地不能相同；天数、预算需在文档声明的范围内。
• 未配置 amap_api_key / glm_api_key 时仍可生成文件，但内容可能偏模板或默认城市数据，正式出行前应人工核对。
• SkillHub 统计（抓取时点）：评分 100000，下载 914，安装 0；数据会随平台更新变化，以 SkillHub 技能页 为准。
• 包内 SKILL.md 含作者本机 Windows 路径示例，实际使用时应改为本机安装目录，勿照搬绝对路径。

结尾¶

travel planner v2.2.0 把旅行规划从「长对话」收敛为「可解析的一句话输入 + 多格式文件输出」，并保留可选的高德 / GLM 增强路径。若你在 life-service 类 Skill 中寻找可落地的行程生成能力，可从官方入口查看版本与安装说明：

• SkillHub 页面：https://www.skillhub.cn/skills/user_6e3628ef/travel-planner-v
• API 坐标页：https://api.skillhub.cn/user_6e3628ef/travel-planner-v