v0.4.6 - 核心規則直接提醒先讀後跑

v0.4.6

本版新加了甚麼

• 每次都會讀的核心安全規則新增一句：AI 第一次執行新寫或改過的程式（包括測試和輔助腳本）前，即使確切指令來自你、文件或另一個 agent，也要先另外讀清楚它的用法，以及它會刪除或覆寫甚麼，再按 dev/rules/coding.md 第 6、7 條處理。
• 這樣不必等 AI 自行打開程式工作規則，也會在執行前看到這項要求。

對你已有檔案的影響

• 由 v0.4.5 升級時，本版的規則改動只在 AGENTS.md 內由工具管理的核心區段；核心區段以外的內容會保留，版本紀錄等照常更新。
• 如核心區段曾在本機被改動，升級會停手而不寫入檔案，可交給 AI 協助處理。
• 這是 AI 執行程式前的工作要求，用來減低誤刪風險；重要工作仍建議保持提交或備份。
• 本頁介紹 v0.4.6；可下載版本以 npm 發布記錄與 GitHub Release 為準。

建議下一步

升級後照常工作即可。若你給 AI 一條會執行新程式的指令，它可能先讀程式並說明風險，才決定是否照跑；這項規則本身不授權提交或備份。

v0.4.5 - 執行新程式前先防誤刪

v0.4.5

本版新加了甚麼

• AI 第一次執行新寫或改過的程式前，須先另外讀清楚用法，留意參數、環境變數、刪除及覆寫；如可能刪除或覆寫它自建暫存位置以外的內容，須先確認工作可復原（已提交、已備份或在隔離副本執行），否則先問你。
• AI 自己寫的測試和輔助腳本只可清理它自建的暫存位置；核實不到目標便停止並回報失敗。
• 部分規則說明刪去重複字句，規則要求不變。

對你已有檔案的影響

• 升級會更新已安裝的規則正文，包括 dev/rules/coding.md；你寫在 ## Project Rules 之後的專案附錄會保留。
• 如規則正文曾在本機被改動，升級會停手而不寫入檔案，可交給 AI 協助處理。
• 新規則是 AI 執行程式前的工作要求，用來減低誤刪風險；重要工作仍建議保持提交或備份。
• 本頁介紹 v0.4.5；可下載版本以 npm 發布記錄與 GitHub Release 為準。

建議下一步

升級後照常工作即可。AI 執行新寫或改過的程式前，應先按新規則閱讀用法及確認適用的復原條件；這些規則本身不授權提交或備份。

v0.4.4 - 收工狀態判讀更清楚

v0.4.4

本版新加了甚麼

• 收工檢查會把已確認的交接狀態與另一項未完成工作分開判讀；同一項交接仍未解決時，仍會阻擋收工。
• Workspace Identity 現在可讀取 Markdown 表格內的 Git 身分，減少其他說明文字造成的誤判。

對你已有檔案的影響

• 既有交接和安全檢查不會自動改寫；真正未確認的收工狀態仍會明確顯示為阻擋原因。
• 本頁介紹 v0.4.4；可下載版本以 npm 發布記錄與 GitHub Release 為準。

建議下一步

升級後如收工被阻擋，保留訊息交給 AI 檢查對應欄位；如工作已確認完成，其他未完成工作可按原本計劃繼續處理。

v0.4.3 - 收工檢查更準確

v0.4.3

本版新加了甚麼

• 修正收工時對 SESSION_LOG 的判斷：工作紀錄純粹因為較長，只會提示日後整理，不會單獨令收工失敗。

對你已有檔案的影響

• 交接、必要工作紀錄、快捷入口和其他安全檢查仍是收工前必須通過的條件；有真正缺口時，AI 仍會停下來說明。
• 本頁介紹 v0.4.3；可下載版本以 npm 發布記錄與 GitHub Release 為準。

建議下一步

如收工被阻擋，保留訊息交給 AI 檢查實際缺口；不需要因為工作紀錄長度而先刪除或搬移既有內容。

v0.4.2 - 交接與更新驗收更可靠

v0.4.2

本版新加了甚麼

• 長工作遇到跨步驟或反覆沒有進展的問題時，AI 會回到原因和安全界線重新核對，不把重複嘗試當成完成。
• 開工遇到未完成的升級會先停下來，避免讀到更新到一半的交接資料。
• 收工時會核對必須處理的工作紀錄和專案快捷入口；有缺口便清楚列作阻礙，不以看似完成的狀態卡掩蓋。具體待辦可以如實標示尚待核實的資料，不會只因這些字眼而被誤擋。
• 發布前後的驗收會分開本機演練與正式更新，並保留每個快捷入口的操作證據，避免未證明的結果被說成已可用功能。

對你已有檔案的影響

• 這些調整不會自動改寫你已保存的交接、工作紀錄或自訂內容。
• 需要停下來檢查時，AI 應說明仍欠甚麼，而不是把未完成的檢查當成成功。
• 本頁介紹 v0.4.2；可下載版本以 npm 發布記錄與 GitHub Release 為準。

建議下一步

繼續用 Session 接力棒保存工作脈絡。需要更新時，請 AI 先檢查目前可安全使用的正式版本，再在你的專案內處理。

v0.4.1 - 快捷入口與清晰安裝指引

v0.4.1

本版新加了甚麼

• 新增 handoff-kit-update。你主動要求時，AI 會先檢查 npm 的正式版本；有新版才按既有安全流程為這個專案更新，已是最新版便不改檔。
• 所有專案快捷入口會隨正常安裝或升級一併交付。舊官方入口只有在內容完全符合時才會安全更新；自訂內容或衝突會保留，並先向你說明。
• handoff-kit-progress 會隨正常安裝或升級帶入本機進度頁程式。之後開啟進度頁不必每次下載 npm，暫時無法連線或快取不可寫時仍可查看已保存的專案狀態。
• 整理入門、指南、安裝及案例頁，讓常用指令、交接用途和安全界線更容易閱讀，並沿用現有品牌視覺。

對你已有檔案的影響

• 新入口只安裝在你指定的專案，不會寫入電腦的共用 AI 設定位置。
• 更新會保留現有專案資料。遇到自訂內容、衝突或無法確認的版本，AI 會停下來說明，不會直接覆寫或降回舊版。
• 已安裝或完成升級的專案，可直接用進度頁查看已保存的內容；這不會代替交接讀取，也不會把未保存的工作當成完成。
• 本頁介紹 v0.4.1；可下載版本以 npm 發布記錄與 GitHub Release 為準。

建議下一步

先看完整指南了解各個指令的用途；如想使用最新正式版，請在專案的 AI 對話輸入「檢查更新」或 handoff-kit-update，讓 AI 先確認是否有可安全更新的版本。

v0.4.0 - 專案進度看得見，交接更完整

v0.4.0

本版新加了甚麼

• 八個專案快捷入口，把開工、收工、進度頁、文件對齊及常用功能放在同一組清晰口令中。
• 新增繁中／英文動態 Dashboard，一眼看到目前工作、未完成事項、歷程和文件關係。AI 正常保存紀錄後，畫面自動更新，不用另寫一份進度報告。
• 修正開工只讀部分交接包卻聲稱已接上的缺口：必須讀齊同一版本並核對工作脈絡；未讀齊便如實說明。

對你已有檔案的影響

• 升級仍先預演、保留現有資料，遇到未知修改或衝突便停止。
• 快捷入口按專案啟用，拒絕全域安裝；不同 AI 工具沿用各自的入口方式。
• Dashboard 讀取既有保存紀錄，查看與畫面更新不額外呼叫 AI。介紹頁及指南亦加入兩語實際畫面。

建議下一步

請在專案資料夾向 AI 說：

為這個專案升級 Agent Handoff Kit，先預演並保留現有資料；完成後啟用專案快捷入口及開啟 Dashboard。

v0.3.67 - 開工命名更準，升級更安心

v0.3.67

本版新加了甚麼

• 說「開工」後，Kit 會先在最少必要的交接資料中找出專案與當前要做的事，再安全地把新 thread 命名成「專案｜當前行動」。這只改畫面標題，不會改你的任務、權限或交接內容。
• 收工檢查現在會分辨「已完成」和「仍有限制／待跟進」是否在說同一件事，減少把誠實記錄的限制誤判為互相矛盾。
• 升級時更小心保留你寫在下一次開工提示中的內容；只會更新能精確證明屬於舊官方範本的完整開場，或在不刪除你補充內容下補回遺失的官方安全指令。

對你已有檔案的影響

• 不需要手動改名或重寫交接檔。已有清楚名稱、用戶自己設定的名稱及不適合推斷專案名稱的情況，Kit 會保留或跳過。
• 你原有的收工記錄可以如實保留「本地完成、外部驗收仍有限制」等不同範圍；真正針對同一範圍的完成與未完成矛盾，仍會被擋下。
• 升級仍先預演；遇到未知的本地改動或衝突，Kit 會停止並要求你決定，不會用空白範本覆寫內容。

建議下一步

在你的項目根目錄請 AI 執行一次升級預演並讀回結果：

請用最新 Agent Handoff Kit 為這個專案做升級預演；先確認根目錄，再執行 upgrade --dry-run 和 doctor，保留所有本地內容，並只報告結果與下一步。

v0.3.66 - 規則寫入更穩，安裝少做重複檢查 (經 GPT ASTRA 對齊)

v0.3.66

本版新加了甚麼

• 加入或修改長期規則時，AI 先查既有分類與合適位置，保留官方正文，減少日後升級時的合併衝突。
• 下一次處理相關任務時，AI 要讀取並運用適用規則及專案補充，遵守你的目標，不自行另定通過門檻。
• 安裝或升級完整成功且健康檢查通過後，AI 可直接採用同次結果，減少一次重複檢查；遇到中斷、不明狀態或後續相關改動，仍會恢復或重新檢查。

對你已有檔案的影響

升級更新核心及治理規則，保留可安全辨識的專案補充與交接內容。若舊規則已混入官方正文，仍會停止並由 AI 核對來源，在取得合併授權後保留並整理；不會自動猜刪或重裝覆寫。

這些要求引導 AI 並檢查結果，不能攔截任意編輯器寫入。

建議下一步

在原有專案內請 AI 讀取安裝頁並升級 Agent Handoff Kit。以後要加入長期規則，直接說明要求並請 AI 接入 Kit；由 AI 查找位置、合併及核對，無需手動整理規則檔。

v0.3.65 - 升級保留內容，交接更完整 (經 GPT ASTRA 對齊)

v0.3.65

本版新加了甚麼

• 修正部分舊安裝升級後版本號已更新、必要規則卻仍然過時的問題，也修正工作日誌標記造成的誤判。
• 交接會寫清整體目標、目前子任務、從哪裡接續、還欠哪些驗收，以及資料讀到哪裡、哪些仍未核實。
• 收工前，AI 要只憑交接內容重建下一步，再對照原始要求及成果。收工卡檢查保存狀態與已記錄的檢查；它不會自動證明任務結論正確。

對你已有檔案的影響

升級保留原有工作內容及交接紀錄。可辨識的官方舊規則會更新，自訂內容在可安全合併時保留；無法判斷的修改仍會停止，讓 AI 先查清楚。下一次正式收工時，AI 才按新規則核對實際工作狀態，不在升級時猜補。

工作仍未完成或受阻，也可以清楚交接；要保留原因、影響及續接條件。「已保存」不代表整體任務完成。簡單任務只記必要資訊。

建議下一步

升級時，在原有專案內請 AI 讀取安裝頁並升級 Agent Handoff Kit；之後照常說「開工」、交代任務，結束時說「收工」。不需要學習新的指令或手動整理交接欄位。