交接難題
當你開始新的 Claude Code 會話時,所有上下文都消失了。你得重新解釋你在做什麼、哪些檔案重要、還剩什麼要做。
/note-context 透過建立一則釘住的藍色筆記來解決這個問題,裡面有下一個會話需要的一切。
輸出區塊
| 區塊 | 內容 |
|---|---|
| 標頭 | project @ branch | N 個未提交變更 |
| 正在處理 | 目前任務,具體又清楚 |
| 關鍵檔案 | 3-5 個最重要的檔案,附 5 個字的註解 |
| 狀態 | 分支用途、未提交摘要、循環進度 |
| 關鍵決策 | 只限這次會話做的決策 |
| 未解決的問題 | 尚未解決的項目與未知數 |
| 接續方式 | 給下一個會話的確切指示 |
關鍵檔案格式
每個檔案都有簡短的註解:
src/auth.ts — JWT 驗證 middleware(重構中)
src/api/users.ts — 新端點,需要測試
tests/auth.test.ts — 3 個測試在 refresh 上失敗
最多 5 個檔案。只放最相關的。
「接續方式」區塊
這是關鍵區塊。品質標準:
只讀 「接續方式」 就該讓新的會話知道接下來要做什麼。
好:
接續方式:修正 src/auth.ts:45 的 refresh token 流程。
validateToken 函式需要檢查 token 是否過期,
並在回傳 401 前呼叫 refreshToken()。
用這個跑測試:npm test -- auth
不好:
接續方式:繼續做 auth。
永遠釘住
上下文筆記永遠是:
- 藍色
- 釘在所有視窗上方
- 不到 3 小時就更新,否則建立新筆記
同時只有一則進行中的上下文筆記 — 永遠是最新的快照。
非 Git 模式
不需要 git 儲存庫也能用。略過 git 相關區塊(分支、未提交變更),專注在筆記狀態與你提供的上下文。
時間戳記
每則上下文筆記都包含確切時間:
Context 2026 年 2 月 19 日 23:15