這套工具的工作很窄,只是一件事:跨對話失憶。失憶不只是「上次做到哪」,還包括中途新建的文檔、你引入的參考資料。它的作用,是把進度、下一步、檔案登記寫進幾份固定文件,讓下一輪能自動接得回去。
每次開新對話都要重新交代背景、貼舊文件、列哪些檔案是真源、哪些只是參考,然後再講上次做到哪。一旦交代得不齊,AI 就會憑空推斷,把參考檔當真源,或者把你已做完的事重做一遍。
說一聲「收工」,AI 自動更新交接文件與檔案登記表,輸出一段「下次開工用的提示」。新對話開始時把那段字貼回去,下一個 AI 立即讀齊狀態:做到哪、下一步是甚麼、哪些檔案是真源、哪些只是參考。
如果你曾經和 AI 講了一個小時,隔日回來它甚麼都不記得;又或者你建過好幾份新文檔、貼過幾份 PDF 給它做參考,下次它卻分不清哪份是真源——你已經遇上以下其中一個情況。
一個項目做幾天,中間試過 Codex、Claude Code、Gemini 不同工具。每次開新對話都要重新交代;到後來,連你自己都不肯定哪個版本是最新。
AI 過程中會建立新文檔,你也會引入 PDF、Notion 連結、研究筆記作參考。這些檔案當下 AI 都記得,但新 session 一開,它就分不清哪份是真源、哪份只是草稿,甚至不知道有這些檔案存在。
Codex 讀 AGENTS.md,Claude Code 讀 CLAUDE.md,Gemini CLI 讀 GEMINI.md。換一個工具就像換一種語言,規矩不互通。
AI 一旦放手做事,可能執行 rm -rf 或 git reset --hard 一類指令;你當下不在電腦前,根本察覺不到。
你不需要記住任何長指令,也不需要知道要更新哪份檔案。打一個自然短語,AI 會自己更新交接文件,並輸出一段下次貼回去就能接續的提示。
你不需要懂得任何規則包名稱,只要用日常話講你要做甚麼,AI 會宣告它正在用哪個工作模式、原因是甚麼。每個模式都是 AI 的守則,不是要你逐句閱讀的說明書。
AI 會先讀項目索引、找測試指令、看相關檔案,再動手;不會一上來就亂改。
AI 會分清來源、日期、事實、推論、未核實的內容,不把估算當作結論。
AI 會先看受眾、用途、語氣、格式,不會只做漂亮但不準確的文字。
AI 會先判斷外部文件是真源、索引、附件還是輸出地。如已連接 Notion 或 Google Drive 的對應接口,AI 直接讀寫對應資料來源;未連接則產生需要手動同步的內容。寫入之後必定回讀核對。
AI 會先講結論、再交代背景;標清未核實的內容;指令可直接複製使用。
所有危險指令(rm -rf、git reset --hard、強制推送)一律禁止;改動之前要列出目標、做好備份。
AI 會把「準備 release note」和「真正 publish / push / tag」分開處理,不會誤發佈。
AI 會先檢查既有規則能否擴充,以合併為先,不盲目新增,避免規則越疊越亂。
你只需要一部裝了 Node.js 的電腦,以及你慣用的 AI 工具(Codex、Claude Code、Gemini CLI 任何一個皆可)。
在你的項目資料夾打開 Terminal,執行:
npx @adamchanadam/agent-handoff-kit init
工具會在項目內建立 AGENTS.md、CLAUDE.md、GEMINI.md、dev/ 一系列固定文件。
打開你想用的 AI 工具,在新對話貼以下一段（第一次用,新手引導 trigger）:
Work in <你的資料夾>. I just installed agent-handoff-kit. Help me get started.
AI 會自動載入新手引導,帶你選擇使用情境,再一步一步陪你做第一個任務。
熟悉 Handoff Kit 之後,後續每次開新對話可改用更直接的開工句:Work in <資料夾>. Read AGENTS.md and follow it. Before changing anything, tell me the current state and your recommended next step.
工作完成想結束,只需打:
收工 或 wrap up 或 handoff
AI 會自動更新交接文件,輸出一段「下次開工用的提示」。複製、保存,下一輪開新對話時貼回去,接力即可完成。
講一句 help me start(或者「教我用」/「我是新手」),AI 會自動引導你選擇情景(寫代碼 / 寫報告 / 整理知識庫 / 學寫代碼 / 其他),一步一步帶你做第一個任務。本介紹頁不需要先讀完。
這套工具內置一個叫「安全」的工作模式。任何時候涉及刪檔、Git、雲端寫入、發佈,AI 都會強制加載這個模式,並遵守以下硬性禁區:
rm -rf / git reset --hard / 強制推送 / 系統根路徑操作,一律拒絕。高風險的工作,例如影響多檔、涉及外部系統、牽涉刪除或重命名,AI 必須先報告完整計劃,等你確認才動手,不會悄悄改動。
這套工具將項目資料分成 Hot / Warm / Cold 三層,讓 AI 知道何時讀甚麼。你不需要記這個分層 —— 下面只是讓你了解 AI 如何安排你的項目資料,以便日後你向 AI 提問「我們之前為何這樣做」時,知道 AI 會從何處找答案。
SESSION_HANDOFF:當前狀態、下一步、風險。
PROJECT_INDEX:檔案登記、真源。
AGENTS / CLAUDE / GEMINI.md:開工規則。
AI 開工第一輪會讀齊。你貼一段提示後,AI 的第一回應反映你現在做的事。
packs/*.md:工作模式守則。
PROJECT_DECISIONS:項目長期演進、決策、學習。
視乎你今日做的任務,AI 自己選擇載入哪個 pack,不需要你決定。長期項目的決策歷史亦放在這裡 —— 遇到「我們之前為何這樣做」的問題時,AI 會在這裡找答案。
SESSION_LOG 舊條目
SESSION_LOG_archive:自動冷封存。
平日不讀,做審計或追溯時才打開。AI 收工時自動將舊條目封存至此。
第一次用:"Work in <資料夾>. I just installed agent-handoff-kit. Help me get started." 之後對話可改用更直接的開工句。
AI 會自行宣告它載入了哪個工作模式、原因是甚麼;新手不用記任何規則包名稱。
AI 會輸出下次開工用的提示;複製、保存,下一輪貼回去就接得回。
這套工具負責對話之間接力,但 AI 在單一對話內的做事規矩(語氣、優先序、回覆骨架、安全護欄、輸出層分工)就不包含。配合 Adam-AI-Instructions 使用,兩個維度都覆蓋。
到 Adam-AI-Instructions 的「五、Prompt 索引」選擇適用版本,複製對應 prompt.md 全文貼入你 AI 工具設定(Claude Cowork Global Instructions、Claude Code ~/.claude/CLAUDE.md、ChatGPT Custom Instructions 等),再執行 npx @adamchanadam/agent-handoff-kit init。兩者不重疊,配合使用效果最好。