Skip to content

tanweiping1012-source/travel-planner

travel-planner-mvp

Verified

Create evidence-backed, read-only travel plans using Amap, a community 12306 rail MCP, and approved browser research. Use for 行程规划、路线安排、景点取舍、高铁或机票比较、酒店住宿比价、预算分析、旅行可行性检查,以及中国境内多城市旅行规划(境外目的地降级为浏览器辅助规划)。

FileKindSize
SKILL.mdskill md12.5 KB
agents/openai.yamlconfig344 B
examples/final_plan.jsonconfig2.6 KB
examples/itinerary.jsonconfig1020 B
examples/rail_query.jsonconfig2.9 KB
examples/social_research.jsonconfig1.3 KB
examples/trip_request.jsonconfig1.1 KB
references/browser-use.mdmarkdown14.8 KB
references/client-compatibility.mdmarkdown5.4 KB
references/data-contracts.mdmarkdown26.6 KB
references/intake-template.mdmarkdown4.9 KB
references/rail-mcp.mdmarkdown4.3 KB
references/script-tools.mdmarkdown3.5 KB
references/workflow.mdmarkdown13.3 KB
scripts/audit_release.shexecutablescript3.4 KB
scripts/prepare_release.shexecutablescript1.8 KB
scripts/setup_amap_key.shexecutablescript828 B
scripts/setup_rail_mcp.shexecutablescript3.8 KB
scripts/travel_planner.pyexecutablescript11.8 KB
scripts/validate_skill.pyexecutablescript5.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.
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall