Spec、Plan、Handoff
結構化你的工作讓下個 session 順利接續
⏱ 預估 ~4 分鐘
01 · 讀一讀
最後，每場 Claude Code session 會結束。可能 context 滿。可能你關筆電。可能你交工作給隊友。
問題是 — 下個 session 能順接嗎？
答案看你文件寫得多好。這就是 spec 出場的地方。Spec 是描述功能、bug 修、或任務的 markdown 檔，夠詳細到 Claude(或隊友)能冷開始接。
重點整理
- Session 會結束 — context 暫時，spec 永久
- Spec 讓下個 session(或人)接，不用重新解釋
- Spec 是描述什麼、為什麼、怎麼做的 markdown 檔
- 住你 repo(常常在 specs/ 資料夾)、commit 到 git
02 · 看程式碼
好 spec 回答：我們在蓋什麼、哪些檔牽涉、「完成」長什麼樣？下面是 template。
Feature spec template
# Feature: OAuth Integration
## Requirements
- Support Google and GitHub OAuth
- Maintain session after page refresh
- Handle token refresh automatically
## Files to Modify
- src/auth/oauth.ts — OAuth client setup
- src/auth/session.ts — Session persistence
- server/routes/auth.ts — API endpoints
## Implementation Plan
1. Set up OAuth provider configuration
2. Add login flow UI components
3. Implement token refresh logic
4. Add integration tests
## Done When
- `npm test` passes
- Can log in with Google and GitHub
- Session survives page refresh
看結構 — 需求（什麼）、檔（哪裡）、計畫（怎麼）、完成定義（何時停）。這夠 Claude 在新 session 開始這功能。指 Claude 看 spec 檔說「實作這個」。
03 · 讀一讀
複雜改動，Claude Code 有 plan 模式。不是立刻寫程式，Claude 探索程式碼庫、了解現有模式、實作前提計畫。
你也可以checkpoint 你的工作。按 Esc+Esc 開倒帶選單 — 你可以還原程式碼跟對話到任何前一個點，或從 checkpoint 總結釋出 context。
想 checkpoint 像本機 undo — 它們追蹤 Claude 每次改動，你永遠能倒回去。
重點整理
- Plan 模式：Claude 實作前探索跟提計畫
- Checkpoint：每次改動前自動建
- Esc+Esc 開倒帶選單 — 還原程式碼、對話、或都還原
- 「從這裡總結」壓縮那點前所有東西
- Checkpoint 是 session 本機（跟 git 分開）
04 · 看程式碼
下面是有經驗工程師怎麼結構化 Claude Code 的複雜工作。
階段 1 — 探索
You: "Read the auth module and explain how sessions work"
Claude: [reads files, explains architecture]
階段 2 — 計畫
You: "Write a spec for adding OAuth support"
Claude: [creates specs/OAUTH_SPEC.md with requirements, files, plan]
階段 3 — 實作
You: "Implement the spec in specs/OAUTH_SPEC.md"
Claude: [implements against the spec, step by step]
階段 4 — 驗證
You: "Run tests and verify against the spec"
Claude: [runs tests, checks each "done when" criterion]
Spec 變成 session 之間的橋。實作中途 context 滿，開新 session 說「繼續實作 specs/OAUTH_SPEC.md」。Claude 讀 spec、看 git 看完成了什麼、接續做事。
05 · 選擇題
你做複雜功能做到一半 context 滿。在新 session 繼續最好的方法？
- 指 Claude 看你 spec 檔請它繼續
- 重來從頭重新解釋一切
- 複製貼上整個前面對話
- 放棄功能做簡單的
06 · 填空
按 Esc 兩次開 _____ 選單，你可以還原程式碼跟對話到前一點。
⚠ 完整互動體驗需要 JavaScript。請啟用 JavaScript 後重新整理。
※ 本站為獨立繁中教學專案，非 Anthropic 官方產品。Claude™ 為 Anthropic, PBC 商標。