handoff

handoff 技能總覽

handoff 技能的作用

handoff 會把目前對話整理成一份精簡的交接文件，方便下一位 agent 接手。它特別適合你需要快速延續上下文的時候：把重點、已決定的事項，以及下一段 session 應該做什麼，清楚濃縮出來。

誰適合使用

如果你要在不同 session 之間交接工作、把任務轉給另一位 agent，或是先整理一份可直接給 AI 接續執行的簡報，就適合使用 handoff 技能。它對 repo 工作、多步驟產品任務，以及任何一旦上下文遺失就會造成返工的流程尤其有用。

為什麼它不一樣

handoff 的核心價值不是一般性的摘要，而是要產出一份可直接行動的文件。它會避免重複已存在的素材，並透過路徑或 URL 把下一位 agent 導向正確的原始來源。這讓它比單純的「總結這段對話」提示詞更實用。

如何使用 handoff 技能

安裝 handoff，先從技能檔案開始

一般進行 handoff install 時，先從 repo 加入這個技能，然後先打開 SKILL.md：

npx skills add mattpocock/skills --skill handoff

接著先讀 SKILL.md，理解它的輸出格式與行為，再套用到你的工作流程中。

給這個技能一個明確的下一段 session 目標

handoff usage 這種模式最好在你明確告訴它下一段 session 的目的時使用。repo 裡的參數提示，期待的是像這樣的聚焦說明：

• 「繼續除錯 payments 套件的 TypeScript build failure。」
• 「接手 landing page 文案審查，並定稿 CTA 變體。」
• 「在 API schema 變更後，恢復 auth flow 的實作。」

像「幫我做一份 handoff」這種太模糊的請求，產出的文件通常會比較弱。目標越清楚，技能就越能判斷哪些內容該放進交接文件，哪些可以省略。

寫之前先讀對檔案

這個技能刻意做得很輕量，所以主要來源是 SKILL.md。同時也要查看它有提到的、附近的專案素材，而不是把那些內容直接複製進 handoff：

• README.md
• AGENTS.md
• metadata.json
• 如果存在，還有 rules/、resources/、references/ 或 scripts/ 資料夾

如果工作內容已經寫在 PRD、plan、ADR、issue、diff 或 commit 裡，handoff 應該直接連到那裡，而不是重複摘錄。這樣可以保持文件精簡，也能讓下一位 agent 更快上手。

以下一位 agent 為對象，不是為自己寫

一份好的 handoff 文件通常會包含：

• 目前目標與進度狀態
• 已經做出的決策
• 尚未解決的問題或阻礙
• 下一步要檢查的精確檔案路徑、URL 或素材
• 後續 session 建議使用的技能

這是使用這個技能的核心原則：讓下一步一看就懂，不必重新說明整段專案歷史。

handoff 技能 FAQ

handoff 只適合很長的對話嗎？

不是。只要下一位 agent 希望少一點啟動成本，handoff 都有用，即使對話本身不長，但內容很複雜也一樣。當需要保留決策、相依關係或原始素材時，它的價值尤其高。

它和一般提示詞有什麼不同？

一般提示詞多半只要求摘要，然後就結束。handoff 技能的立場更明確：它是要產出一份交接文件，避免重複，並指出下一段 session 應該使用的正式素材。

handoff 適合新手嗎？

可以，只要你能清楚說出下一個任務。新手最容易得到好結果的方式，是先提供一個簡單明確的聚焦說明，讓技能幫你把交接整理成有用的簡報。

什麼時候不該使用 handoff？

當下一段 session 不需要延續上下文，或必要資訊已經完整記錄在既有素材、而下一位 agent 會直接閱讀那些素材時，就不要用 handoff。

如何改進 handoff 技能

讓下一段 session 的目標更具體

handoff 輸出的品質，取決於你把下一段 session 定義得有多精準。更好的輸入會直接指出具體階段、子系統或決策點，而不只是籠統地說專案名稱。

指向正確的單一事實來源

如果目前工作內容已經寫在文件、issue 或 diff 裡，就把那些參考附上，這樣 handoff 才能保持精簡。這一點很重要，因為這個技能的設計本來就不是要重複其他地方已經保存的內容。

把限制條件與未解問題一起寫進去

最有價值的 handoff 文件，會清楚記錄哪些地方還沒定案：實作阻礙、取捨、審查意見，或仍待確認的假設。這些細節能幫下一位 agent 避免重走前面的死路。

視情況建議後續技能

這個技能明確要求提供下一段 session 的技能建議，所以如果後續任務適合不同工作流程，就應該一起寫進去。比如說，handoff 可以依剩餘工作內容，帶下一位 agent 轉向規劃、寫程式或審查導向的技能。