backup

name	backup
description	把目前所有未儲存的旅行檔案變更一次存到雲端（commit + push + merge to main）。**只在使用者明確說『儲存』『保存』『存到雲端』『commit』『存起來』『備份』『上傳』時觸發**，或是使用者看到「尚未儲存」提示後主動要求儲存時觸發。**不要在 Claude 自己寫完檔後主動呼叫**（那樣會煩到使用者）。給外行人用，全程不需要懂 git。
user-invocable	true

/backup — 把旅行變更存到雲端

使用與使用者相同的語言回覆（預設繁體中文）。

對 trip 規劃使用者來說，雲端 sandbox 是短暫的，session 結束未存的變更就消失。這個 skill 把整個倉庫（含根目錄檔案、所有行程資料夾）的變更一次存到雲端 GitHub repo。

多行程也是一次存：這個倉庫可能有多個行程資料夾（1-布達佩斯-2026-04-24/、2-日本-2026-10-03/…）+ 根目錄檔案（current-trip、traveler-profile.md 等）。/backup 用 git add -A 把全部一次打包存起來，不分行程。使用者不需要選「要存哪一個行程」。

措辭規則（重要）

只用這些詞：儲存、雲端、變更、檔案 禁用：commit、push、merge、branch、staging、stash、HEAD、origin、main、master

99% 使用者不是工程師。看到 git 術語會立刻迷失。

流程

1. 檢查有沒有變更

git status --porcelain

沒輸出（無變更） → 直接告訴使用者「目前沒有需要儲存的變更 ✓」，結束。

有輸出 → 進入步驟 2。

2. 列出變更給使用者看 + 確認

用 git status --porcelain 的輸出整理成簡短中文描述，例如：

你有以下變更還沒儲存：

• 行程表
• 記帳檔（加 3 筆花費）
• 研究報告（attractions、food）

接著用 AskUserQuestion 問：

• 問題：「確定全部存到雲端嗎？」
• 選項 1：「好，存」（Recommended）
• 選項 2：「先不要，我再看一下」

3. 寫 commit message + 推上去 + 整理到主線

使用者選「好」後：

1. 看 git diff --cached 與 git diff（含未 staged 的）內容，自己寫一段簡短中文 commit message 描述這次主要變動。例如：

   • 「加入記帳：午餐 25 歐元、地鐵票 14 歐元」
   • 「更新第 3 天行程：博物館改下午」
   • 「研究報告：景點與美食」
   • 變動雜時用「更新旅行檔案」當保底

2. 執行（全部依序，不要跳步驟）。重要：必須拆成多個獨立的 bash 呼叫，不要用 && 把全部串成一行，否則一個失敗就看不出哪步出錯，而且最後的 cleanup 失敗會把整個任務標記成失敗。

   Step A — 存當前變更：

   git add -A && git commit -m "<你寫的 commit message>"
   

   Step B — 偵測 branch 並決定路線：

   git rev-parse --abbrev-ref HEAD
   

   如果輸出是 main 或 master：直接推上去

   git push origin HEAD
   

   完成，跳到下面「成功回報」。

   否則（在 feature branch，記下名字 <CUR>）：以下每一步獨立呼叫：

   B1. 推 feature branch（讓雲端先有備份）：

   git push origin <CUR>
   

   B2. 切到主線：

   git checkout main 2>/dev/null || git checkout master
   

   B3. 拉最新主線：

   git pull origin HEAD
   

   B4. 把 feature 合併進主線（這是關鍵步驟，失敗要中止並回報）：

   git merge --no-ff <CUR> -m "整合 <CUR> 的變更"
   

   B5. 推主線（這也是關鍵步驟，失敗要中止並回報）：

   git push origin HEAD
   

   ⬆️ 到 B5 為止，使用者資料已經安全在雲端 main 上。下面 B6 / B7 只是清理，失敗也不要回報失敗、不要顯示錯誤訊息給使用者，靜默跳過即可。

   B6. 刪本機 feature branch（best-effort）：

   git branch -d <CUR> 2>/dev/null || true
   

   B7. 刪遠端 feature branch（best-effort，sandbox 的 git proxy 常回 403，不算錯）：

   git push origin --delete <CUR> 2>/dev/null || true
   

3. 失敗判斷規則：

   • Step A / B4 / B5 任一失敗 → 告訴使用者「儲存遇到問題，{簡短說明，避免術語}」。。

4. 成功回報

✓ 已儲存到雲端

剛剛的變更全部存好了，現在關掉視窗也不會不見。

不要做的事

• 不要分多個 commit。一次儲存 = 一次 commit。
• 不要解釋 git 流程給使用者。
• 不要問使用者「commit message 要寫什麼」— 自己決定。
• 不要在使用者沒選「好」前就執行 git add / commit / push。