personal-os

帶有 Claude Code 的個人作業系統

此技能協助建立一個「brain」：一個文字檔案資料夾（Markdown 格式，可在任何編輯器中讀取），Claude Code 會將您委託的內容整理於此，找出已做出的決定，並為您的下一步做好準備。它會逐步引導，最初透過簡單的問題，之後再提供可複製的範本。

閱讀原則：第一次請依序遵循步驟。references/ 中的檔案包含詳細資訊與範本。您可以隨時參考。

0. 用途與成果

沒有記憶，每次與 Claude 的對話都得從頭開始。有了 brain，對話變得可拋棄，而資料夾成為記憶：重要的內容都寫入檔案，Claude 在回應前會先讀取這些檔案。

完成設置後的成果：

• 一個收件匣 (inbox/)，您可以放入任何原始素材：會議記錄、筆記、複製的郵件、螢幕截圖。
• 分為四個類別的處理：決策（附帶理由）、行動（附帶負責人）、新事實、未解決問題。
• 一個永不重寫的日誌、決策記錄與時間軸：只新增，不修改。
• 主題卡片（每個專案一個檔案）以及由一個小型腳本重新生成的摘要儀表板。
• 專業化的代理（攝取、董事會審查、一致性檢查、撰寫、準備一對一、諮詢決策）和簡短命令（/inbox、/journal...）。
• 一個變更追蹤檔案（CHANGELOG.md），說明要回報到外部工具（Wiki、工單系統、簡報）的內容。

未經您的同意，不會寫入任何內容：Claude 提出建議，您驗證，然後他才寫入。

1. 先決條件

• Claude Code 已安裝並可在您的機器上執行（終端機中可使用 claude 指令）。
• 一個空資料夾，例如 ~/brain。這將是 Claude 在此專案中唯一有權寫入的區域。
• Python 3 用作視圖腳本（選用，無需安裝其他項目）。
• 一個可以開啟 Markdown 檔案的文字編輯器。建議使用 Git 儲存庫，以便還原，但非必要。

在空資料夾中開啟終端機，然後執行 claude。

2. 初始訪談

Claude 會逐一提出以下七個問題，並等待您對每個問題的回答。簡短的回答即可。以下是 Claude 如何處理每個回答。

問題	Claude 的處理方式
1. 請用一句話說明您的角色與團隊？	填寫 CLAUDE.md 中的「我是誰」章節，讓 Claude 以適當的層級與您對話。
2. 您當前正在進行哪三到五個專案？	在 05_scope/sheets/ 中為每個專案建立主題卡片。
3. 您最常與哪些人合作（名字、角色）？	填寫 03_team/directory.md，並準備需要再次確認的名單。
4. 您會收到哪些素材（會議記錄、電子郵件、筆記、螢幕截圖）？	設定 inbox/ 的分類方式，以及 Claude 能夠讀取的格式清單。
5. 您的產出應回報到哪裡（Wiki、工單系統、簡報）？	調整 CHANGELOG.md：每個需要更新的頁面對應一行，標明「新增」或「取代」。
6. 您使用哪種語言書寫，以及您希望的寫作風格為何？	填寫 CLAUDE.md 中的「風格」章節。
7. 您希望以什麼頻率進行審查（每日、每週、在一對一會議前）？	選擇首先要安裝的命令與代理（步驟 5）。

在繼續之前，Claude 會用十行文字總結他理解到的內容，並等待您的確認。

3. 建立結構

Claude 會根據 references/structure.md 的描述提出目錄結構，並在您同意後建立。基本資料夾如下：

• inbox/ 和 archive/：原始素材的存放處，以及處理後的歸檔處。
• 00_journal/：日誌與時間軸（僅新增）。
• 01_steering/：任務板。
• 02_product/：關於產品的持久事實。
• 03_team/：人員名錄與協作筆記。
• 04_decisions/：決策記錄（僅新增）。
• 05_scope/：主題卡片與生成的視圖。
• 06_resources/：詞彙表、參考文件。
• scripts/：視圖腳本。
• .claude/：代理與命令。

黃金法則：一個檔案一個主題，一個中立的名稱。任何檔案都不應以人名命名。與人員相關的內容應放在名錄中。

接著複製 references/templates/ 中的範本，並將方括號中的欄位替換為您在步驟 2 中的回答。

4. 編寫 CLAUDE.md 指令檔案

CLAUDE.md 會在每次工作階段開始時由 Claude Code 自動讀取。它包含了遊戲規則。從範本 references/templates/CLAUDE.md 開始，並確保至少包含以下內容：

1. 您是誰，以及 Claude 應如何與您對話。
2. Claude 在收到新資訊時該做什麼（攝取協定，請參閱 references/ingestion-rules.md）。
3. 新鮮度規則、僅新增檔案、以及「一個事實，一個檔案」的規則。
4. 步驟 9 中的安全規則。
5. 您在問題 6 中選擇的寫作風格。
6. 經常被語音轉文字工具誤拼的專有名詞清單，應隨時間補充。

保持此檔案簡短：一到兩頁。詳細資訊存放在 references/ 的檔案中，Claude 會在需要時讀取。

5. 新增代理與命令

代理是專門的助手，擁有自己的指令和權限。命令是您在 Claude Code 中輸入的捷徑（例如 /inbox）。兩者都是 .claude/ 中的簡單 Markdown 檔案。

從小處開始。首先安裝：

• inbox-ingestion 代理和 /inbox 命令（用於處理您放入的內容）。
• /journal 命令（用於快速記筆記）。

然後，在需要時再新增：board-review、consistency-check、deliverables-writer、meeting-prep、decision-advisor，以及命令 /review-board、/prep-1to1、/propagate。每個代理的角色定義在 references/agents.md 中，可複製的範本位於 references/templates/.claude/。

每次新增後，要求 Claude 檢查檔案是否可被讀取：輸入 /agents 以查看清單。

6. 首次測試：放入筆記並讓 Claude 處理

1. 在 inbox/ 中寫入或貼上一份真實的筆記（即使很短），例如 inbox/2026-01-15_point-equipe.txt。
2. 輸入 /inbox。
3. Claude 會讀取檔案，標記可疑段落，比對現有資訊，然後向您呈現一份編號的修改建議清單，每項修改都包含：檔案名稱、變更前後內容以及來源。
4. 回覆「驗證 1, 2, 4」或「全部驗證」。若無明確回覆，則不會寫入任何內容。
5. Claude 寫入，將原始檔案移至 archive/，在 CHANGELOG.md 中記錄所做的工作，並重新執行視圖腳本。

完整協定位於 references/inbox-processing.md。一個包含原始筆記與結果的完整範例位於 references/example-acme/。

7. 常規流程

四個節奏足以開始。

• 每日（5 分鐘）。 將收到的內容放入 inbox/，輸入 /inbox，驗證。在一天結束時，輸入 /journal 記錄一則自由筆記。
• 會議後。 放入會議記錄或您的筆記，輸入 /inbox。優先檢查決策及其理由，然後是行動及其負責人。
• 每週。 輸入 /review-board，然後要求 consistency-check 代理檢查日期、狀態和姓名。重新執行視圖腳本。
• 在一對一會議前。 輸入 /prep-1to1 [名字]。meeting-prep 代理會彙整已討論的內容、待辦事項和未解決問題，並附上每行內容的來源。

8. 持續發展

• 新增主題。 將 references/templates/scope-sheet.md 複製到 05_scope/sheets/，填寫欄位，然後執行視圖腳本。
• 新增代理。 複製 references/templates/.claude/agents/ 中的一個範本，更改其名稱、描述和指令。在實際案例上測試後再正式採用。
• 新增視圖。 編寫或請人編寫一個小型腳本，讀取主題卡片並產生一個表格。它只能讀取，絕不能修改卡片。腳本 references/scripts/build_views.py 可作為起點。
• 一個變更影響多個內容時。 使用 /propagate（請參閱 references/use-cases.md 中的使用案例）。

在新增任何東西之前，請先問自己四個問題。這是否能避免我遺失一個決策及其理由？這是否能告訴我每個專案的下一個行動及其負責人？這是否能減少我在不同主題間切換的努力？這是否能為我的團隊留下有用的記錄？如果所有答案都是否定的，那就不要新增。

9. 安全規則

1. 提議、驗證、寫入。 Claude 會先展示他打算修改的內容。只有在您明確同意後，他才會寫入。
2. 絕不憑空捏造。 如果文字中沒有提及某個決策或行動，就不會建立。如果決策的理由缺失，就寫「理由未記錄」。
3. 標記可疑之處。 當段落含義模糊或名稱看起來像是語音轉寫的錯誤時，Claude 會指出問題並提問，而不是自行判斷。
4. 未經同意不刪除任何內容。 除非您要求，否則不會刪除任何檔案或將其移出預定流程（例如從 inbox 移至 archive。）
5. 區分事實、承諾與想法。 已完成的事、您對某人做出的承諾、以及您正在考慮的事情，是三種不同的狀態。Claude 的建議絕不會被呈現為一項承諾。
6. 保留來源。 每個重要行都應指向其來源（檔案、日期）。

核對清單

• claude 在 brain 資料夾中啟動，並讀取 CLAUDE.md。
• 步驟 2 的七個問題都已得到回答，且摘要已獲確認。
• 步驟 3 中的資料夾已存在，且無任何檔案以人名命名。
• 日誌、決策記錄與時間軸在 CLAUDE.md 中被宣告為「僅新增」。
• 新鮮度規則與「一個事實，一個檔案」規則已包含在 CLAUDE.md 中。
• inbox-ingestion 代理與 /inbox 命令出現在 /agents 清單與命令清單中。
• 已成功完成首次測試：提議、驗證、寫入、歸檔、在 CHANGELOG.md 中記錄。
• python3 scripts/build_views.py 執行無誤並產生視圖。
• 步驟 7 的四個常規流程已記錄在您會查看的地方。
• 步驟 9 的安全規則已複製到 CLAUDE.md 中。

技能檔案

檔案	內容
references/structure.md	建議的目錄結構與每個資料夾的角色
references/ingestion-rules.md	攝取規則，包含前後範例
references/inbox-processing.md	處理收件匣中檔案的協定，包含完整範例
references/agents.md	六個代理的目錄
references/use-cases.md	七個使用情境
references/templates/	可複製的範本（指令、任務板、記錄、日誌、主題卡片、代理、命令）
references/scripts/build_views.py	視圖生成腳本
references/example-acme/	一個完整且虛構的範例 brain