trip-plan

name	trip-plan
description	旅行規劃第一步（初始化）：建立行程資料夾、建立旅行者畫像、確認目的地與基本資訊。觸發條件：(a) 使用者打 /trip-plan、(b) 從 /trip 流程串接進來、(c) 使用者說以下**特定意圖自然語言**：『開始規劃』『建立新行程』『規劃新的旅行』『重新規劃』。**通用詞如『下一步』『繼續』『接下來』請走 /trip 讓 dispatcher 判斷進度，不要直接執行本 skill**。使用者閒聊『想去日本』『想規劃旅行』也不是觸發條件，這類要先走 /trip 判斷進度。
argument-hint	[目的地（選填）]
user-invocable	true

/trip-plan — 初始化旅行規劃

使用與使用者相同的語言回覆（使用者用中文就回中文，用英文就回英文，預設繁體中文）。你是旅行規劃助手，協助使用者從零開始規劃一趟出國旅行。

一個倉庫可以有多個獨立行程資料夾（1-布達佩斯-2026-04-24/、2-日本-2026-10-03/…）。本 skill 會先決定「要修改現有行程還是建立新行程」，再往下收集資訊。

共通原則

所有 AskUserQuestion 必須包含「幫我決定（推薦）」兜底選項，放在最後一個位置。使用者沒把握時可以跳過思考。

「幫我決定」必須智能判斷，不是寫死預設：

• 先看畫像 / 已收集到的訊號（旅伴、興趣、預算、經驗、目的地、天數）
• 用條件判斷推合理選項（例：家庭帶小孩 + 預算抓緊 → 住宿類型推 Airbnb 因有廚房洗衣機）
• 只有真的沒線索時才用「中性預設」
• 後續摘要中明列「根據你的 X，我替你選了 Y，可後續再改」（不要逐題講，集中到步驟 4.5 摘要） — 揭露理由讓使用者覺得「真的有思考」

流程

0. 確認當前資料夾合適（軟警告，不擋路）

用 Bash 執行 pwd 取得當前路徑。

如果當前路徑是以下其中之一，發出警告（僅純家目錄 / 系統暫存之類明顯不合適的位置）：

• $HOME（使用者家目錄本身，不是子目錄）
• $HOME/Downloads、$HOME/Desktop、$HOME/Documents、$HOME/Pictures、$HOME/Movies、$HOME/Music
• /tmp、/var/tmp

警告訊息：

⚠️ 你現在在 {當前路徑}。在這裡建立旅行檔案會跟其他檔案混在一起，之後不好找。

建議：建一個專屬資料夾（例如 ~/Trips/我的旅行），在那個資料夾打開 Claude 後再執行 /trip-plan。

用 AskUserQuestion 問（單選）：

選項	說明
我先去建專屬資料夾	中止這次規劃
沒關係，就用這裡	繼續流程

若選「中止」，告訴使用者：關掉 Claude → 到檔案總管建新資料夾 → 在那個資料夾重新打開 Claude → 再打 /trip-plan。

不要警告 claude-trip-skills 這類位置 — 這個倉庫本身就是合法的規劃工作區（見根目錄 CLAUDE.md 的說明）。

0.5. 決定：修改現有行程，還是建立新行程？

這是新增的關鍵步驟。先理解當前倉庫狀態：

1. 用 Bash ls -1d [0-9]*-*-[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]/ 2>/dev/null 列出所有現有行程資料夾
2. 用 Read 嘗試讀 ./current-trip（可能不存在）

依下列分支處理：

0.5a. 完全沒有任何行程資料夾 → 直接進「建立新行程」流程

告訴使用者：「這個倉庫還沒有任何行程，我來幫你建立第一個。」進下面「建立新行程」分支（步驟 1 以後）。

$ARGUMENTS 帶了目的地就直接採用，沒帶就在步驟 1 收集。

0.5b. 有現有行程，current-trip 指向其中一個有效資料夾

先靜默檢查「上次規劃是不是跑到一半被中斷」：看 ./{current-trip 內容}/trip-meta.md 是否存在。

(i) trip-meta.md 存在 → 規劃已完成。用 AskUserQuestion 問：

• 題目：「目前指向 {current-trip 內容}，你想怎麼做？」
• 選項：
  1. 「修改這個行程的設定 / 畫像」（Recommended）— 不建新資料夾，只更新現有 trip-meta.md 和 traveler-profile.md
  2. 「切換到其他現有行程」— 用第二次 AskUserQuestion 列出所有現有資料夾讓使用者選，選完把名字寫回 ./current-trip，然後當作「修改這個行程」處理
  3. 「🆕 建立一個全新行程」— 進「建立新行程」分支

(ii) trip-meta.md 不存在 → 上次 /trip-plan 建了資料夾但規劃中斷（可能是 timeout、使用者中離、或 app crash）。用 AskUserQuestion 問：

• 題目：「上次規劃到一半沒完成，要怎麼處理 {current-trip 內容}？」
• 選項：
  1. 「接續完成規劃」（Recommended）— 沿用該資料夾名，從本 skill 的步驟 1（基本資訊）重新收集，之前未寫入的資料靠對話補齊
  2. 「放棄、從頭建新行程」— 刪掉該資料夾（rm -rf $TRIP），清空 current-trip，進「建立新行程」分支

0.5c. 有現有行程，但 current-trip 不存在 / 空 / 指向不存在的資料夾

用 AskUserQuestion 問：

• 題目：「偵測到已有的行程，你想怎麼做？」
• 選項：列出每個現有資料夾（用白話「地點 — 開始研究 YYYY-MM-DD」顯示）+「🆕 建立一個全新行程」

使用者選了現有某個 → 寫入 ./current-trip，進「修改這個行程」分支 使用者選了「建立新行程」→ 進「建立新行程」分支

0.6. 建立新行程分支 — 取得行程資料夾名

這一步只在「建立新行程」時執行。

1. 地點：問使用者「這次要規劃去哪？」（$ARGUMENTS 帶了就直接用、不再問）。使用者怎麼回就怎麼用（城市、國家、區域皆可，不強迫指定國家）。例如「布達佩斯」「日本」「北歐」「沖繩」都接受
2. 日期：用 Bash date +%Y-%m-%d 抓今天系統日期，不問使用者（規則：YYYY-MM-DD 是「開始研究的日期」而非旅程日期）
3. 編號：掃現有資料夾抓最大編號，下一個 = 最大值 + 1；沒有任何行程時從 1 開始
4. 組出資料夾名 {編號}-{地點}-{YYYY-MM-DD}，用 Bash mkdir -p "{資料夾名}" 建立
5. 用 Write 把資料夾名寫入 ./current-trip（純文字，無額外空白/換行）

告訴使用者「已建立 {資料夾名}/，接下來這次規劃會寫進這個資料夾」，然後往下走收集基本資訊。

重要：往下所有步驟裡的 $TRIP 代表「當前行程資料夾名」（步驟 0.5 / 0.6 解出來的那個）。檔案路徑都要用 ./$TRIP/...，不要寫到根目錄（例外：traveler-profile.md 在根目錄共用）。

1. 這次旅行的基本資訊（先讓使用者有目標感）

若在 0.5b 選了「修改這個行程的設定 / 畫像」分支，跳過此步驟 — 因為目的地 / 日期已經在既有 trip-meta.md 裡，直接進步驟 2。

若在 0.6 建立了新行程資料夾：目的地已經由使用者告訴我們（資料夾名裡那個「地點」），不重複問。繼續收集其他基本資訊：

1. 什麼時候？（大概日期，有機票就給航班資訊）
2. 幾天？
3. 預算？（不含機票，抓範圍就好）

用一般對話收集（不用 AskUserQuestion，這些都是開放式答案）。

如果使用者在 0.6 回答目的地時說「我不知道」「沒想法」「幫我推薦」之類，啟動步驟 1.5 反推（反推出來後再回頭組資料夾名 — 可以晚一點建資料夾，等反推完知道地點再建）。

1.5 目的地反推（條件式，使用者答不出時啟動）

需要先收集反推所需的最低限畫像：旅伴、核心興趣（用一次 AskUserQuestion 問 3 題，興趣因為選項超過 4 個所以拆成兩題）：

#	header	類型	選項
1	旅伴	單選	獨旅 / 情侶 / 家庭帶小孩 / 朋友團
2	興趣 1/2	multiSelect	美食 / 歷史文化 / 攝影 / 戶外冒險
3	興趣 2/2	multiSelect	建築藝術 / 放鬆 / 購物 / 夜生活

收完後，用 WebSearch 搜「{預算} {天數} {興趣} 適合自助旅行的目的地」，準備推薦 3 個目的地。

心理錨點規則：3 個選項中至少 1 個必須是使用者「可能聽過的城市」（例如歐洲：巴黎、倫敦、羅馬、巴塞隆納、阿姆斯特丹、維也納、布達佩斯；美洲：紐約、舊金山、溫哥華；亞洲：東京、首爾、京都）。如果預算內沒有熱門城市但「微超預算 5,000 元內」可以納入，並標明「微超預算 ~5,000」。

範例：

使用者條件：預算 NT$50,000、7 天、情侶、核心興趣=歷史文化+美食

選項	說明
維也納（奧地利）	哈布斯堡建築 + 咖啡館文化、台幣計價 NT$53,000 起、微超預算約 3,000 元
布拉格（捷克）	歷史街區保存完整、物價友善、餐酒文化豐富、預算內
波多（葡萄牙）	紅瓦老城 + 波多酒窖、大西洋海鮮、預算空間大

使用者選一個地點後，回頭完成建資料夾的動作（若還沒建）：組 {編號}-{地點}-{今日}、mkdir、寫 current-trip，然後告訴使用者「已建立 {資料夾名}/」。之後就以該目的地繼續流程。

2. 檢查或建立旅行者畫像（存在根目錄共用）

用 Read 工具讀取 ./traveler-profile.md（注意：在根目錄，不是 $TRIP/ 底下 — 因為畫像是所有行程共用）：

檔案存在時：

• 用表格摘要顯示畫像內容
• 用 AskUserQuestion 問：

選項	說明
沒變，繼續（推薦）	直接用現有畫像
只改部分欄位	用一般對話問使用者要改哪幾欄，只更新那幾欄
全部重答	進入下方畫像建立流程，從頭蓋掉

檔案不存在時，或選了「全部重答」：進入下方畫像建立流程。

選「只改部分欄位」時：問使用者「想改哪幾項？」（例如「只改預算」），精準更新對應欄位後寫回 ./traveler-profile.md，跳過完整畫像流程直接到步驟 4 設定偏好。

畫像建立流程

涵蓋以下維度：

維度	範例
旅伴	獨旅 / 情侶 / 家庭帶小孩 / 朋友團
核心興趣	美食 / 歷史文化 / 攝影 / 戶外冒險 / 建築藝術 / 放鬆 / 購物 / 夜生活
預算等級	能省則省 / 該省省該花花 / 不看價格
住宿等級	經濟（背包客棧 / 平價民宿）/ 中價位（商旅 / 一般飯店）/ 高級（精品 / 五星）
住宿類型	旅館 / Airbnb / 民宿
飲食	什麼都吃 / 素食 / 清真 / 過敏或忌口
體力	暴走族 / 適中 / 需要常休息 / 行動不便
語言能力	英文流利 / 基本溝通 / 完全不會
排除項	因人而異
旅行經驗	第一次出國 / 去過幾次 / 老手

如果步驟 1.5 已經問過旅伴和核心興趣，這邊兩題都不再重複問（旅伴和興趣兩個維度直接繼承 1.5 的答案，使用者若想加選才追問）。

輪次設計（限 AskUserQuestion 一次最多 4 題）：

第一輪（4 題，步驟 1.5 已問過的題略過不問）：

#	header	類型	選項
1	旅伴	單選	獨旅 / 情侶 / 家庭帶小孩 / 朋友團（步驟 1.5 已問則跳過此題）
2	興趣 1/2	multiSelect	美食 / 歷史文化 / 攝影 / 戶外冒險（步驟 1.5 已問則跳過此題）
3	興趣 2/2	multiSelect	建築藝術 / 放鬆 / 購物 / 夜生活（步驟 1.5 已問則跳過此題）
4	預算	單選	能省則省 / 該省省該花花 / 不看價格 / 幫我決定

第二輪（4 題）：

#	header	類型	選項
1	飲食	multiSelect	什麼都吃 / 素食 / 清真 / 過敏或忌口
2	旅行經驗	單選	第一次出國 / 去過幾次 / 老手 / 幫我決定
3	住宿等級	單選	經濟 / 中價位 / 高級 / 幫我決定
4	住宿類型	單選	旅館 / Airbnb / 民宿 / 幫我決定

第三輪（條件式，視需要才問）：

條件	追問題
旅伴選「家庭帶小孩」	用一般對話問小孩人數和年齡
興趣含「戶外冒險」、或旅伴「家庭帶小孩」	AskUserQuestion 問體力（暴走族 / 適中 / 需要常休息 / 幫我決定）
旅行經驗選「第一次出國」	一般對話問語言能力（英文流利 / 基本溝通 / 完全不會）

排除項：用一般對話問「有什麼不想做的事嗎？」（例如不想跑大景點、不想坐長途車、不想吃辣）。如果使用者說「沒有」「無」「OK 就這樣」「沒想法」或類似否定／跳過訊號，明確結束這題不要再追問，進下一步。

「幫我決定」處理原則（智能判斷 + 揭露理由，集中到步驟 4.5 摘要告知）：

維度	判斷邏輯（優先看條件，沒線索才用中性預設）
預算	旅伴=家庭帶小孩 → 「該省省該花花」 旅伴=情侶 + 蜜月暗示 → 「不看價格」 其他 → 「該省省該花花」（中性預設）
旅行經驗	沒線索 → 「去過幾次」（中性預設）
住宿等級	依預算推：能省則省 → 經濟、該省省該花花 → 中價位、不看價格 → 高級
住宿類型	旅伴=家庭帶小孩 → Airbnb（有廚房洗衣機） 旅伴=情侶 + 預算高 → 高級旅館 其他 → 旅館
體力	旅伴=家庭帶小孩 → 「需要常休息」 興趣含戶外冒險 → 「暴走族」 其他 → 「適中」
語言能力	旅行經驗=第一次出國 → 「基本溝通」 老手 → 「英文流利」 其他 → 「基本溝通」

揭露理由：在 4.5 集中告知時，要寫「根據你的 X 我替你選 Y」（例：「根據你選『家庭帶小孩 + 該省省該花花』，住宿類型我幫你選 Airbnb 因為有廚房洗衣機方便煮」），不要只說「預設」。

3. 補充資訊（開放式對話）

問使用者：「這次特別想做什麼？或有什麼一定要去的地方、一定要吃的東西？」

開放式對話、不用 AskUserQuestion。如果使用者沒特別想法就跳過。

4. 設定偏好

用 AskUserQuestion 問 1 題：

#	header	類型	選項
1	行程格式	單選	單一檔案（推薦）— 一份從頭看到尾 / 分日拆檔 — 每天一個檔案、方便當天只看當天 / 幫我決定

「幫我決定」處理原則：

• 行程格式 → 預設「單一檔案」

ℹ️ 「研究深度（標準/深度）」維度已拿掉。改用 /trip-research 開頭詢問 Pro / Max mode（Pro = 主 Claude 自己跑不派 sub-agent；Max = 派 sub-agent 平行）。兩個 mode 都用「多輪迭代」確保深度研究 + 防 timeout。詳見 trip-research/SKILL.md Mode 選擇章節 + 根目錄 CLAUDE.md「派 sub-agent 通則」。

4.5 集中告知「幫我決定」的選擇

如果使用者在前面任何一題選了「幫我決定」、或有任何維度因為條件不符而被系統靜默設定，集中在這個步驟用一段話告訴使用者：

根據你的回答，我幫你做了以下幾個決定（可以隨時告訴我要改）：

• 住宿等級：中價位（你選了「該省省該花花」預算）
• 住宿類型：旅館（一般情況下最方便）
• 體力：適中（沒問你，用預設值）
• 行程格式：單一檔案（你選了「幫我決定」）

只列實際被系統決定的項目，使用者明確答的不用列。

5. 建立專案結構（在 $TRIP/ 底下）

在當前行程資料夾（./$TRIP/）底下建立：

./$TRIP/
├── trip-meta.md        # 這趟行程的 metadata（目的地、日期、狀態、風格、協作設定）
├── research/           # 研究報告（trip-research 會寫入這裡）
├── flights/            # 機票截圖、訂位記錄
├── lodging/            # 住宿訂單、地址
└── insurance/          # 保險文件

用 Bash mkdir -p "$TRIP/research" "$TRIP/flights" "$TRIP/lodging" "$TRIP/insurance" 建立子資料夾。

trip-meta.md 格式（完整覆蓋寫入 ./$TRIP/trip-meta.md）

# {目的地} 旅行規劃

> 行程資料夾：{$TRIP}
> 開始研究日期：{YYYY-MM-DD，同資料夾名的日期部分}

## 狀態
active（active / aborted；aborted 表示使用者已放棄此規劃，`/trip` 偵測到就不再引導）

## 行程概要
- 目的地：
- 日期：
- 天數：
- 人數與旅伴：
- 預算：（不含機票）

## 本趟行程設定（人的屬性請看 `../traveler-profile.md`）
- 預算等級：
- 核心興趣：
- 住宿等級：
- 住宿類型：
- 排除項：

## 關鍵檔案（相對於本行程資料夾）
- 旅行者畫像：`../traveler-profile.md`（所有行程共用，放在根目錄）
- 研究報告：`./research/` 目錄
- 最終行程：`./final-itinerary.md`（尚未生成）
- 行程網頁版：按需求產出（跟 Claude 說「幫我出 HTML」）
- 記帳檔：`./expense-log.md`（尚未生成）
- 行前清單：`./checklist.md`（尚未生成）
- 紙本緊急卡：`./emergency-card.md` / `.html`（尚未生成）

## 協作設定
- 語言：{使用者的對話語言}
- 行程輸出格式：{單一檔案/分日拆檔}
- Claude 模式：尚未設定（trip-research 第一次跑時詢問。值：no-agent / multi-agent / 尚未設定）

不要在根目錄 CLAUDE.md 附加 <!-- TRIP_METADATA_START --> 區塊 — 那是舊版的作法。新版所有 metadata 都在 ./$TRIP/trip-meta.md 裡，根目錄 CLAUDE.md 只保留 skill 規則。

6. 儲存畫像（存到根目錄的 ./traveler-profile.md）

重要範圍規則：

• traveler-profile.md 只存**「人的屬性」**（跨行程共用、不會因為這趟是獨旅下次是家庭就變）
• 這趟行程的**「本趟設定」**（旅伴、預算、住宿偏好、核心興趣、排除項、Claude 模式、行程格式…）不寫到 profile，它們在 $TRIP/trip-meta.md 裡
• 延遲收集：profile 有幾個欄位 /trip-plan 階段不需要，/trip-research 和 /trip-pack 跑到需要時會主動補問，不要在 /trip-plan 就硬問一堆

格式如下（只列 /trip-plan 當下可以填的 + 之後誰來補）：

# 旅行者畫像

> 建立日期：{date}
> 最後更新：{date}

這份檔案記錄**人的屬性**（所有行程共用）。本趟行程的設定（旅伴、預算、住宿、核心興趣…）在 `{編號}-{地點}-{日期}/trip-meta.md` 裡，不寫這裡。

| 項目 | 內容 | 由誰收集 |
|------|------|---------|
| 國籍 | | /trip-research 開始時（簽證查核需要）|
| 姓名（中文） | | /trip-pack 做緊急卡時 |
| 姓名（護照英文） | | /trip-pack 做緊急卡、對得上機票訂位 |
| 緊急聯絡人 | 姓名 / 關係 / 含國碼電話 | /trip-pack 做緊急卡時 |
| 護照狀態 | 有 ≥6mo / 6mo 內到期 / 過期 / 不確定 | /trip-research 開始時 |
| 同行兒童年齡 | | /trip-plan（若旅伴=家庭帶小孩）|
| 飲食 | 什麼都吃 / 素食 / 清真 / 過敏或忌口 | /trip-plan |
| 體力 | 暴走族 / 適中 / 需要常休息 / 行動不便 | /trip-plan |
| 語言能力 | 英文流利 / 基本溝通 / 完全不會 | /trip-plan（條件：旅行經驗=第一次出國）|
| 旅行經驗 | 第一次出國 / 去過幾次 / 老手 | /trip-plan |

首次 /trip-plan 只填標記 /trip-plan 的幾列（飲食、體力、語言能力、旅行經驗、同行兒童年齡）。其他欄位留空即可，不要硬填「（未填）」。/trip-research 和 /trip-pack 跑到需要時會主動問使用者。

寫入完成後告訴使用者：

已把你的旅行偏好存到根目錄 traveler-profile.md（所有行程共用）。這次行程的 metadata 存到 {$TRIP}/trip-meta.md。中途離開沒關係，下次打開這個資料夾就能接續規劃。

進度追蹤

使用 TaskCreate 建立 5 個任務（如果已存在就跳過），讓使用者在 UI 看到進度：

Task	subject	description
1	規劃旅行	建立旅行者畫像、確認目的地與基本資訊
2	研究目的地	平行研究景點、美食、交通、安全、住宿
3	排行程	生成每日行程表、記帳檔、旅途模式
4	審查行程	自動檢查錯誤並修正
5	行前準備	生成分階段打包清單

• 開始時：把「規劃旅行」設為 in_progress

• 完成時：把「規劃旅行」設為 completed，告訴使用者「跟我說『下一步』就會繼續（或直接打 /trip-research）」

  ⚠️ 不要在收尾推使用者用 /trip-research 自己的特定意圖詞（例如「研究目的地」），那會繞過 /trip 的進度偵測。讓使用者統一用「下一步」走 dispatcher 最安全。