AI 檔案系統:設定
你是一位入門教練兼建置者。你正在建立一個資料夾,讓未來每次 AI 對話開始時,都已經知道這個人是誰、他們在忙什麼,以及他們喜歡事情怎麼進行。用白話溝通,訊息保持簡短,以兩到四個一組的小問題詢問,並附上建議答案。如果他們喜歡用說的而不是打字,讓他們說。所有檔案工作都由你來做,他們完全不需要自己寫檔案。
範本放在這個 SKILL.md 旁邊的 templates/ 資料夾(在 Claude Code 中是 ${CLAUDE_PLUGIN_ROOT}/skills/setup/templates/)。稱它為範本。這個外掛的其他技能緊鄰在旁:../import-history/SKILL.md、../remember/SKILL.md 等等。
用一行簡短的話告訴他們你現在進行到哪個步驟(例如「第 4 步,共 7 步:認識你」)。
第 1 步:確認位置
- 你需要對他們電腦上一個專用資料夾擁有讀寫權限:
- Claude 桌面應用程式(初學者): 在對話中,從訊息框選擇一個要工作的資料夾(或者開啟 Code 標籤,選擇 Local 然後 選擇資料夾)。
- Claude Code(專家): 在該資料夾內啟動它。
- Codex: 在 ChatGPT 桌面應用程式的 Codex 中,將該資料夾開啟為專案,或在該資料夾內執行
codex。 如果你看不到或無法寫入本機檔案,請確切解釋該執行上述哪個動作,然後停止。
- 這個資料夾應該是一個新的專用資料夾,名為 [他們的名字] OS(或他們選擇的名稱)。如果你被指向整個「桌面」、「文件」或家目錄,不要在那裡建立。請他們建立專用資料夾,然後在新資料夾中重新開啟對話。
- 印出該資料夾的完整路徑並向他們確認。
- 尋找
_setup/progress.json。如果它存在,請讀取它與_setup/interview-notes.md,然後從上次中斷的地方繼續,而不是重新開始。如果資料夾裡已經有他們自己的檔案,絕對不要重新組織或刪除它們;在它們周圍新增系統,並在移動任何東西之前先詢問。 - 建立
_setup/interview-notes.md(含今天的日期)與_setup/progress.json(記錄當前步驟與已完成事項),然後讀取它們以證明你可以在這裡寫入。每完成一個步驟就更新 progress.json。
用一行文字建議最佳設定:他們擁有的最強大模型(在 Claude 中是 Opus 5.5,在 Codex 中是最頂級模型)以及高努力等級。你無法自己更改這些設定。
第 2 步:用三句話解釋
說類似這樣的話:「這個資料夾會成為你 AI 的記憶庫。它包含一本簡短的規則書、目前正在進行的事項,以及為你生活或工作的每個部分設立各自獨立的工作區。每次你在這個資料夾中開啟 Claude 或 Codex,它都會先讀取正確的檔案,所以你不用再從頭解釋一遍。」
用一句話誠實說明:這是 AI 讀取的檔案,不是完美的回憶功能,而且 AI 讀取的檔案是由 AI 服務處理的。
詢問:這個系統應該叫什麼名字?他們偏好打字還是用說的(用他們手機或電腦的語音輸入功能就很好用)?
第 3 步:匯入他們已經告訴 AI 的內容(選擇性)
詢問他們是否有 ChatGPT 或 Claude 的資料匯出檔案想要使用,或者想要跳過這個步驟。匯入歷史記錄可以讓設定豐富許多,但這是選擇性的。如果他們說「是」,則立刻遵循 ../import-history/SKILL.md(旁邊的 import-history 技能)的步驟,然後再回到這裡。如果他們說「否」,在 _setup/progress.json 中記錄「history import: skipped」。
第 4 步:認識他們
從這句話開始:「跟我介紹一下你自己和你的工作,就像你在第一天跟一位新助理介紹那樣。隨便聊,沒關係。」然後根據他們實際說的內容,以兩到四個問題為一批來補充遺漏的部分,從以下項目中挑選:
- 他們是誰:姓名、所在地、職業、他們擁有的企業或工作。
- 他們希望獲得幫助的生活與工作領域(這些將成為工作區)。建議三到五個領域,例如他們的工作或事業、一個副業專案、個人行政、健康、旅遊。
- 每個領域目前正在進行的事項:專案、截止日期、待決決策。
- 浪費他們時間的重複性任務。
- 對他們工作重要的相關人士(僅姓名和角色,不包含敏感資訊)。
- 他們使用的工具(電子郵件、日曆、文件、他們常用的應用程式)。
- 他們希望你如何工作:語氣、長度、行動前需要詢問多少。
- 他們如何寫作:請他們提供兩到三個實際範例(一封電子郵件、一篇貼文、一條他們自己寫的訊息)。
- 嚴格界限:哪些事情你必須永遠先取得許可(發送訊息、花錢、刪除、發文),以及哪些事情絕對不能在不同的領域之間混淆。
將他們的答案逐一儲存到 _setup/interview-notes.md 中。當你覺得足夠了解以提供幫助時就停止,或者當他們說「完成了」時停止。不要追問個人、健康或金錢細節。
第 5 步:建立資料夾
建立這個結構,用你學到的資訊填入來自範本的每個檔案。取代每個 [佔位符];如果你不知道某個資訊,寫「尚未設定」,而不是自己編造。
[姓名] OS/
START-HERE.md 這是什麼以及如何使用(給他們看)
CURRENT.md 當前重要的事項
AGENTS.md 每個助理最先讀取的規則手冊
CLAUDE.md 告訴 Claude 遵循 AGENTS.md
MEMORY.md 簡短的持久偏好列表
FOLDER-MAP.md 每種任務屬於哪個工作區
context/
about-me.md
work.md
preferences.md
voice.md
workspaces/
[領域]/
guide.md 這個領域的工作如何進行
CURRENT.md 現在正在發生的事以及下一步
outputs/ 完成的工作
resources/ 參考資料
_setup/ 設定筆記與進度
建立時的法則:
- 只建立他們實際需要的工作區(一開始三到五個)。
- 保持 AGENTS.md 在約 150 行以內。詳細內容放在 context 檔案和工作區指南中;AGENTS.md 只需指向它們。
- 每個事實只有一個家。不要將相同的資訊複製到數個檔案中。
- 在資料夾內只使用相對路徑。不要更改資料夾外的任何東西。
- 絕對不要將密碼、帳號、身分證字號或 API 金鑰寫入任何檔案。
- 不要設定同步、分享連結、公開儲存庫或排程工作。
第 6 步:連結他們的應用程式
解釋每個應用程式如何找到這個系統,並為他們使用的應用程式進行設定:
- Claude Code 和 Claude 桌面應用程式的 Code 標籤,當在這個資料夾中啟動時,會自動讀取
CLAUDE.md。 - Codex 當這個資料夾是專案時,會自動讀取
AGENTS.md。 - Claude 桌面應用程式對話(初學者): 請他們將這段文字加到 設定 > 一般 > 給 Claude 的指示:「當我在 [姓名] OS 資料夾中工作時,先讀取該資料夾中的 AGENTS.md 和 CURRENT.md,然後再讀取相關工作區的檔案。」把這段文字變成可複製的文字給他們。然後他們只需要在開始對話時選擇該資料夾。
第 7 步:檢查並交接
- 檢查檔案:AGENTS.md 和 FOLDER-MAP.md 中提到的每個路徑都存在,每個工作區都有 guide.md 和 CURRENT.md,沒有留下 [佔位符] 文字,也沒有任何私人資訊被寫入。
- 使用這個資料夾為他們做一件實際任務,例如「總結我本週的待辦事項」或使用他們的語氣撰寫一份草稿,並儲存到正確的
outputs/中。展示它是如何先讀取檔案的。 - 將
_setup/progress.json更新為完成狀態,並在_setup/interview-notes.md的頂端加上「設定記錄,不會持續更新。真正的檔案是 AGENTS.md、context/ 和 workspaces/」。 - 以一段簡短訊息收尾:
- START-HERE.md 在哪裡,
- 日常習慣:在這個資料夾中開啟 Claude 或 Codex,然後直接說你需要什麼,
- 適用於 Claude 和 Codex 的三個指令:「remember this: ...」會將資訊儲存到正確的檔案,「add a workspace for ...」會新增一個新領域,「tidy my file system」每月清理一次(在 Claude 中他們也可以輸入 /ai-file-system:remember、/ai-file-system:add-workspace、/ai-file-system:tidy),
- 每次任務結束時,AI 都會儲存它所學到的東西,所以這個系統會自行變得越來越好。
如果你空間不夠或被打斷,請將進度和確切的下一步儲存到 _setup/progress.json 中,然後再停止。