一種高效的狀態轉移協定，旨在跨不同工作階段凍結、封裝並恢復 AI agent 工作流。
安裝與下載
1. ClawHub CLI
從來源直接安裝技能的最快方式。
npx clawhub@latest install handoff-session
2. 手動安裝
將技能資料夾複製到以下位置之一
~/.openclaw/skills/ <project>/skills/ 優先級：工作區 > 本地 > 內建
3. 提示詞安裝
將此提示詞複製到 OpenClaw 即可自動安裝。
請幫我使用 Clawhub 安裝 handoff-session。如果尚未安裝 Clawhub，請先安裝（npm i -g clawhub）。
想要直接下載？
取得包含原生技能檔案的ZIP壓縮檔。
什麼是 Handoff Protocol V2？
Handoff Protocol V2 是一個專門的上下文管理框架，旨在解決長時間執行的 AI 互動過程中的上下文遺失問題。它不僅提供簡單的摘要，還生成一個「最小可行交接」包，擷取新工作階段從上次中斷處精確恢復所需的準確狀態。透過在 Openclaw Skills 中實施此協定，開發人員可以繞過上下文視窗限制，並保持高保真度的任務執行，而無需向 agent 重新解釋專案背景。
該協定建立在「行動力高於敘述」的哲學之上。它避免儲存臃腫的對話日誌，而是專注於工作區的凍結快照。這確保了在將 Openclaw Skills 用於開發或研究時，工作階段之間的過渡幾乎是瞬時的，並以結構化的 Markdown 格式保留決策、約束和待處理操作。
Handoff Protocol V2 應用場景
- 當 LLM 上下文視窗趨於飽和時，遷移活躍的開發工作階段。
- 暫停多步驟工作流以便稍後或在不同環境中恢復。
- 在不同的專業化 AI agents 之間移交特定的專案狀態。
- 凍結工作區狀態，為子任務提供乾淨的起點。
Handoff Protocol V2 運作原理
- 使用者透過發出停止或遷移工作的意圖信號來觸發交接。
- agent 執行 handoff out 命令來凍結目前工作狀態。
- 生成一個結構化的 handoff.md 檔案，包含八個強制資料插槽，包括目前任務、狀態和關鍵決策。
- agent 進行壓縮處理，移除不必要的敘述，並將檔案保持在建議的 120 行限制內。
- 在新工作階段中，使用者執行 handoff in 命令來載入狀態。
- agent 提供恢復狀態的預覽，並在執行下一個識別的步驟之前等待使用者確認。
Handoff Protocol V2 設定指南
要在您的 Openclaw Skills 環境中啟用此功能，請確保您的 agent 可以存取提供的 shell 腳本。使用以下命令初始化或管理您的交接狀態：
# 確保交接腳本是可執行的
chmod +x scripts/handoff_file.sh
# 列出最近的交接 ID 以查找要恢復的狀態
./scripts/handoff_file.sh list
Handoff Protocol V2 資料結構與分類體系
該協定在專用目錄結構中組織其中繼資料，以確保在 Openclaw Skills 工作階段中實現持久化。每個交接都儲存在唯一的 ID 資料夾中。
| 檔案路徑 | 用途 |
|---|---|
| ~/.agents/handoff_context/ |
包含 8 個強制插槽的主要狀態容器。 |
| scripts/handoff_file.sh | 用於建立、列出和讀取交接包的公用程式腳本。 |
| references/templates.md | 用於確保結構一致性的標準 Markdown 模板。 |
每個 handoff.md 檔案必須包含：目前任務、目前狀態、已完成項目、關鍵決策、關鍵約束、關鍵檔案 (path:line)、下一步和待確認項目。
Handoff Protocol V2 進階特性
- 智能狀態壓縮：自動剝離討論歷史，優先處理具行動價值的實施事實與結論。
- 零摩擦恢復：該協定強制執行特定的「下一步」插槽，其中必須包含可執行的操作，允許 agent 在載入後立即開始工作。
- 八插槽驗證：嚴格的架構檢查確保在沒有約束或阻塞項等關鍵資料的情況下不會儲存交接。
- 上下文遷移：專門針對在使用 Openclaw Skills 時在不同 AI 模型之間移動進行了優化，確保即使模型發生變化也能保留技術真相。
- 恢復預覽：在 agent 與檔案系統互動之前，透過呈現「凍結」狀態的摘要來防止意外操作。
SKILL.md
加載中
Openclaw 相關技能
精選*
