AI 必須先確認目前資料夾

顯示目前工作資料夾的絕對路徑。
問用戶：「這是否就是要安裝或升級 Agent Handoff Kit 的資料夾？」
未能確認時停止，不執行 `init`、`upgrade` 或 `doctor`。
確認後才檢查本資料夾是否已有 `AGENTS.md`、`CLAUDE.md`、`GEMINI.md`、`START_NEXT_SESSION_PROMPT.txt` 或 `dev/`。

安全邊界： 不刪除、不覆寫衝突、不處理 credential、不執行 git commit、不執行 git push、不執行 git tag、不執行 npm publish、不建立 GitHub Release。

判斷安裝方式

情況一：完全未安裝

如果沒有 `AGENTS.md`、`CLAUDE.md`、`GEMINI.md`、`START_NEXT_SESSION_PROMPT.txt`、`dev/`，使用 fresh install。

npx --yes @adamchanadam/agent-handoff-kit@latest init --yes --root .

情況二：已有 Kit 或 AI 記憶檔

如果已有任何 Kit 檔案或既有 AI 記憶檔，先預演升級，不直接覆寫。

npx --yes @adamchanadam/agent-handoff-kit@latest upgrade --dry-run --root .

預演無衝突時： 才執行正式升級。

npx --yes @adamchanadam/agent-handoff-kit@latest upgrade --yes --root .

預演有 conflict 時： 停止。列出衝突檔案與原因，請用戶決定，不自行合併、不重裝覆寫。

完成後驗收

安裝或升級完成後執行健康檢查。

npx --yes @adamchanadam/agent-handoff-kit@latest doctor --root .

若 `doctor` 通過，讀 `AGENTS.md`，再按 `Start Agent Handoff` 的開工流程接上本資料夾。
若 `doctor` 失敗，停止並向用戶列出失敗項；不要重裝覆寫。
若 `doctor` 只提示 `START_NEXT_SESSION_PROMPT.txt` 便利副本落後，說明它會在正式收工時重新產生；不要因此重裝。

AI 回覆格式

本段是頁頂完成報告契約的檢查清單。執行完後，AI 不可只說「完成」或只貼終端機輸出。必須用簡短中文向用戶交代結果和下一步。

✅ 結果：安裝完成、升級完成，或因 conflict 停止。
📁 目前資料夾：顯示已確認的絕對路徑。
🩺 健康檢查：說明 `doctor` 是通過、失敗，還是只提示便利副本落後。
⚠️ 下一步不是終端機指令：`Start Agent Handoff` /「開工」要輸入到能讀寫此資料夾的 AI 對話。
🚀 下一步：若 AI 已在此資料夾內，請用戶輸入 `Start Agent Handoff` 或「開工」；若 AI 還未指向資料夾，才提供帶路徑啟動句。

完成報告範本：

✅ 安裝完成。📁 目前資料夾：<絕對路徑>。🩺 `doctor` 已通過。下一步不要留在終端機；請在能讀寫此資料夾的 AI 對話輸入 `Start Agent Handoff` 或「開工」。若 AI 還未指向此資料夾，才使用：`Work in <絕對路徑>. Read AGENTS.md first, then Start Agent Handoff. Before changing anything, tell me the current state and your recommended next step.`

給 AI 讀的
安裝與升級指令

用戶只需貼這一句

AI 完成後必須回覆這份報告