tanweiping1012-source/travel-planner
travel-planner-mvp
VerifiedCreate evidence-backed, read-only travel plans using Amap, a community 12306 rail MCP, and approved browser research. Use for 行程规划、路线安排、景点取舍、高铁或机票比较、酒店住宿比价、预算分析、旅行可行性检查,以及中国境内多城市旅行规划(境外目的地降级为浏览器辅助规划)。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 12.5 KB |
| agents/openai.yaml | config | 344 B |
| examples/final_plan.json | config | 2.6 KB |
| examples/itinerary.json | config | 1020 B |
| examples/rail_query.json | config | 2.9 KB |
| examples/social_research.json | config | 1.3 KB |
| examples/trip_request.json | config | 1.1 KB |
| references/browser-use.md | markdown | 14.8 KB |
| references/client-compatibility.md | markdown | 5.4 KB |
| references/data-contracts.md | markdown | 26.6 KB |
| references/intake-template.md | markdown | 4.9 KB |
| references/rail-mcp.md | markdown | 4.3 KB |
| references/script-tools.md | markdown | 3.5 KB |
| references/workflow.md | markdown | 13.3 KB |
| scripts/audit_release.shexecutable | script | 3.4 KB |
| scripts/prepare_release.shexecutable | script | 1.8 KB |
| scripts/setup_amap_key.shexecutable | script | 828 B |
| scripts/setup_rail_mcp.shexecutable | script | 3.8 KB |
| scripts/travel_planner.pyexecutable | script | 11.8 KB |
| scripts/validate_skill.pyexecutable | script | 5.5 KB |
references/script-tools.md
View on GitHub# Script and Tool Inventory
## Persistent Scripts
### `scripts/travel_planner.py`
Commands:
- `validate-request`: check intake completeness, field validity, and explicit
requirement conflicts before research.
- `credential-status`: check Amap Keychain configuration.
- `preflight`: verify live Amap access.
- `doctor`: check Python, Amap, rail runtime, MCP registration, and the browser
capability reported by the invoking Agent.
- `search-places`: query normalized Amap POIs.
- `amap-snapshot`: collect locations, routes, and nearby places.
- `compile-research`: merge normalized social notes into attraction cards.
- `normalize-rail`: turn a 12306 `query-tickets` payload into comparable
records. Seat availability mixes integers with `有` and `无`, so raw values
must never be compared or passed to `int()`. Add `--select` to narrow to
usable candidates.
- `validate-flights`: check browser-derived flight offers. Structural checks
always run; freshness is compared against `--now`, which defaults to the
current time, and `--skip-freshness` limits the run to structure alone.
- `validate-lodging`: check browser-derived hotel offers and derive the stay
total from the per-night card price, nights, and `--rooms`. Requires
`login_state` on every offer — Ctrip shows no room price to a signed-out
visitor, so an offer without it cannot be genuine — and flags offers
gathered under different login states or membership tiers as not
comparable. Same `--now` / `--skip-freshness` freshness contract as
`validate-flights`, with a 12-hour default window.
- `evaluate`: run deterministic time, route, budget, and opening-hour checks.
- `validate-plan`: reject plans missing attraction content or source metadata.
Runs `validate-flights` and `validate-lodging` internally on any
`flight_offers` / `lodging_offers` present, so a plan with a broken quote
fails here even if nothing else in the plan references it.
### `scripts/setup_amap_key.sh`
Stores the Amap key in macOS Keychain without writing it to project files.
### `scripts/setup_rail_mcp.sh`
Installs the pinned community 12306 MCP in a per-user data directory, applies
the local security patch, and prints the stdio configuration. Pass
`--register-codex` to register it through `codex mcp add`.
### `scripts/prepare_release.sh`
Creates an allowlisted GitHub release directory. It does not copy provider
installations, virtual environments, runtime artifacts, or browser state.
### `scripts/audit_release.sh`
Fails the release when forbidden directories, sensitive files, high-confidence
secret patterns, absolute user paths, or real-looking Xiaohongshu note IDs are
found. It also runs `gitleaks` when available.
## External Agent Tools
- Browser adapter: dynamic OTA and Xiaohongshu page interaction. TRAE uses its
built-in Browser Use capability; other clients require an equivalent tool.
- Amap Web API: called through `travel_planner.py`.
- 12306 community MCP: rail schedules, availability, prices, transfers.
- Web Search: official documentation and fallback discovery only.
## Run Artifacts
For a substantial planning run, preserve these normalized JSON artifacts in a
temporary run directory:
```text
trip_request.json
social_research.json
destination_brief.json
route_skeletons.json
rail_options.json
flight_offers.json
lodging_offers.json
candidate_plans.json
feasibility_reports.json
final_plan.json
plan_validation.json
```
Do not persist cookies, passwords, SMS codes, API keys, raw request headers, or
full raw provider responses.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |