Trek Agent Control

Control the user's real Trek data through MCP. Treat web research and Trek synchronization as separate phases: research first, then show a concrete change preview, then write and read back.

Product workspace

Trek 微信旅行小程序是用户查看、编辑、导航、分享和协作的行程工作区；本 Skill 是它的 Agent 自动化层。用户先在小程序创建行程和独立 Agent Key， Agent 再研究资料并把结构化结果同步回同一行程。不要创建与小程序脱离的第二份 行程数据，也不要把聊天回答误报成已同步。

当前二维码为测试阶段入口，是否可直接进入以微信侧体验权限为准。

Connect

1. Never paste the trek_ key into files, prompts, logs, screenshots, commits, or shell history intended for sharing.
2. Prefer the agent's native Streamable HTTP MCP support. Configure:
   • URL: https://api.superd.fun/mcp
   • Header: Authorization: Bearer <user-key>
3. Use the Trek CLI to install/sync this Skill, verify the connection, and diagnose failures:

npm install -g github:super21-bat/trek-agent-control
trek config init --api-key 'trek_...' --url 'https://api.superd.fun/mcp'
trek skill sync --global
trek doctor

The mini program copies these commands, the endpoint, and the one-time key as one Agent access bundle. Treat the whole bundle as a secret. If native remote MCP is unavailable or unreliable, execute all operations through trek; it calls the same MCP endpoint. Read references/configuration.md when installing this skill in WorkBuddy, OpenClaw, Hermes, Claude, Codex, or another agent runtime.

Mandatory workflow

1. Run doctor or native tools/list. Stop on authentication, network, or missing-tool failure.
2. Read existing state with list_trips and get_trip_summary. Never assume a trip ID.
3. Research current facts with primary/official sources first. Separate confirmed facts, recommendations, and unresolved items.
4. Build a dated plan and an expectedAssignmentsByDate checklist containing every POI/activity that must appear in the mini program. Use exact local dates and times. Do not invent reservations, confirmation numbers, phone numbers, opening hours, prices, or addresses.
5. Show the user a compact change preview before destructive, bulk, financial, membership, proposal-decision, or rescheduling writes.
6. Write in small batches. Reuse existing entities and detect duplicates by normalized name/date before creating.
7. Every planned location/activity must be a Place plus Assignment. Use create_and_assign_place for a new POI and assign_place_to_day for an existing one. Day notes are supporting prose and must never replace assignments.
8. Model accommodation separately. create_place_accommodation/create_accommodation create a lodging date range but no visible day assignment. If a hotel or check-in is in the daily plan, also assign its place to that day.
9. Populate only meaningful fields, but use the complete model when relevant: trip dates/description, days, places and coordinates, assignment start/end/duration/transport/notes, reservations, accommodations, costs, packing, todos, collaboration notes, proposals and members.
10. Read back with get_trip_summary plus the relevant list_* tool. Compare expectedAssignmentsByDate to actual days[].assignments by date and normalized place name/ID, not only counts. A planned day must not have zero assignments; explicitly document intentional rest/location-free travel days.
11. Do not report synchronization complete while any expected assignment is missing or only mentioned in a day note. Repair the gap or disclose it to the user.
12. Report what changed, what remains uncertain, and what the user must confirm.

Read references/workflows.md for detailed planning and synchronization recipes. Read references/field-guide.md before a large or unfamiliar write.

CLI

trek doctor
trek update --check
trek tools place
trek call list_trips '{"include_archived":false}'
trek summary 3
trek audit-plan 3 /absolute/path/expected-assignments.json
trek upload-file 3 /absolute/path/ticket.pdf --assignment 42 --description '景区电子票'
trek rename-file 3 19 '金门大桥门票.pdf'
trek batch /absolute/path/actions.json
trek batch /absolute/path/actions.json --apply
trek smoke --allow-write-smoke

doctor reports local configuration, endpoint, credential presence, Skill integrity, authentication, live tool count, and trip readback. Failures include a category, hint, and next command; retain that structured output when diagnosing. update --check compares CLI versions; update upgrades the CLI and resynchronizes the Skill. audit-plan compares an expected JSON date-to-place mapping with live days[].assignments and exits non-zero on missing items. upload-file reads a local attachment without printing its base64 and supports files up to 10 MB. rename-file changes only the display name and keeps the extension. batch is dry-run unless --apply is present. It refuses high-risk tool names unless --confirm-high-risk is also present. smoke creates temporary data, exercises the proposal lifecycle, deletes it, and closes the MCP session.

Safety invariants

• Treat the key as a password. Ask the user to revoke it immediately if exposed.
• Never delete or overwrite real data during diagnostics. Use the bundled temporary smoke only.
• Do not mark bookings confirmed without order evidence. Use pending or a todo for unresolved bookings.
• Do not create fake coordinates. Use search_place with market: "china" plus region in Mainland China, or market: "global" plus an ISO countryCode for overseas trips. Preserve the returned provider IDs and coordinates.
• For minors, medical needs, border crossings, flights, and tight transfers, add safety buffers and explicit adult-confirmation tasks.
• Respect 429 responses. Do not disable server limits or fire requests in parallel; the bundled client retries with bounded backoff.
• Static trek_ keys currently grant broad user access. Create one per Agent, revoke unused keys, and prefer scoped OAuth when the target agent supports it.
• Close every MCP session, including failed runs.

Failure handling

• 401: key missing, revoked, malformed, or sent without Bearer.
• 403: user lacks trip permission or scope; do not retry as another user.
• 404: wrong trip/entity ID or inaccessible resource; refresh state.
• 429: wait and retry sequentially; reduce batch size.
• isError: true: treat as failed even if HTTP succeeded. Preserve the error text and stop dependent writes.
• Unknown fields/tools: call tools/list; never guess a schema from an older document.

When native MCP and the bundled client disagree, trust a fresh tools/list response and production readback.