Agent Handoff Kit · v0.4.3

Session
接力棒

Agent Handoff Kit 把進度、重要決定、文件位置和未完事項留在你的專案裏，讓下一個 AI 找得到。

這份說明包含尚未發布的更新；正式下載可用的功能，以已發布版本為準。

看常用指令先安裝

替你留下甚麼？

沒有交接時，你往往要重講背景、重找文件，還要提醒 AI 哪些路已試過。用了這套工具，這些重要內容會留在專案裏；你仍然提出需求和決定，AI 負責整理與核對。

接上上次，不用重新交代一遍。

長任務換了對話，最容易漏掉的是之前的決定、你的修正和未完事項。這套工具讓 AI 保存這些內容；下次先讀齊交接，再說明目前狀態。

開工接力 →

重要文件，下一個 AI 也找得到。

新文章、參考 PDF、工作計劃，不應只留在當次對話。這套工具記下文件用途、何時要讀、哪些改動需要一起更新，減少拿錯版本或漏用資料。

檢查文件關係 →

做了幾個月，仍找得回原因。

除了目前進度，也保留重要決定、選擇原因和工作紀錄。你問「之前為甚麼這樣做」，AI 可循紀錄查回；紀錄變長時會按需要整理和封存，不必每次全部重讀。

查看歷程 →

換工具，沿用同一份專案。

在支援的 AI 工具中打開同一資料夾，可沿用已保存的交接和工作要求。專案自己的內容與官方提供的內容分開處理，升級時保留自訂內容，遇到衝突先停下。

保存日後要求 →

你講目的，AI 按任務做事。

你不需要選工作模式或背規則名稱。只要說想完成甚麼，AI 便按任務採用合適的做法；資料不足時，只問會影響結果的問題。

寫文章、改簡報

先看讀者、用途和語氣，再寫成適合使用的內容。

查資料、比較選擇

核對來源與日期，分清事實、推論和仍未確認的部分。

做網頁、寫程式、修問題

先讀相關檔案，保留既有改動，完成後檢查實際結果。

整理文件、使用雲端工具

分清原始資料、筆記和成品，核對連接與權限；寫入後再讀回確認。

要操作時，選一個指令。

在專案的 AI 對話輸入指令，不是在終端機。Claude Code、Gemini CLI、Antigravity CLI 用 /；Codex 用 $，也可從 /skills 選取。

新安裝或升級會一併放好，只供目前專案使用，不需額外啟用。點選指令看例子和用法。

查看全部指令：新手引導、整理文件、記住要求、檢查及更新 →

專案全貌，看得見。

用 handoff-kit-progress，看現在做到哪裏、還欠甚麼，以及之前怎樣走到這一步。總覽看目前工作；歷程可按日期找回變更；文件地圖看重要資料的用途和關係。

實際介面截圖；Atlas 是虛構範例。點圖放大，每個專案會顯示自己的紀錄。

查看英文介面

AI 保存紀錄後，畫面自動更新，不用刷新。叫 AI 開頁面和保存紀錄會用一些 token；之後查看、篩選和畫面更新不另叫 AI。未保存的工作不會出現。

進度頁用法及常見問題 →

第一次用，把這句交給 AI。

在要工作的專案資料夾打開 AI，把下面一句貼進對話。AI 會先確認資料夾，再安裝或升級及檢查，你不用選指令。

請讀取 https://adamchanadam.github.io/agent-handoff-kit/agent-handoff-kit-ai-install.html ，並在這個資料夾安裝或升級 Agent Handoff Kit。

需要能讀寫專案資料夾的 AI 工具及 Node.js 18 以上。普通網頁聊天若不能存取資料夾便不適用；不確定時先請 AI 檢查。已有舊版或 AI 工作文件也用同一句。

接得上，也要知道界線。

AI 要先讀齊交接，才可說已接上。單獨開工只說明現況；你提出任務後才開始做事。收工可以保存未完成工作，不代表整個專案完成。

上傳、發布、刪除重要資料或更改權限前，AI 須說明影響並取得所需批准。密碼和金鑰不能寫入交接。這套工具用規則和檢查協助交接，不能保證 AI 永不出錯。

保護你的資料和其他工作。

用完外部工具後，AI 只應關閉確定屬於這次工作的臨時程式；不清楚歸屬時先問，避免中斷你其他工作。權限不足或檔案被鎖時，要說明限制，不強行繞過。

可選配合使用

這套工具保存專案在不同對話之間的交接。想另外設定 AI 每次回覆的語氣和做事習慣，可選用 Adam-AI-Instructions，並非必要安裝。