Save All

---
name: save-all
description: '重開機／關機／收工前的「落地同步」收尾檢查。在每個還開著的對話 session 裡各跑一次，把只活在這個對話裡、還沒寫進磁碟的東西全部外部化並驗證真的落地，然後回報「安全可重開 / 還有 X 沒同步」。當使用者說「要重開機了」「save-all」「/save-all」「準備重開」「關機前收尾」「reboot 前」「今天收工」時觸發。⚠️ 本 skill 只做落地＋回報，不重開機器。 English triggers: "save-all", "about to reboot", "shutting down", "wrapping up for today", "before restart".'
---

# /save-all — 收工前的落地收尾

重開機（或單純收工）前，在**每個還開著的對話 session** 裡各跑一次。

## 為什麼需要

- Session 一關，**對話 context 就沒了**。「只活在這個對話裡、還沒寫進檔案的東西」—— 學到的教訓、剛冒出來的待辦、做到一半的工作狀態 —— 全部蒸發。
- 落地 = 把它們外部化成磁碟上的檔案。
- 而且**寫入可能靜默失敗**（工具回「成功」但檔案沒變的情況真實存在）→ **落地後一定要驗證真的寫進磁碟**。這是本 skill 的鐵則，不是可選步驟。

> 🤖 R2-D2 時刻：Death Star 圖紙如果只存在 Leia 的腦子裡，Tantive IV 被攔截時就全劇終了。
> 存進 R2、彈射逃生艙 —— 資料落地，故事才能繼續。

## 動作（依序做完、逐項回報）

### 0. 校時，並把時間報成回覆第一行

**⏰ 回覆的第一行固定是** `⏰ <YYYY-MM-DD（週幾）HH:MM> <IANA 時區>` —— 例 `⏰ 2026-03-09（一）10:12 Europe/Berlin`。落地紀錄的時間別憑印象寫；時區也不可省，人與機器不在同一時區時，沒有時區的時間讀不出是哪裡的幾點。

零依賴取法（macOS／Linux 通用，不需 python），順手把**起點**落成檔案 —— 第 5 步要讀它算耗時：

```bash
set -- $(date '+%Y-%m-%d %u %H:%M')
case $2 in 1) w=一;; 2) w=二;; 3) w=三;; 4) w=四;; 5) w=五;; 6) w=六;; 7) w=日;; *) w=;; esac
tz=${TZ:-$(readlink -f /etc/localtime 2>/dev/null || readlink /etc/localtime 2>/dev/null)}
tz=${tz#:}; tz=${tz##*/zoneinfo/}
[ -f "/usr/share/zoneinfo/$tz" ] || [ -f "/var/db/timezone/zoneinfo/$tz" ] || tz="$(date +%Z)（非 IANA 名稱）"
[ -n "$1" ] && [ -n "$w" ] && printf '⏰ %s（%s）%s %s\n' "$1" "$w" "$3" "$tz" || echo '時間取不到完整值'
M=$(mktemp "${TMPDIR:-/tmp}/save-all-XXXXXX") && date +%s > "$M" && echo "起點檔=$M" || echo '起點檔沒建成——第 5 步的耗時寫「未知」'
```

三個地方別省：① 星期用 `%u`（1–7）對照表——`date '+%A'` 給的是 locale 決定的 `Tuesday`／`星期二`，都不是「（二）」。② **一次 `date` 取齊所有欄位**，分開呼叫會在跨午夜時湊出「新日期＋舊星期」這種看不出破綻的錯。③ **最後那行驗證是整段的重點**：把切出來的名字拿回時區資料庫對，對不上就退成 `%Z` 縮寫並標「非 IANA」——多層符號連結的中繼目標、連結指向非時區檔、`$TZ` 裝的是 `PST8PDT`／`:Asia/Taipei` 這類 POSIX 寫法，全在這裡被擋下。🚫 寧可標「非 IANA」，也不要印一個猜出來的名字。

起點檔用 `mktemp` 不用寫死路徑：寫死的 `/tmp/<可預測名>` 在多人共用的機器上可以被別人先擺一條符號連結，`>` 就會以你的權限截斷別的檔案；同一秒起兩個 session 也會互相蓋掉。`&&` 串起來是為了**建不成就不准說建成了**。**記住輸出的起點檔路徑**，第 5 步要用。回覆語言不是中文時，週幾寫該語言慣用形式即可，不可省的是時區。

跑不了 shell 的環境（網頁版、無終端機）：用當回合系統給的時刻並自己補時區標籤；拿不到完整值就寫「時間取不到完整值」，🚫 別包裝成看起來合格的時間行 —— 這種環境也沒有起點檔，第 5 步的耗時照實寫「未知」。

### 1. 盤點本 session 的 in-flight

逐項自問「session 關掉後這個還在嗎？不在就落地」：

- **① 學到的教訓／決策／意外發現** → 該進長期記憶的（memory 目錄、專案筆記）
- **② 本 session 新長出的待辦** → 該進你的任務清單的
- **③ 要交給別專案／未來 session 的事** → 該寫交接卡的（→ `/dropoff`）
- **④ 改過的系統性設置**（裝/改/停排程、改自動化腳本、改設定檔）→ 該記進專案文件的
- **⑤ 進行到一半的工作敘事** → 該寫 HANDOFF／進度筆記的

若本 session 閒置、什麼 in-flight 都沒有 → 直接跳到第 5 步回報「無 in-flight、安全可重開」，**別硬湊**。

### 2. 逐項落地

- ①④⑤ → 寫進對應的筆記／memory／文件檔。
- ② → 進你的任務系統（沒有就寫進專案 TODO 檔）。
- ③ → 跑 `/dropoff` 寫交接卡（有這個 skill 就用它，別在這裡重寫邏輯）。

**每寫一項立刻驗證**：`wc -l` 看行數、`stat` 看 mtime 是剛剛、`grep` 新內容有命中 → 確認真落地。沒落地就重寫，**別信工具回的「成功」字面**。

### 3. flush git（若本 session 動過 git 管理的目錄）

有 auto-sync 的目錄也一樣 —— 重開可能發生在下次自動同步之前，手動推一次別等：

```bash
git add -A && git commit -m "pre-reboot flush $(date +%m%d-%H%M)" && git push
```

（commit 前瞄一眼 `git status`，確認沒把不該進 repo 的東西帶進去。）

### 4. 統計本次 save-all 消費的 token（Claude Code CLI 限定，選跑）

> Cowork／claude.ai 環境沒有本機 transcript，這一步直接跳過，不影響其他步驟。

讀本 session transcript 的真實 `usage`（不要自估 —— 模型無法可靠內省自身用量）：

```bash
tx=$(find ~/.claude/projects -name "${CLAUDE_CODE_SESSION_ID}.jsonl" 2>/dev/null | head -1)
[ -n "$tx" ] && python3 - "$tx" <<'PY'
import json,sys
i=o=cc=cr=n=0
for line in open(sys.argv[1]):
    try: u=json.loads(line).get('message',{}).get('usage')
    except: continue
    if not isinstance(u,dict): continue
    i+=u.get('input_tokens',0); o+=u.get('output_tokens',0)
    cc+=u.get('cache_creation_input_tokens',0); cr+=u.get('cache_read_input_tokens',0); n+=1
print(f"session 累計 {n} turns: input={i:,} output={o:,} cache_creation={cc:,} cache_read={cr:,}")
PY
```

### 5. 回報 go/no-go

逐項複驗後給明確信號：

- ✅ **全部落地、無 in-flight 殘留** → 「安全可重開」＋列出這次落地了什麼、寫進哪個檔。
- ⚠️ **還有 X 沒同步** → 列出未落地項目與原因，「建議先處理 X 再重開，或你接受風險重開（會掉 X）」，讓使用者決定。

**末尾必附時間行**（第 4 步有跑的話，token 統計行接在它後面）：

```bash
M=/tmp/save-all-XXXXXX   # ← 換成第 0 步印出的那個路徑（照抄這行只會印「耗時未知」）
set -- $(date '+%Y-%m-%d %u %H:%M'); n=$(date +%s)
case $2 in 1) w=一;; 2) w=二;; 3) w=三;; 4) w=四;; 5) w=五;; 6) w=六;; 7) w=日;; *) w=;; esac
tz=${TZ:-$(readlink -f /etc/localtime 2>/dev/null || readlink /etc/localtime 2>/dev/null)}
tz=${tz#:}; tz=${tz##*/zoneinfo/}
[ -f "/usr/share/zoneinfo/$tz" ] || [ -f "/var/db/timezone/zoneinfo/$tz" ] || tz="$(date +%Z)（非 IANA 名稱）"
s=$(cat "$M" 2>/dev/null)
case $s in ''|*[!0-9]*) e=耗時未知 ;; *) [ "$s" -le "$n" ] && e="距起點 $(( (n - s) / 60 )) 分" || e=耗時未知 ;; esac
printf '⏰ %s（%s）%s %s（%s）\n' "$1" "$w" "$3" "$tz" "$e"
```

🔴 **這一行要現跑，不可沿用第 0 步那一行** —— 這支常跑二三十分鐘，沿用就是報一個過期的時間。**耗時交給 shell 從起點檔算**，不要自己心算。起點檔讀不到、內容壞掉、或起點居然比現在晚（機器中途校過時），上面的 `case` 都會印「耗時未知」——照那個輸出貼，🚫 不要自己補一個看起來合理的數字。耗時是牆鐘算的，遇到系統校時或休眠會失準，這是它的上限。

⚠️ 誠實界定：耗時由機器算、來源明確；但「這一行確實是現跑的」**沒有機械證據**能自證 —— 別聲稱有，也別用頭尾差值當證明（同一分鐘收工差值本來就是 0，而差值本身照樣可以用寫的）。這條規則靠的是紀律，不是防呆。

## 鐵律

- 🚫 **本 skill 不重開機器**，只做落地＋回報；重開由使用者自己按。
- ⏰ **頭尾都報時間**（含 IANA 時區）：結尾那行現跑、耗時由機器從起點檔算，不沿用開頭那行、不心算。
- ✅ **落地一定驗證真的寫進去**。
- 🔁 **每個開著的 session 各跑一次** —— 各 session 只知道自己的 in-flight，別想在一個 session 裡代跑別的。
- 📝 **隨做隨記、逐項回報**，別等最後批次補。