ai-workspace

個人 AI 作業系統 — 讓 Claude Code、Gemini CLI、Codex 共用同一份規則、記憶與知識。

前身為 second-brain（再更早是 ai_refrence）。詳細重構決策紀錄見 ai-workspace-design.md。

日常同步

已完成 bootstrap 後，日常更新一律用 sync.sh（WSL / SSH）：

日常使用

第一次進入新專案目錄時： context-loader 會偵測到 CLAUDE.md 不存在，提示執行 /init-project-md。 該 skill 會分析 codebase、將本體存入 projects/.md，並在專案目錄建立 symlink。

新增工作專案

推薦在專案目錄開 Claude Code，走 context-loader 互動選單自動建立本體 + symlink（見 docs/快速上手指南.md）。舊版需要手動編輯 .gitignore 加專案代號、編輯 context-loader/SKILL.md 偵測表兩個步驟，皆已移除，不再需要。

Git 版控範圍

不做公私分離、不維護白名單。rules/、mem/、projects/（含各工作專案 CLAUDE.md）、skills/、adapters/、setup/ 等全部進 Git，任何主機新增的內容 sync.sh push 之後，其他主機/平台都能同步拿到同一份。

沿革： 最初曾規劃「公開骨架 vs 私密內容（rules/global.local.md、projects/ 工作專案 .md）」的白名單機制，因專案改名/新增時容易忘記同步維護，2026-07-02 已證實造成一次機密外流（已用 git filter-repo 清除歷史修復）。2026-07-03 進一步確認：不再區分公私，全部進 Git，機密性由使用者 commit/push 前自行把關。ai-workspace repo 目前是 Public，這點務必留意。

MCP 不由 ai-workspace 管理

MCP server 的安裝/設定/憑證各主機各自獨立處理，用 Claude Code 原生的 claude mcp add ... 即可，不透過 ai-workspace 集中管理或同步。哪台主機需要哪個 MCP，就在那台上裝一次；ai-workspace 不記錄安裝清單、不同步架構設定或憑證。

沿革： 2026-07-02 設計階段曾規劃 mcp/settings.json（架構設定）+ mcp/.env.example（憑證範本）+ mcp/manifest.md（安裝清單，號稱由 sync.sh 自動偵測/自動 push）三件套集中管理機制，但從未真正實作（sync.sh 從頭到尾沒有任何 MCP 相關程式碼）。2026-07-03 確認：不需要統一管理，直接維持 Claude Code 原生的各主機獨立模式，相關規劃文件與範本檔案已移除。