| 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. 決定：修改現有行程，還是建立新行程？
這是新增的關鍵步驟。先理解當前倉庫狀態：
- 用
Bash ls -1d [0-9]*-*-[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]/ 2>/dev/null 列出所有現有行程資料夾
- 用 Read 嘗試讀
./current-trip（可能不存在）
依下列分支處理：
0.5a. 完全沒有任何行程資料夾 → 直接進「建立新行程」流程
告訴使用者：「這個倉庫還沒有任何行程，我來幫你建立第一個。」進下面「建立新行程」分支（步驟 1 以後）。
$ARGUMENTS 帶了目的地就直接採用，沒帶就在步驟 1 收集。
0.5b. 有現有行程，current-trip 指向其中一個有效資料夾
先靜默檢查「上次規劃是不是跑到一半被中斷」：看 ./{current-trip 內容}/trip-meta.md 是否存在。
(i) trip-meta.md 存在 → 規劃已完成。用 AskUserQuestion 問：
- 題目：「目前指向 {current-trip 內容}，你想怎麼做？」
- 選項：
- 「修改這個行程的設定 / 畫像」（Recommended）— 不建新資料夾，只更新現有 trip-meta.md 和 traveler-profile.md
- 「切換到其他現有行程」— 用第二次 AskUserQuestion 列出所有現有資料夾讓使用者選，選完把名字寫回
./current-trip，然後當作「修改這個行程」處理
- 「🆕 建立一個全新行程」— 進「建立新行程」分支
(ii) trip-meta.md 不存在 → 上次 /trip-plan 建了資料夾但規劃中斷（可能是 timeout、使用者中離、或 app crash）。用 AskUserQuestion 問：
- 題目：「上次規劃到一半沒完成，要怎麼處理 {current-trip 內容}？」
- 選項：
- 「接續完成規劃」（Recommended）— 沿用該資料夾名，從本 skill 的步驟 1（基本資訊）重新收集，之前未寫入的資料靠對話補齊
- 「放棄、從頭建新行程」— 刪掉該資料夾（
rm -rf $TRIP），清空 current-trip，進「建立新行程」分支
0.5c. 有現有行程，但 current-trip 不存在 / 空 / 指向不存在的資料夾
用 AskUserQuestion 問：
- 題目：「偵測到已有的行程，你想怎麼做？」
- 選項：列出每個現有資料夾（用白話「地點 — 開始研究 YYYY-MM-DD」顯示）+「🆕 建立一個全新行程」
使用者選了現有某個 → 寫入 ./current-trip，進「修改這個行程」分支
使用者選了「建立新行程」→ 進「建立新行程」分支
0.6. 建立新行程分支 — 取得行程資料夾名
這一步只在「建立新行程」時執行。
- 地點：問使用者「這次要規劃去哪？」（
$ARGUMENTS 帶了就直接用、不再問）。使用者怎麼回就怎麼用（城市、國家、區域皆可，不強迫指定國家）。例如「布達佩斯」「日本」「北歐」「沖繩」都接受
- 日期：用
Bash date +%Y-%m-%d 抓今天系統日期，不問使用者（規則：YYYY-MM-DD 是「開始研究的日期」而非旅程日期）
- 編號：掃現有資料夾抓最大編號，下一個 = 最大值 + 1；沒有任何行程時從 1 開始
- 組出資料夾名
{編號}-{地點}-{YYYY-MM-DD}，用 Bash mkdir -p "{資料夾名}" 建立
- 用 Write 把資料夾名寫入
./current-trip（純文字，無額外空白/換行）
告訴使用者「已建立 {資料夾名}/，接下來這次規劃會寫進這個資料夾」，然後往下走收集基本資訊。
重要：往下所有步驟裡的 $TRIP 代表「當前行程資料夾名」（步驟 0.5 / 0.6 解出來的那個）。檔案路徑都要用 ./$TRIP/...，不要寫到根目錄（例外：traveler-profile.md 在根目錄共用）。
1. 這次旅行的基本資訊（先讓使用者有目標感）
若在 0.5b 選了「修改這個行程的設定 / 畫像」分支，跳過此步驟 — 因為目的地 / 日期已經在既有 trip-meta.md 裡，直接進步驟 2。
若在 0.6 建立了新行程資料夾：目的地已經由使用者告訴我們（資料夾名裡那個「地點」），不重複問。繼續收集其他基本資訊：
- 什麼時候？（大概日期，有機票就給航班資訊）
- 幾天？
- 預算？（不含機票，抓範圍就好）
用一般對話收集（不用 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 最安全。
