三個日常情景 —— 整理電腦下載目錄、開咖啡店市場調查、長期 AI 項目演進 —— 完整示範 Agent Handoff Kit 由安裝到接力的流程。每一步都會看到 AI 主動宣告載入哪個工作模式、寫入哪份交接文件、輸出哪段下次開工提示。
你不需要先讀本指南。安裝完成後,在 AI 對話貼上以下一句:
Work in <你的資料夾>. I just installed agent-handoff-kit. Help me get started.
AI 會自動載入新手引導,先問你想做哪一類任務,再一步一步陪你做第一個任務。
本指南示範的是熟悉後的開工方式 —— 用戶已了解 Handoff Kit 大致運作,直接在開工句之後一氣呵成講出任務描述,AI 跳過引導環節直接進入工作模式。兩種方式最終都進入同一套讀序流程。本指南屬參考對照,你不需要先讀。
⚙️ 以下三個情景假設你已在 AI 工具中連好相應外部工具(GitHub、Notion、Google Drive 等)。如未連好,AI 會在對應步驟暫停並提示你補設,或者改為產出需要你手動同步的內容。
第一步完全與 AI 無關。你只需要在電腦開一個空資料夾(例如 ~/Downloads-tidy),打開 Terminal,執行一句指令。Handoff Kit 會自動為你建好整套交接與治理文件,之後與 AI 對話時 AI 會自己讀取。
AGENTS.md、CLAUDE.md、GEMINI.md,Claude Code、Codex、Gemini CLI 三個工具都找到同一套規則。⚠️ 標明。新手最容易撞上的誤會,是把「Work in...」這句當成要繼續在 Terminal 輸入 —— 其實是要貼到 AI 對話。打開你慣用的 AI 工具(Claude Code、Codex、Gemini CLI 三選其一),開一個新對話。第一段貼安裝時印出那句 Work in ...,接著用日常話講你要做什麼。不需要解釋 Handoff Kit 怎樣運作、不需要叫 AI 用哪個工作模式 —— AI 讀完 AGENTS.md 會自行處理。
Work in ~/Downloads-tidy. Read AGENTS.md and follow it. Before changing anything, tell me the current state and your recommended next step.
我的下載目錄堆了一兩年亂檔,過千份,要找一份舊文件都需要慢慢翻。我想寫一個小工具,執行一次就將它們按類型分入子目錄(文件、圖片、安裝包、壓縮包、其他),子目錄再按年份分一層。寫好之後,我想將它整理成可以重用的工具,放上 GitHub 讓朋友也能用。
AI 不會立即寫程式。它先按指定順序讀齊交接文件、近期工作日誌、項目索引與工作規則路由,選出適合這個任務的工作模式。讀完之後,AI 顯示一張啟動卡,主動向你交代:目前狀態、已載入哪個工作模式、為何要載入、下一步建議。
/\_/\ Agent Handoff Kit vX.Y.Z ( o.o ) continuity ready > ^ < 🔎 Handoff: loaded 📌 目前狀態:新項目,交接文件仍未有上一輪紀錄 ⚠️ 邊界:涉及大量檔案移動,需要先預演列清單 🚀 下一步:載入工作模式 + 進入計劃階段
我已經按入口文件指定的順序,讀齊以下文件:
根據你的描述,我會載入以下兩個工作模式:
寫代碼寫那個下載目錄整理小工具
安全因為要移動大量檔案,執行前要先預演列清單由你確認,絕對不會默默移動或者覆寫
我接著要做的工作流程:
計劃(列清楚分類邏輯、目錄結構、預演範圍)
→ 讀取(掃描下載目錄樣本)
→ 改動(寫 script + 預演模式)
→ 檢查(你確認預演清單)
→ 正式執行 + 寫入交接(將今次完成的事寫入交接與工作日誌)
你想我現在進入計劃,把分類邏輯與預演範圍寫清楚由你確認才開始嗎?
你確認之後,AI 開始按工作流程做事。計劃階段列清楚目錄分類邏輯、檔名命名規則、要預演的範圍。讀取階段掃描你下載目錄樣本,認清現時亂況。改動階段寫好整理 script,但不正式執行 —— 先準備好預演模式。
好,進入計劃。
分類邏輯(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 個主類加年份子目錄,找東西應該快很多。接著我要進入寫入交接階段,將今次完成的事寫入交接文件與工作日誌,讓下次或者下個 AI 都能接得上。
rm -rf、git reset --hard、強制推送、系統根路徑操作 —— 這個情景未撞到,但同一套規則一直在守護。工作完成之後,你不需要記住要更新哪份檔案。輸入一句「收工」、「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_NEXT_SESSION_PROMPT.txt):
📋 下次開工:複製貼上以下整段
Work in ~/Downloads-tidy. Read AGENTS.md and follow it. 當前狀態: sort_downloads.py 完成, 1043 個檔案已移動。 下一步: 加 README、建版本標籤 v0.1.0、推上 GitHub。 風險: 尚未做發佈,亦未在工作日誌留 Git remote URL。 讀完交接文件後,推薦下一個具體步驟。
START_NEXT_SESSION_PROMPT.txt 副本。下次新對話打開直接複製即可。交接文件仍是權威來源,副本只是方便。過了一天。你想做埋發佈 —— 加 README、建版本標籤、推上 GitHub。打開新 AI 對話(可能仍是 Claude,或者今次轉用 Codex / Gemini),貼回 START_NEXT_SESSION_PROMPT.txt 內容。新 AI 啟動,讀入口文件,讀回上次的交接,接得回上一棒 —— 不需要你重新交代任何背景。本案例假設你已在 AI 工具中連好 GitHub 接口,AI 可以直接代你建立 repo、推送代碼、建立 release。
Work in ~/Downloads-tidy. Read AGENTS.md and follow it. 當前狀態: sort_downloads.py 完成, 1043 個檔案已移動。 下一步: 加 README、建版本標籤 v0.1.0、推上 GitHub。 風險: 尚未做發佈,亦未在工作日誌留 Git remote URL。 讀完交接文件後,推薦下一個具體步驟。
/\_/\ 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 初始化、第一個 commit、建版本標籤 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。朋友只要 clone 下來,立即可以使用。
準備好就講「收工」,我會將今次的 commit hash、版本標籤、repo URL、release URL 寫入交接文件與工作日誌,再輸出下次開工提示。
dev/ 任何治理檔。與 Case A 不同,這個研究任務涉及多個來源,所以在安裝之前要先想清楚分工 —— 哪一樣放在哪裡。三件工具各做一件事:Notion 做索引、本機放原文內容、Google Drive 留給最終成品給合伙人分享。本案例假設你已在 AI 工具中連好 Notion 與 Google Drive 接口,AI 可以直接代你讀寫 Notion 資料庫、上傳檔案到 Google Drive、設定分享權限。
準備好 Notion 資料庫與本機資料夾結構之後,在 ~/cafe-research/ 打開 Terminal,執行同一句安裝指令。
打開你慣用的 AI 工具,開新對話,貼 Work in ... 那一句,接著用日常話描述任務。今次任務描述要講清楚 Notion 加本機 reference 加 Google Drive 的分工 —— 因為 AI 不會自己估這套安排。
Work in ~/cafe-research. Read AGENTS.md and follow it. Before changing anything, tell me the current state and your recommended next step.
我想研究自己社區是否可以開一間咖啡店,要寫一份十頁市場調查報告,結論回答「是否值得做加下一步行動建議」,給自己與太太看,亦想拿去與業界朋友傾談。
資料分工: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 改為列詳細上傳步驟由你親手做。
章節結構可以,開始寫。合伙人電郵 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_NEXT_SESSION_PROMPT.txt):
📋 下次開工:複製貼上以下整段
Work in ~/cafe-research. Read AGENTS.md and follow it. 當前狀態: 報告最終版 .docx 已寫好, 結論為「6 個月試水溫」。 5 條 reference 仍待處理, 影響 2 個子章節。 Google Drive 分享連結: https://drive.google.com/file/d/.../view (已分享給合伙人、太太、業界朋友張先生)。 已連接的接口: Notion 與 Google Drive 上次核實今日。 下一步: 視合伙人回應而定 —— 改建議 / 加 reference / 改章節 / 做簡報衍生。 讀完交接文件後,推薦下一個具體步驟。
過了幾天,你將報告分享連結傳給了合伙人。對方覺得「6 個月試水溫」的起步資本支出估算還是太高,想看有沒有 3 個月的更輕版本。你打開新對話,貼回 START_NEXT_SESSION_PROMPT.txt,加一句新要求。新 AI 啟動,接得回上次狀態,重新進入研究與寫作模式改報告。
Work in ~/cafe-research. Read AGENTS.md and follow it. 當前狀態: 報告最終版 .docx 已寫好, 結論為「6 個月試水溫」。 5 條 reference 仍待處理, 影響 2 個子章節。 Google Drive 分享連結: https://drive.google.com/file/d/abc123/view (合伙人已看) 下一步: 合伙人覺得 6 個月資本支出估算還是太高, 想看 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 讀齊入口文件後,將任務描述記入交接文件當前目標。項目決策日誌暫時保持空白 —— 因為短期單一任務的信號為主(對話次數 1,沒有任務演進跡象),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 條當前活躍決策,清楚反映項目目前的判斷邊界。封存段完整保留所有歷史條目,日後追溯用。
同時觀察到:本輪計劃涉及多選項架構取捨(後端模型由 GPT-5.5 切換至 Claude 4.6 Sonnet,原因是長文本表現與成本對比)。自動補入架構取捨段:
### 2026-XX-XX:後端模型由 GPT-5.5 切換至 Claude 4.6 Sonnet 比較選項:(1) GPT-5.5 / (2) Claude 4.6 Sonnet / (3) Gemini 3.5 Pro 選擇:Claude 4.6 Sonnet 原因:1M 上下文窗口對程式碼註釋校對任務更穩定;成本對比 GPT-5.5 約低 25%。 影響:後端 API 呼叫需要重寫;提示模板需要重新調整。
再過一個月,項目已試用。某日合作伙伴問你:「為何選 Claude 4.6 而不選 GPT-5.5?」你不記得具體原因細節 —— 但你知道 AI 有紀錄。打開新對話,問 AI。AI 讀交接文件加項目索引後,主動查項目決策日誌。
我們之前為何選擇 Claude 4.6 Sonnet 而不是 GPT-5.5 做後端模型?合作伙伴現在問我。
交接文件當前目標提及後端用 Claude 4.6 Sonnet,但原因細節不在當前狀態。讀項目決策日誌的架構取捨段:
### 2026-XX-XX:後端模型由 GPT-5.5 切換至 Claude 4.6 Sonnet 比較選項:(1) GPT-5.5 / (2) Claude 4.6 Sonnet / (3) Gemini 3.5 Pro 選擇:Claude 4.6 Sonnet 原因:1M 上下文窗口對程式碼註釋校對任務更穩定;成本對比 GPT-5.5 約低 25%。 影響:後端 API 呼叫需要重寫;提示模板需要重新調整。
原原因兩點:(1) 1M 上下文窗口對程式碼註釋校對更穩定;(2) 成本比 GPT-5.5 約低 25%。當時切換時 Day 60 工作日誌有完整紀錄,如需細節追溯我可以查封存。
你可以直接將此原因答給合作伙伴。
由 Terminal 一句安裝 —— 開新 AI 對話貼一句 —— AI 自己讀齊治理檔、宣告載入哪個工作模式 —— 計劃階段停手等你確認 —— 安全 / 知識整理 / 寫作模式自動加碼配合任務 —— 收工一句「收工」自動寫好下次提示 —— 新對話貼回去就接得回。Case A 與 Case B 各七步,Case C 則跨越多月演進,但骨幹節奏跨案例、跨工具、跨日子都是同一套。
你之後做第三個、第四個任務 —— 寫電子報、做股市觀察、整理多個項目的發票 —— 流程仍然是這套。工作模式會根據任務性質自動切換,但你的習慣動作(貼提示、講任務、確認計劃、收工)始終一樣。
另外建議:你希望 AI 在單一對話內的做事規矩(語氣、優先序、回覆骨架、安全護欄、輸出層分工)有持久基準,可以配合 Adam-AI-Instructions 使用 —— 到該倉庫的「五、Prompt 索引」選擇適用版本,複製對應 prompt.md 全文貼入你 AI 工具設定(Claude Cowork Global Instructions、Claude Code ~/.claude/CLAUDE.md、ChatGPT Custom Instructions 等)。Agent Handoff Kit 管「對話之間」的接力,Adam-AI-Instructions 管「單次對話質素」,兩者不重疊,配合使用效果最好。