三個日常情景 —— 整理電腦下載目錄、開咖啡店市場調查、長期 AI 項目演進 —— 完整示範 Agent Handoff Kit 由安裝到接力的流程。每一步都會看到 AI 主動宣告載入哪個工作模式、怎樣計劃、怎樣驗收、何時同步下次接力提示。
你不需要先讀本指南。未安裝或不確定是否要升級時,在目標資料夾打開能讀寫本機資料夾的 AI agent,請它讀 agent-handoff-kit-ai-install.html 並在這個資料夾安裝或升級。安裝完成後,若 AI 已在正確專案內,輸入:
Start Agent Handoff
或:開工
若 AI 還未指向資料夾,才用帶路徑啟動句:Work in <你的資料夾>. Read AGENTS.md first, then Start Agent Handoff.
AI 會依 AGENTS.md 打開 START_NEXT_SESSION_PROMPT.txt。第一次安裝後,該檔案會開啟新手引導;收工後,該檔案會保存下一次接力狀態。收工可說 Wrap up Agent Handoff。若是「某某開工 / 某某收工」,AI 應先確認是否指本工具交接。
普通 web chat AI 若不能讀寫本機資料夾,並不適合使用本工具。本指南示範的是本機 agent 長任務流程。
⚙️ 以下三個情景假設你已在 AI 工具中連好相應外部工具(GitHub、Notion、Google Drive 等)。如未連好,AI 會在對應步驟暫停並提示你補設,或者改為產出需要你手動同步的內容。
長任務使用 MCP、browser、自動化工具、notebook 或 helper server 後,AI 應按 ownership 做資源收口:能證明屬於本任務的可關閉;不明、共享、使用者或其他 AI agent 可能擁有的資源,只可列證據並等你確認。
Agent Handoff Kit 的重點不只是保存上次做到哪裡。它也會讓 AI 在每次開工後，按任務選擇合適的工作規則。新手只需記住一句：你講目的，AI 負責選工作規則；高風險操作要先停下來問你。
不要一開始手改規則檔。直接用日常話告訴 AI：「把這條經驗接入 Agent Handoff Kit」、「把這份文件接入 Agent Handoff Kit」，或「把今次錯誤變成日後機制」。AI 應先判斷它應該放入交接狀態、項目索引、同步登記、長期決策，還是工作規則。
第一步可以交給能讀寫本機資料夾的 AI agent。你只需要在電腦開一個空資料夾(例如 ~/Downloads-tidy),在該資料夾打開 AI,請它讀安裝指令頁;AI 會先確認目前資料夾,再判斷要安裝、升級或停手。想手動處理時,才打開終端機執行下方指令。
AGENTS.md、CLAUDE.md、GEMINI.md,讓常見 AI 工具回到同一套規則。Antigravity CLI 會讀工作資料夾內的 AGENTS.md 與 GEMINI.md；因此 GEMINI.md 只做橋接,不另寫一套規則。init、upgrade 或 doctor。⚠️ 標明。新手最容易撞上的誤會,是把 Start Agent Handoff 或帶路徑啟動句當成要繼續在終端機輸入 —— 其實是要輸入到 AI 對話。把 docs/example.md 接入 Agent Handoff Kit,讓它檢查這份文件是否已接入索引、同步責任與相關流程。npx --yes @adamchanadam/agent-handoff-kit@latest doctor。如果只是 START_NEXT_SESSION_PROMPT.txt 暫時落後於交接文件,新版只會提醒;準備結束本輪工作時再同步即可。打開能讀寫本機專案資料夾的 AI agent,開一個新對話。若 AI 已在正確專案內,輸入 Start Agent Handoff 或「開工」。你不需要一開始就把需求寫得很完整;AI 會依 AGENTS.md 打開 START_NEXT_SESSION_PROMPT.txt,再用 5 步引導你把目標、資料夾、技術方向、風險與第一個小任務整理清楚。
Start Agent Handoff
AI 不會立即寫程式。它會先確認這是全新安裝,載入新手引導,再用 5 步把任務由模糊想法變成可執行的小範圍。這一步是新手體驗的核心:你不用懂項目結構,也不用先學規則名。
/\_/\ Agent Handoff Kit vX.Y.Z ( o.o ) continuity ready > ^ < 🔎 交接狀態:全新安裝 📌 目前目標:尚未設定 ⚠️ 注意事項:無 🚀 下一步:選擇你的使用情境,開始第一個任務
我看到這是第一次使用。請先選一個最接近的情境:
A. 建構系統 / 工具 / 平台 / 網站或應用
B. 整理研究資料 / 寫報告
C. 整理電腦檔案 / Notion / Google Drive 知識庫
D. 學寫代碼
E. 其他
F. 我已連接外部工具,想規劃如何有系統地使用
A
好,進入「建構系統 / 工具 / 平台 / 網站或應用」。我會先用 5 步把第一個任務定清楚,暫時不改檔:
請先回答三點:你想整理哪個資料夾?想做一次性清理還是可重用工具?正式移動檔案前是否必須先給你看預演清單?
我要整理 ~/Downloads。下載目錄堆了一兩年亂檔,過千份,想按類型分入文件、圖片、安裝包、壓縮包、其他,每類再按年份分一層。最好做成之後可重用的小工具。正式移動之前一定要先給我看預演清單。
明白。Handoff Kit 會把今天的目標、風險、檢查方式和下次接力提示寫入項目文件。今次第一個小任務建議收窄為:
先建立一個可重用的下載目錄整理工具,但只做到預演清單;不正式移動檔案。
原因:這個任務涉及大量檔案移動,先做預演最安全。你確認預演結果後,下一步才正式執行。
如果你同意這個第一步,我會載入正式工作模式:
寫代碼寫那個下載目錄整理小工具
安全因為要移動大量檔案,執行前要先預演列清單由你確認,絕對不會默默移動或者覆寫
我接著要做的工作流程:
計劃(列清楚分類邏輯、目錄結構、預演範圍)
→ 讀取(掃描下載目錄樣本)
→ 改動(寫 script + 預演模式)
→ 檢查(你確認預演清單)
→ 正式執行(按你確認的清單移動檔案)
是否以這個小任務開始?
你接受 AI 建議的第一個小任務後,才進入正式工作。這裡的「確認」不是跳過新手引導,而是承接上一段 5 步引導的結果:先做一個可預演、可驗收、暫不正式移動檔案的版本。
同意。先做可重用工具和預演清單,不要正式移動檔案。
分類邏輯(5 類):
子目錄結構:每類裡面再按檔案最後修改年份分,例如 documents/2025/、documents/2024/。
檔名規則:保留原檔名;如有重名加數字尾碼(_1、_2)。
預演範圍:掃描整個 ~/Downloads 目錄;不會跟蹤捷徑、不會處理隱藏檔。
我現在進入讀取階段掃描你的目錄,然後寫 script 並執行一次預演讓你看清單。這個計劃可以嗎?
可以,繼續。
掃描 ~/Downloads,共找到 1,043 個檔案。樣本(隨機 5 個):
~/Downloads/IMG_2837.HEIC (2025-04, image) ~/Downloads/銀行月結單_2024-11.pdf (2024-11, document) ~/Downloads/Notion-2.0.41.dmg (2024-08, installer) ~/Downloads/設計稿備份.zip (2025-01, archive) ~/Downloads/Screenshot 2025-03-15.png (2025-03, image)
已寫好 script 到 ~/Downloads-tidy/sort_downloads.py,加入 --dry-run 選項。即將執行預演,只會印出「哪個檔案會去哪裡」的清單,完全不會移動任何東西。
準備好執行預演嗎?
安全模式在第三步已經自動加載。核心要求:不可逆動作(檔案移動、刪除、覆寫、Git 重置、發佈)必須先講計劃,而涉及移動大量檔案時要用預演列清單,得到用戶明確確認才正式執行。AI 不可以「悄悄做」。
好,執行預演。
$ python sort_downloads.py --dry-run ==== Dry-run summary ==== Total scanned: 1,043 files Plan summary: documents/2025/ 234 files documents/2024/ 178 files documents/2023/ 62 files images/2025/ 198 files images/2024/ 134 files installers/2025/ 48 files installers/2024/ 39 files archives/2025/ 26 files archives/2024/ 21 files others/ 103 files ⚠️ 5 個檔案有重名,會加 _1 / _2 尾碼。 ⚠️ 0 個檔案跨磁碟分區(全部仍在同一個磁碟)。 預演完成,完全沒有移動任何檔案。 看完清單覺得可以,輸入 yes 才正式執行;不可以我可以調整分類規則。
清單列完。這個分配你接受嗎?如果有檔案你想保留在 ~/Downloads 不搬,可以講 —— 例如想保留最近 7 日內的檔案,我可以加篩選條件。
清單可以,我接受,正式執行。
$ python sort_downloads.py Moving 1,043 files... [████████████████████████████████] 100% (1043/1043) ==== Done ==== Moved: 1,043 files Renamed (dup): 5 files Failed: 0 files 新目錄結構在 ~/Downloads 裡面,可以打開檔案總管查看。
已經完成。下載目錄現在分為 5 個主類加年份子目錄,找東西應該快很多。
rm -rf、git reset --hard、強制推送、系統根路徑操作 —— 這個情景未撞到,但同一套規則一直在守護。有些文件不是普通草稿,而是未來 AI 必須知道的工作依據:stock list、production guide、runbook、workflow、checklist、source-of-truth。這類文件完成後,除了保存內容本身,還要讓下一個 AI 知道它的用途、何時要讀、何時要更新,以及是否有同用途舊文件。常見有兩種用法:指定一份文件接入 Agent Handoff Kit,或先掃描 repo 找出疑似未接入的重要文件。
docs/production-guide.md,把這份文件接入 Agent Handoff Kit。
我會做文件接入審核,先只讀檢查:
dev/PROJECT_INDEX.md 是否登記它及何時要讀dev/DOC_SYNC_REGISTRY.md 是否有同類變更的同步規則我會輸出「已接合、缺口、建議補丁、需要你判斷的項目」。如果你不指定文件而要求掃描 repo,我只會先列出候選與缺口,不會一邊掃描一邊自動修正。我不會自動刪除、改名或合併文件。
指定文件時可說 把 docs/production-guide.md 接入 Agent Handoff Kit,也可用舊說法 治理打通 docs/production-guide.md。不確定有哪些文件漏接時,可說 掃描未接入 Agent Handoff Kit 的重要文件 或 scan for unbridged governance documents。掃描結果只是候選清單;你確認後,AI 才按建議補丁更新索引、同步登記或相關流程。
準備結束本輪工作時,你不需要記住要更新哪份檔案。輸入一句「收工」、「Wrap up Agent Handoff」、「wrap up」或者「handoff」,AI 偵測到收工意圖,即進入完整收工流程:更新交接文件、寫今次紀錄入工作日誌,並把下一次接力內容同步寫入 START_NEXT_SESSION_PROMPT.txt 副本。
收工。
/\_/\ Agent Handoff Kit vX.Y.Z ( -.- ) handoff saved > ^ < ✅ 完成:下載目錄整理小工具完成,1043 個檔案已分入 5 類乘以年份子目錄 🔎 檢查:預演 + 正式執行 + 0 失敗 📌 交接:下次開工提示已備好 ⚠️ 邊界:尚未做發佈(寫 README + 建版本標籤 + 推上 GitHub)
我已經:
sort_downloads.py 已完成 + 已正式執行」,下一步列出「加 README + 建版本標籤 + 推上 GitHub」。sort_downloads.py 的角色描述。下次開工在同一專案內說 Start Agent Handoff 或「開工」即可；真正接力內容已同步寫入 START_NEXT_SESSION_PROMPT.txt。
若下一個 AI 尚未指向資料夾,才用帶路徑啟動句:
Work in ~/Downloads-tidy. Read AGENTS.md first, then Start Agent Handoff. Before changing anything, tell me the current state and your recommended next step.
START_NEXT_SESSION_PROMPT.txt 副本。下次新對話只需啟動接力,不用手動複製整份提示檔。交接文件仍是權威來源,副本只是方便。過了一天。你想做發佈 —— 加 README、建版本標籤、推上 GitHub。打開新 AI 對話(可能仍是 Claude,或者今次轉用 Codex / Antigravity),輸入 Start Agent Handoff 或「開工」。新 AI 啟動,讀入口文件與 START_NEXT_SESSION_PROMPT.txt,接得回上一棒 —— 不需要你重新交代任何背景。本案例假設你已在 AI 工具中連好 GitHub 接口,AI 可以直接代你建立 repo、推送代碼、建立 release。
Start Agent Handoff
/\_/\ Agent Handoff Kit vX.Y.Z ( o.o ) continuity ready > ^ < 🔎 Handoff: loaded 📌 目前狀態:sort_downloads.py 已完成 + 已正式執行 (1043 個檔案已移動) ✅ 已驗證:你的 AI 工具已連好 GitHub 接口,可代你建 repo + 推送 ⚠️ 邊界:建立版本標籤、推送、建立 release 屬不可逆動作,每一步都要你明確批准 🚀 下一步:載入發佈 + 安全模式,進入計劃
讀齊交接文件上次紀錄。今次目標是發佈:加 README、建版本標籤 v0.1.0、推上 GitHub。我載入以下兩個工作模式:
發佈真正建立版本標籤或推送之前必須明確批准,不會自動執行
安全涉及 Git 遠端寫入,持續守護
計劃:
README.md —— 簡介、安裝、用法、選項、限制。git init + git add + git commit 第一個提交。git tag v0.1.0。downloads-tidy(公開或私有由你決定),然後推送代碼與標籤,並建立 release。這個計劃可以嗎?新 repo 要公開還是私有?
計劃可以。公開 repo,名用 downloads-tidy。
README 已寫好(三段:用途、安裝、用法選項)。Git 初始化、第一個提交、建版本標籤 v0.1.0 全部執行完。
$ git log --oneline 8e3a2f1 (HEAD -> main, tag: v0.1.0) Initial release: sort_downloads.py
接下來我會代你建 GitHub repo + 推送 + 建 release。這幾步屬不可逆動作,我會逐步報告每一個結果,有任何不符預期立即停。確認執行嗎?
好,執行。
downloads-tidy(公開,描述「下載目錄整理小工具」)git remote add origin https://github.com/yourname/downloads-tidy.gitgit push -u origin maingit push origin v0.1.0發佈完成。Repo URL:https://github.com/yourname/downloads-tidy。Release URL:https://github.com/yourname/downloads-tidy/releases/tag/v0.1.0。朋友只要下載或複製下來,立即可以使用。
準備結束本輪工作時講「收工」,我會將今次的提交紀錄、版本標籤、倉庫連結、發佈連結寫入交接文件與工作日誌,再同步下次接力提示。
dev/ 任何治理檔。與 Case A 不同,這個研究任務涉及多個來源,所以在安裝之前要先想清楚分工 —— 哪一樣放在哪裡。三件工具各做一件事:Notion 做索引、本機放原文內容、Google Drive 留給最終成品給合伙人分享。本案例假設你已在 AI 工具中連好 Notion 與 Google Drive 接口,AI 可以直接代你讀寫 Notion 資料庫、上傳檔案到 Google Drive、設定分享權限。
準備好 Notion 資料庫與本機資料夾結構之後,在 ~/cafe-research/ 打開能讀寫本機資料夾的 AI agent,請它讀安裝指令頁並在這個資料夾安裝或升級;想手動處理時,才打開終端機執行同一句安裝指令。
如果這是第一次使用,在已打開專案資料夾的 AI agent 輸入 Start Agent Handoff 或「開工」。AI 會打開 START_NEXT_SESSION_PROMPT.txt,再問你想做哪一類任務;你選「整理研究資料 / 寫報告」後,再把 Notion、本機 reference、Google Drive 的分工講清楚。這樣不需要一開始硬背資料結構,也更不容易漏資料來源。
Start Agent Handoff
我看到這是第一次使用。請先選一個最接近的情境。這個任務應選「整理研究資料 / 寫報告」。
B
請告訴我三點:(1) 報告主題;(2) 已有資料在哪裡;(3) 報告讀者是誰。順便說明你是否已連接 Notion 或 Google Drive;如果已連接,我可以直接讀寫,否則會列手動同步步驟。
我想研究自己社區是否可以開一間咖啡店,要寫一份十頁市場調查報告,結論回答「是否值得做加下一步行動建議」,給自己與太太看,亦想拿去與業界朋友傾談。
資料分工:Notion 有一個索引資料庫,登記了 30 條以上參考資料(政府統計、行業報告、競品 menu 截圖、訪談筆記),每行有「本機路徑」指向 ~/cafe-research/reference/ 裡面對應檔案。本機 reference/ 已經放好對應 PDF、截圖、筆記。報告草稿請寫入 ~/cafe-research/report/。完成後請幫我上傳 Google Drive、設定分享權限給合伙人、太太、業界朋友張先生(我之後可以給你他們的電郵地址),並保存分享連結。Notion 與 Google Drive 接口我已連好,你可以直接讀寫。
啟動卡與 Case A 一樣 —— 版本字、Handoff loaded 標記。但今次工作模式組合不同:研究類任務自動載入研究模式(來源紀律、事實與推論分清楚)與知識整理模式(真源唯一、外部寫後回讀)。AI 同時確認:你已連好 Notion 與 Google Drive 接口,可以直接讀寫對應資料。
/\_/\ Agent Handoff Kit vX.Y.Z ( o.o ) continuity ready > ^ < 🔎 Handoff: loaded 📌 目前狀態:新項目,交接文件仍未有上一輪紀錄 ✅ 已驗證:你的 AI 工具已連好 Notion 與 Google Drive 接口,我可以直接讀寫 🚀 下一步:載入工作模式 + 進入計劃,先對齊 Notion 索引與本機 reference
讀齊入口文件、交接文件(空)、項目索引(模板)、工作規則路由表。根據任務,載入以下工作模式:
研究研究類任務:來源、日期分清楚,事實與推論分開寫
知識整理外部來源:可讀取的不等於已讀入。未讀的來源要標待處理,不可以當沒有資料
我接著要做的工作流程(因為涉及多個來源,讀取階段會比 Case A 重):
計劃(列清楚要對齊哪些來源、哪一段要寫)
→ 讀取(逐條讀 Notion 索引對應本機 reference,識別空白)
→ 改動(寫報告草稿入 report/)
→ 檢查(每段論述有沒有引用、有沒有主觀推論未標)
→ 輸出報告與檢查結果
我會先進入計劃階段,做兩件事:
你確認進入計劃嗎?
因為你已連好 Notion 接口,AI 直接讀你的 Notion 資料庫,逐行對齊本機 reference/ 裡面對應檔案,發現空白即報告 —— 不會悄悄當沒事。如未連好接口,AI 會先列出缺口由你決定下一步(連接接口、用匯出檔案 fallback、或者暫停)。
好,進入計劃。
直接讀你的 Notion 資料庫「Cafe Research Index」,共 32 條紀錄。對齊本機 reference/ 裡面檔案:
== 對齊結果 == ✅ Notion 與本機都有, path 對: 24 條 ⚠️ Notion 有登記, 本機沒有對應檔案: 5 條 ⚠️ 本機有檔案, Notion 沒有登記: 3 條 ❌ Notion 有 path 但本機檔案打不開: 0 條
5 條 Notion 有登記但本機沒有檔案的:
reference/行業協會-2023-H1.pdf,本機不存在reference/訪談-陳生.md,本機不存在有三個處理方法,選一個:
reference/,然後我才開始。還有,本機有但 Notion 未登記的 3 個:
reference/競品-D 咖啡店-2025-05.pngreference/筆記-選址初探-2025-03.mdreference/政府數據-社區人口-2024.xlsx我建議將這 3 條補登記入 Notion。因為你已連好 Notion 接口,我可以直接寫入,寫入後立即回讀每行確認資料正確。
選 1(標為待處理)。本機未登記那 3 條,你直接幫我寫入 Notion。
好,完成以下幾件事:
準備好可以進入改動階段寫報告。十頁報告章節結構建議如下,你確認才開始寫:
章節結構確認之後,AI 進入改動階段寫報告草稿。涉及實際寫長文,自動加載寫作模式(受眾、用途、語氣紀律)。每段論述都追溯回用了哪條 reference,事實與推論明顯分開。寫完之後輸出你要的格式;由於你已連好 Google Drive 接口,AI 代你上傳檔案、設定分享權限、回讀核對,並保存分享連結。如未連接,AI 改為列詳細上傳步驟由你親手做。若你使用的 AI 工具不能直接輸出 docx,AI 會先寫成 Markdown 或 Google Docs 可用內容,再按該工具能力轉換。
章節結構可以,開始寫。合伙人電郵 partner@example.com,太太 wife@example.com,業界朋友張先生 cheung@example.com。
自動加載:
寫作受眾、用途、語氣 —— 今次讀者是你 + 太太 + 業界朋友,所以語氣是「個人計劃書」而非「投資者簡報」
開始寫 report/report-draft.md。每段尾我會用註腳形式註明引用的 Notion 紀錄與本機檔案路徑,方便你回查。十頁草稿寫完會交給你看。
草稿完成,共 10.3 頁(2,847 字加 4 個表)。位置:report/report-draft.md。重點摘要:
要輸出什麼格式?常見選擇:
.docx —— Microsoft Word / Google Docs 通用.pdf —— 印出來或者直接分享連結.html —— 在瀏覽器看要 docx。Google Drive 你直接幫我上傳,分享給合伙人、太太、業界朋友張先生。
已輸出 report/report-final.docx。
用 Google Drive 接口代你上傳:
~/cafe-research/report/report-final.docx 上傳至 Google Drive 的「Cafe Research」資料夾https://drive.google.com/file/d/.../view 已保存💡 機密分離:Google Drive 的存取憑證由 AI 工具的安全儲存管理,完全不會寫入 dev/ 任何治理檔。治理檔只記下分享連結這個公開座標。
準備結束本輪工作時講「收工」,我會將今次寫的東西、5 條暫缺、報告位置、分享連結寫入交接文件,並輸出下次接力提示。
收工指令與 Case A 一樣 —— 一句「收工」或者「wrap up」。AI 進入完整收工流程。今次因為 Google Drive 接口已連好,分享連結已在前一步由 AI 上傳後回讀核對,收工階段所有外部來源狀態都實際對齊(沒有「待填」缺口)。
收工。
/\_/\ Agent Handoff Kit vX.Y.Z ( -.- ) handoff saved > ^ < ✅ 完成:市場調查報告草稿完成 (10.3 頁), 輸出做 docx, Google Drive 上傳 + 分享完成 🔎 檢查:24 條引用追溯, 5 條暫缺已標待處理, Notion 3 行寫入回讀正確, Google Drive 分享連結回讀正確 📌 交接:下次開工提示已備好 ⚠️ 邊界:5 條 reference 仍待處理, 影響 2 個子章節
已對賬式更新:
report/report-final.docx);Google Drive 分享連結 https://drive.google.com/file/d/.../view 已分享給合伙人、太太、業界朋友張先生;下一步:等合伙人意見後修訂。下次開工在同一專案內說 Start Agent Handoff 或「開工」即可；真正接力內容已同步寫入 START_NEXT_SESSION_PROMPT.txt。
若下一個 AI 尚未指向資料夾,才用帶路徑啟動句:
Work in ~/cafe-research. Read AGENTS.md first, then Start Agent Handoff. Before changing anything, tell me the current state and your recommended next step.
過了幾天,你將報告分享連結傳給了合伙人。對方覺得「6 個月試水溫」的起步資本支出估算還是太高,想看有沒有 3 個月的更輕版本。你打開新對話,輸入 Start Agent Handoff 或「開工」,再加一句新要求。新 AI 啟動,接得回上次狀態,重新進入研究與寫作模式改報告。
Start Agent Handoff 再做一個 3 個月「快閃 + 共享廚房」的更輕版本。
/\_/\ Agent Handoff Kit vX.Y.Z ( o.o ) continuity ready > ^ < 🔎 Handoff: loaded 📌 目前狀態:10.3 頁報告最終版已交合伙人, 分享連結已填 🎯 新要求:加 3 個月快閃 + 共享廚房替代方案 ⚠️ 邊界:5 條 reference 仍待處理, 影響 2 個子章節 —— 與我寫新替代方案暫無直接衝突 🚀 下一步:重新載入研究與寫作模式, 進入計劃
讀齊上次交接文件、工作日誌最新條目、項目索引。已掌握:
重新載入工作模式(同上次):
研究 知識整理 寫作
計劃:
reference/ 選出 3 至 4 條與「快閃店 / 共享廚房」相關的 reference(我會用 Notion 索引裡面的標籤找)。這個計劃可以嗎?
可以,做。
完成。新子章節加在結論章節,共 1.4 頁。輸出 report/report-v2.docx。我可以代你上傳 Google Drive 取代原本檔案,或者建一個新版本檔案 —— 你想要哪一種?
差異摘要(與第一版比):
準備好可以「收工」,我會更新交接文件反映第二版出了,並列回:5 條待處理 reference 仍未補。
Case A 與 Case B 展示單一對話內的七步流程。Case C 則展示跨越多輪對話、多個月份的長期項目演進。重點不在每日的具體動作,而在 AI 如何自動維護項目的長期紀錄 —— 任務需求的演進、決策的累積、架構選擇的歷史、累積式的學習觀察。
這不是一次指令即完成的展示。它需要你在多輪對話中每次準備結束本輪工作時照常「收工」,讓 AI 持續寫入交接文件與長期紀錄。你的角色仍然是:提需求、提供參考資料、做驗收。AI 的角色是:讀齊長期紀錄與當前狀態,自動補入長期演進,不需要你打開檔案,亦不需要你記住分檔結構。
你先按前面流程安裝,再開新 AI 對話輸入 Start Agent Handoff 或「開工」。AI 打開 START_NEXT_SESSION_PROMPT.txt 並完成新手引導後,你描述第一個任務:「我想開發一個 AI 編輯助手」。AI 讀齊入口文件後,將任務描述記入交接文件當前目標。項目決策日誌暫時保持空白 —— 因為短期單一任務的信號為主(對話次數 1,沒有任務演進跡象),AI 暫不主動維護。
Start Agent Handoff
AI 問情境時,我選「建構系統 / 工具 / 平台 / 網站或應用」。完成背景確認後,我補充:
我想開發一個 AI 編輯助手 —— 主要功能是文字校對與風格建議。先做最簡單的可用版本,只支援 markdown,輸入文字輸出修改建議。
讀齊入口文件、交接文件(空)、項目索引(模板)、工作規則路由表。載入寫代碼模式 + 研究模式(因為要先了解現有 AI 編輯工具的特性)。
記入交接文件當前目標:「AI 編輯助手可用版本 —— markdown 文字校對與風格建議」。準備進入計劃階段。
項目決策日誌保持空白 —— 短期單一任務的預設狀態。
過了一個月,經過 5 至 6 輪對話,你的需求慢慢演進:由「markdown 校對」變成「markdown + LaTeX + 程式碼註釋校對」,再加入「協同編輯模式」。同一期間,團隊新加了一個 Slack 頻道作為內部意見渠道、用 Linear 跟進待辦清單 —— 你在第 4 輪對話時告訴 AI 連好了 Slack 與 Linear 接口,AI 在項目索引登記了這兩個工具。當前目標的描述已經與 Day 1 有實質差異。AI 偵測到任務有實質演進,自動將紀錄補入長期演進段,同時反映 AI 工具登記表新增了兩項。
收工。
進行收工流程,逐段對賬交接文件。發現:
偵測到任務需求實質演進,自動補入項目決策日誌的長期演進段:
### 2026-XX-XX:需求由 markdown 可用版本演進為多語法 + 協同編輯 原 Day 1 當前目標:「markdown 可用版本校對與風格建議」 經 6 輪對話演進:加入 LaTeX 支援(第 2 輪)、程式碼註釋校對(第 4 輪)、協同編輯模式(第 6 輪)。 驅動原因:你試用過程發現純 markdown 範圍對技術寫作不足夠。 影響:後端模型如何處理多語法上下文需要重新評估。
已將以上紀錄補入項目決策日誌。下次有人問「這個項目最初做甚麼」時,我會在這裡找到答案,而不是只看當前狀態的最新版本。
再過一個月,對話次數累積至 15,交接文件的「確認決策」段累積至 32 條。AI 自動偵測到累積邊界,觸發自動歸檔:最舊的條目搬入項目決策日誌的決策封存段,保留最近的 12 條在交接文件作日常使用。
收工。
進行收工流程。偵測到:
執行歸檔:
保留在交接文件(最近 12 條):#21 至 #32 搬入項目決策日誌封存(最舊 20 條):#1 至 #20 排序:最新在頂(#20 在最頂,#1 在最底)
交接文件從 32 條確認決策收斂為 12 條當前活躍決策,清楚反映項目目前的判斷邊界。封存段完整保留所有歷史條目,日後追溯用。
同時觀察到:本輪計劃涉及多選項架構取捨(三個後端方案之間作出選擇,並記錄原因)。自動補入架構取捨段:
### 2026-XX-XX:後端處理由方案 A 切換至方案 B 比較選項:(1) 方案 A:低成本但上下文較短 / (2) 方案 B:上下文較長但成本較高 / (3) 方案 C:速度較快但格式控制較弱 選擇:方案 B 原因:程式碼註釋校對需要保留較長上下文;方案 B 在本項目的測試樣本中較穩定。 影響:後端 API 呼叫需要重寫;提示模板需要重新調整。
再過一個月,項目已試用。某日合作伙伴問你:「為何當時選方案 B,而不是成本較低的方案 A?」你不記得具體原因細節 —— 但你知道 AI 有紀錄。打開新對話,問 AI。AI 讀交接文件加項目索引後,主動查項目決策日誌。
我們之前為何選擇方案 B,而不是成本較低的方案 A 做後端處理?合作伙伴現在問我。
交接文件當前目標提及後端使用方案 B,但原因細節不在當前狀態。讀項目決策日誌的架構取捨段:
### 2026-XX-XX:後端處理由方案 A 切換至方案 B 比較選項:(1) 方案 A:低成本但上下文較短 / (2) 方案 B:上下文較長但成本較高 / (3) 方案 C:速度較快但格式控制較弱 選擇:方案 B 原因:程式碼註釋校對需要保留較長上下文;方案 B 在本項目的測試樣本中較穩定。 影響:後端 API 呼叫需要重寫;提示模板需要重新調整。
原原因兩點:(1) 任務需要保留較長上下文;(2) 方案 B 在本項目的測試樣本中較穩定。當時切換時 Day 60 工作日誌有完整紀錄,如需細節追溯我可以查封存。
你可以直接將此原因答給合作伙伴。
由 AI 讀安裝指令頁判斷安裝或升級,或手動用終端機安裝 —— 開新 AI 對話啟動接力 —— AI 自己讀齊交接文件、說明準備怎樣做 —— 計劃階段停手等你確認 —— 涉及安全、知識整理、寫作時自動加上相應規則 —— 準備結束本輪工作時一句「收工」自動寫好下次提示 —— 新對話說「開工」就接得回。Case A 與 Case B 各七步,Case C 則跨越多月演進,但骨幹節奏跨案例、跨工具、跨日子都是同一套。
你之後做第三個、第四個任務 —— 寫電子報、做股市觀察、整理多個項目的發票 —— 流程仍然是這套。工作模式會根據任務性質自動切換,但你的習慣動作(開工、講任務、確認計劃;準備結束本輪工作時收工)始終一樣。
另外建議:你希望 AI 在單一對話內的做事規矩(語氣、優先序、回覆骨架、安全護欄、輸出層分工)有持久基準,可以配合 Adam-AI-Instructions 使用 —— 到該倉庫的「五、提示詞索引」選擇適用版本,複製對應 prompt.md 全文貼入你 AI 工具設定。Agent Handoff Kit 管「對話之間」的接力,Adam-AI-Instructions 管「單次對話質素」,兩者不重疊。