前言¶
換 AI Agent 時最常見的問題不是能力不夠，而是狀態丟失：上次改到哪、構建命令是什麼、哪些任務已阻塞或取消、下一次進入項目應該從哪繼續。聊天記錄不能長期作爲項目狀態，散落在各處的 TODO 也不能被下一個 Agent 穩定讀取。AgentHandoff 嘗試把“項目進度”收斂到一個統一交接看板 handoff.md，並讓進入項目的 Agent 在缺少該文件時自主初始化。
這是什麼¶
AgentHandoff 是一個 community 來源的 ai-agent 類 Skill，座標 @user_9e60f203/agent-handoff，當前版本 3.0.2，發佈者 user_9e60f203，標籤顯示 requires_api_key=false。它解決的問題是：不同 AI Agent 進入同一個新項目時，如何快速恢復上下文、繼承任務狀態，並在中斷或換 Agent 後繼續推進。
核心功能¶
它提供的能力集中在項目接管與交接治理：
- 統一交接看板：以
handoff.md作爲跨 Agent、跨會話的項目狀態入口。 - 智能多技術棧自主初始化：新項目缺少
handoff.md時，Agent 可自動觸發初始化。 - 推導項目構建命令：初始化過程中嘗試推導項目的構建/驗證命令，減少人工口述。
- 薄入口：入口保持輕量，便於進入項目時先讀取狀態，再展開具體實現。
- 版本備份：交接狀態可備份，降低單文件覆蓋或誤改帶來的恢復成本。
- 智能拆分：對複雜任務或交接內容進行拆分，避免單份狀態文件過度膨脹。
- 統一日誌：會話與任務推進過程納入統一日誌，便於回溯。
- 任務阻塞與取消狀態管理：記錄任務被阻塞或取消的狀態，而不是隻保留“待辦/完成”。
- 中斷接管自愈：Agent 中斷後重新接管時，可基於已有狀態繼續處理。
官方簡介將其適用面描述爲 Claude Code、Codex、Antigravity、Trae、Cursor、Windsurf、GitHub Copilot 等 Agent。實際能否自動觸發，仍取決於運行這些 Agent 的環境是否按 SKILL.md 方式加載並執行該 Skill。
安裝與啓用¶
已抓取資料沒有給出具體安裝命令、目錄寫入方式或 Cursor / Codex CLI / Claude Code 的差異配置。爲避免編造，這裏只列可覈對的官方入口與座標：
SkillHub 頁面: https://www.skillhub.cn/skills/user_9e60f203/agent-handoff
官方地址: https://api.skillhub.cn/user_9e60f203/agent-handoff
座標: @user_9e60f203/agent-handoff
版本: 3.0.2
來源: community
分類: ai-agent
啓用方式應以官方頁面當前說明爲準；若你的客戶端支持 SKILL.md 類 Skill，需要確認它是否允許項目內自動初始化 handoff.md，再決定是否開啓。
典型用法¶
官方簡介給出的觸發場景包括：開始或結束一次 agent coding session、在項目中自動初始化 handoff state、在 agent 之間交接工作、查看項目任務看板、創建 session logs、備份 handoff state。可復現的用法主線如下：
- Agent 進入項目後先檢查是否存在
handoff.md。 - 若不存在，按 Skill 流程初始化交接看板。
- 初始化時推導項目構建命令，並寫入可被後續會話讀取的狀態。
- 任務推進過程中記錄進度、阻塞、取消和日誌。
- 需要換 Agent 或會話中斷時，從
handoff.md恢復上下文。 - 交接前按版本備份機制保存狀態，避免覆蓋上一版進度。
適用場景與注意¶
適合這幾類場景：新項目首次交給 AI Agent；同一項目長期由多個 Agent 或多次會話接力；任務較長且存在阻塞、取消、恢復等狀態；需要統一日誌做審計或回溯。
需要注意的點：handoff.md 是項目級狀態文件，自動初始化和自動推導命令能降低啓動成本，但生成內容仍應在首次接入項目時人工覈對，尤其是構建命令、目錄結構和任務邊界。多 Agent 同時寫同一個項目時，還要處理寫衝突和備份策略；如果客戶端不支持 Skill 自動觸發，“零人工干預”只會停留在協議描述，不會實際發生。
結尾¶
AgentHandoff 的價值在於把“換 Agent”從重新解釋項目，變成讀取並維護一份可繼承的交接狀態。它不替代工程實踐，但能讓項目進度、任務狀態和會話日誌有一個統一落點。官方地址：https://api.skillhub.cn/user_9e60f203/agent-handoff
