SuiK.

讓想法成為現實。
軟體工程師與創作者 · 台灣

所有文章

AI 與自動化

還沒給你的 AI 裝上 GitHub?那你永遠只用了 AI 不到半成的能力。

先把 ChatGPT 連接 GitHub,再用四段可複製的 Prompt 建立 Repo、README.md 與 INDEX.yml,讓 AI 能跨對話找回資料。

Building a Home for AI Memory|上篇

「還沒給你的 AI 裝上 GitHub?那你永遠只用了 AI 不到半成的能力。」

你可能遇過這幾種狀況:

  • 跟 ChatGPT 討論了好幾天的計畫,換個聊天視窗,又要從頭交代背景。
  • 明明已經否決過的方案,下次聊天時 AI 卻又拿出來推薦。
  • AI 說得好像記得之前的決定,你卻分不清它是真的查到紀錄,還是靠片段資訊猜的。

我的做法是把重要資料放到 GitHub,讓 ChatGPT 需要時自己回去查。

今天不用先學程式,也不用背 Git 指令。先把 ChatGPT 連上 GitHub,再用四段 Prompt 做出自己的 AI 雲端工作空間。

GitHub,就是 AI 的另一個雲端桌面

你可能聽過,或是已經在用過Github,這幾乎是工程師都一定會用到的工具平台

但我今天沒打算講Github多技術性的東西。

我只需要你先把 GitHub 想成 Google 雲端硬碟,只是它更擅長保存文字的修改歷史。

  • 一個 Repository(Repo):一個獨立的雲端工作空間。
  • Repo 最外層:你的桌面;裡面的資料夾可以放工作、筆記、計畫。
  • Markdown(.md)檔:AI 和你都能讀的筆記。
  • Commit:這份資料曾經怎麼改、什麼時候改的紀錄。

例如你開了 my-life、my-work、my-ideas 三個 Repo,就像替 AI 準備三個不同用途的雲端硬碟。不用一次建三個,先從一個開始就好。

這只是方便理解的比喻:Repo 不是真的 Windows 虛擬電腦,也不會像 Google Drive 一樣自動同步所有檔案。但對長期筆記、專案決定與文字資料來說,很實用。

直接複製:四段 Prompt 就能開始

接下來,我想用最簡單的方式,讓還不熟悉 GitHub 的你也能親手試試看。

不用先研究設定,也不用背操作步驟。把下面的 Prompt 直接複製、貼給你的 ChatGPT,讓你的 AI 根據實際情況一步步教你。

準備好 ChatGPT 和 GitHub 帳號就能開始。需要登入或授權的部分,由你在官方畫面親自確認。

開始前|先讓 ChatGPT 連接 GitHub

這一步先自己點幾下,後面才有辦法讓 AI 真的讀到你的 Repo:

  1. 打開 ChatGPT → 設定(Settings)→ Apps 或 Plugins,找到 GitHub。若畫面顯示安裝,先安裝,再選擇連接。
  2. 依官方畫面登入 GitHub,確認是自己的帳號,並授權 ChatGPT 存取你選擇的 Repository。建議只開放需要用到的 Repo。
  3. 回到 ChatGPT,準備貼下方第一段 Prompt,讓 AI 檢查是否真的能讀取。如果 Repo 是連線後才新建的,記得回到 GitHub 的連線設定,把新 Repo 加入授權清單。

找不到 GitHub 選項也不用亂試:不同方案、工作區與模式的支援可能不同,直接依 OpenAI 官方連接說明 查看當下可用的入口。不要在聊天中貼密碼或 Token。

① 建立第一個 Repo,確認 AI 讀得到

我想用 GitHub 當作 AI 的雲端工作空間。
請幫我建立一個叫 my-ai-space 的 Private Repository;如果已經有了就直接沿用。

先確認你是否真的能讀取我的 GitHub,以及目前有哪些實際權限。
可以直接完成的就做;做不到的,帶我在官方畫面完成下一步。
如果新 Repo 還沒授權給 ChatGPT,提醒我去哪裡追加授權。

最後實際讀取這個 Repo 確認連線成功,不要只憑「已連接」就當作完成。
不要向我索取密碼或 Token。

如果 AI 無法代為建立 Repo,就打開 GitHub 建立 Repo,輸入 my-ai-space 並選擇 Private。建立後回 ChatGPT 的 GitHub 連線設定確認這個 Repo 已被授權,再請 AI 實際讀一次。

② 用需求決定資料夾,不自己畫架構圖

請查看 my-ai-space 目前有哪些檔案,我想把這裡當成 AI 的長期工作空間。

先問我真正需要確認的用途,再幫我規劃簡單、好找的資料夾。
並且幫我準備兩個入口:
- README.md:讓我和未來的 AI 一眼看懂這個 Repo 的用途、主要資料夾和使用方法。
- INDEX.yml:告訴 AI 各類資料應去哪個資料夾找、哪些檔案是最新依據,以及需要時該先讀什麼。

以後新增重要資料夾時,也幫我判斷要不要加該資料夾的 README.md,並同步更新索引。
請以現有內容為主,不要為了架構漂亮建立一堆空資料夾。

有寫入權限就依我確認的方案建立;不能寫就提供完整檔案內容和最短的儲存步驟。
最後確認實際存在哪些檔案,不要把「寫好草稿」當成「已經存進 GitHub」。

這裡的重點是 README.md 像門口的簡介,INDEX.yml 像資料夾地圖。它們不是會自動執行的魔法檔案;是我們約定讓 AI 每次回來先讀的入口,才能少翻不相關的資料,也減少找錯版本。資料夾多了,再慢慢補各區的 README.md 就好。

我沒有替你指定「生活、工作、財務」該怎麼分類,因為每個人的需求不同,讓 AI 先問、再判斷。

③ 想記什麼,就直接說

請把下面這件事整理到 my-ai-space:

【在這裡貼上我的筆記、計畫或決定】

先讀 README.md 和 INDEX.yml,再找相關檔案,決定應該新增還是更新。
如果新增了重要資料夾,記得同步更新索引。
保留我的原意,區分已完成、計畫中與不確定的事;不要自行補事實。
能寫入就存檔並讀回驗證;不能寫入就提供完整內容與最短的手動儲存方式。
最後告訴我實際檔案路徑。

你可以把中間那行換成「幫我記下下週想完成的三件事」,或直接貼一整段討論結果。重點是用自然語言交代事情,而不是學一套檔案管理語法。

④ 換一個聊天視窗,測試它能不能接著做

開一個新對話,不必重新貼舊內容。

請先讀取我的 GitHub Repo:my-ai-space。
先讀根目錄的 README.md 和 INDEX.yml,再依照索引找到與這次需求相關的最新資料。

我想接續的事情是:【填入主題或問題】

請根據實際讀到的檔案回答,附上來源路徑。
若資料與我現在的新決定不同,先指出差異,再建議最小修改。
需要修改時,先確認內容與權限;完成後再讀回驗證。
找不到或沒有權限就直接說,不要憑印象假裝讀過。

這就是我要的效果:AI 不必記住每一句話,但必須知道去哪裡找你真正保存過的答案。

一件事要分清楚:能讀,不等於能改

這裡最容易誤會。

ChatGPT 的標準 GitHub 連接主要是讀取、搜尋和分析。 要讓 AI 直接新增、刪除或修改 Repo 裡的檔案,必須使用當下確實具備寫入授權的工具,例如支援相應操作的 Codex 工作流程。單靠 Prompt 無法突破權限限制。OpenAI 官方說明

所以你會遇到兩種情況:

  • 唯讀:AI 幫你找到資料、整理好新版;你在 GitHub 網頁貼上並儲存。
  • 可寫:AI 能在你授權的範圍內修改、提交;完成後仍要檢查檔案與 Commit。

另外,Private Repo 不是密碼保險箱。不要把密碼、API Key、驗證碼放進 Git;重要資料也應另外備份。

AI 不必什麼都記得,但你要找得回來

類似做法已經有人在嘗試。社群裡有人用 Markdown 和每日紀錄幫 AI 接續工作,也有人開發 Git 型的 Agent 記憶專案。這不是我發明的新技術,卻是一般使用者也值得嘗試的工作方式。社群實作 · GitHub 範例

ChatGPT 原本就有記憶功能,但它與一份自己看得到、改得了、能查版本的檔案是兩件事。Memory 官方說明

對我來說,差別只有一句話:與其期待 AI 永遠記得,不如給它一個忘記時能回去找的地方。

下篇,我會分享自己怎麼把這套方法再往前推:不只保存筆記,而是和 AI 夥伴 Mio(澪)一起,把私人 Repo 慢慢建成一個有規則、有目錄、也有共同回憶的「家」。

SuiK. — From Ideas to Reality.

更多文章