Cross AI Progress Bridge — AI skill for Claude Code

Cross-AI Progress Bridge｜跨 AI 進度接力

換新對話、換模型，進度不用重講。

[繁體中文](#繁體中文) · [English](#english) · [Landing page](https://cross-ai-progress-bridge.pages.dev) · [MIT License](LICENSE)

繁體中文

Cross-AI Progress Bridge 把工作進度存成專案裡可讀的 Markdown。Claude Code、Codex，以及同一工具的新對話，只要開啟**同一個實體資料夾**，就能依序接手。

你可以直接說：

• 記錄進度
• 繼續上次進度
• 我有哪些進度還沒做完的？
• 列出進行中

它保存任務目標、目前成果、下一步、卡點、決策、驗證方式與相關檔案；不會把整段聊天記錄重新塞進下一個對話。

適合哪些情況

• 同模型換新對話：Claude Code 換到新的 Claude Code 對話，或 Codex 換到新的 Codex 對話。
• 跨模型交班：在 Claude Code 與 Codex 之間切換，讓不同工具接續、實作或審查。
• 一次管理多件事：問「我有哪些進度還沒做完的？」即可列出 active 與 blocked 任務。
• 保留既有系統：偵測到原有 AI 規則或進度名稱時，先停止並詢問；同意後只以隔離的 sidecar 模式共存。
• 純本機、可讀格式：不需要 Obsidian、資料庫、帳號或專案後端；安裝後的 bridge 本身不連網，也沒有遙測。

這不是聊天記錄同步，也不是兩個 AI 同時修改同一份工作。它做的是**依序交班**；一次只讓一個 AI 更新同一任務。

新手安裝

先確認 Python 3.10 或更新版本

安裝器只使用 Python 3.10 以上版本的標準函式庫，不需要另外安裝套件。你可以先請 Claude Code 或 Codex「只檢查這台電腦是否有 Python 3.10 或更新版本，不要安裝也不要改檔」。

• Windows 可檢查 py -3 --version 或 python --version。
• macOS 可檢查 python3 --version。

如果沒有，請從 [Python 官方網站](https://www.python.org/downloads/)安裝後再繼續。專案本身仍不用手動下載 ZIP、解壓或搬檔。

第一次請用安全的空資料夾

不要直接在「桌面」本身、家目錄或放著很多專案的共同資料夾安裝。也不要拿含病歷、未去識別化個資、密碼、API key 或其他機密的資料夾測試。

**Windows**

1. 打開「檔案總管」。
2. 左邊點「文件」。
3. 在空白處按滑鼠右鍵，選「新增」→「資料夾」。
4. 命名為 AI進度接力測試。
5. 在 Claude Code 或 Codex 使用「開啟資料夾／開啟專案」功能，選剛才的資料夾。

**macOS**

1. 打開 Finder。
2. 左邊點「文件」（Documents）。
3. 選「檔案」→「新增檔案夾」。
4. 命名為 AI進度接力測試。
5. 在 Claude Code 或 Codex 開啟剛才的資料夾。

不同版本的按鈕名稱可能略有差異。重點只有一個：畫面裡的目前專案，必須是剛建立的資料夾，而不是「文件」、桌面或家目錄本身。

複製這段提示詞

同一段可以貼給 Claude Code 或 Codex。選一邊安裝一次即可；不要讓兩邊同時執行安裝。

**複製從這裡開始**

請直接在目前開啟的專案安裝 Cross-AI Progress Bridge，不要只解說。把 https://raw.githubusercontent.com/Nouischen/cross-ai-progress-bridge/v1.0.0/bootstrap/install.py 下載到作業系統暫存資料夾（不要存進專案），先驗證 SHA-256 必須完全等於 9D5BD5DBDCD2436CD669C419B9731839B1B4E5E080E8C7BCA366915FC63CBA01；不符就停止，不得換來源。用 Python 3.10 或更新版本執行已驗證的 install.py，--target 指向目前專案的絕對路徑；若缺少合格的 Python，先停止、不要修改專案，並用白話教我從官方來源安裝。若回傳 INSTALL_NEEDS_CONSENT，只列出偵測名稱並問我；只有我明確同意後，才用同一檔案加