跳到主要內容

Anthropic 的秘密與 Peter 的實作:當「靈魂文檔(Soul Doc)」從概念變成了可編輯的 Markdown

這一套以 SOUL.md、HEARTBEAT.md 為核心的檔案架構並不是偶然。

在前一篇文章中提到 OpenClaw prompt 和 md 的解析,而是採用了許多前人的累積與邏輯上把 AI 的「意識」與「記憶」封裝成人類可讀的 Markdown 檔案,初看覺得這種 Unix 哲學的「Everything is a file」很優雅,但實際思考這套系統要跑在生產環境時,體感上出現了一些有趣的摩擦點。

核心是把複雜的向量資料庫(Vector DB)還原成最原始的文字檔。

■ 狀態同步的 Technical Debt:當 Agent 運作頻率變高,頻繁讀寫 Markdown 造成的 IO 競爭與檔案鎖定,在多 Agent 協作時可能變成系統瓶頸。

■ 記憶碎片的清理機制:雖然借鏡了史丹佛的記憶流理論,但現實中長期精華(MEMORY.md)的摘要演算法如果沒寫好,檔案體積膨脹後的 Context Window 成本與遺忘曲線會變得很難調校。

■ 「心跳」的邊際成本:透過 Cron Job 定時讀取 HEARTBEAT.md 讓 Agent 自發行動,這在 0 到 1 的 Side Project 很浪漫,但到了需要規模化的擴張期,這種「主動式」消耗的 Token 成本與實質產出比,目前還看不太出回報率。

同時有朋友提到的 https://soul.md/ 網站,確實很容易讓人誤以為這是一個獨立於 OpenClaw 之外的原始出處。

經過仔細查證,這其實是一個**「概念致敬」與「工程實作」的結合體**。簡單來說:概念來自 Anthropic 的內部洩漏,但你看到的這套 Markdown 檔案架構(SOUL.md 等),確實是 OpenClaw (Peter Steinberger) 的原創發明。

這裡幫你釐清這三者錯綜複雜的關係:
https://soul.md/ 這個網站就是 OpenClaw 的作者 Peter Steinberger 建立的。

如果你看該網頁的最底部,署名是:
Written by Clawd 🦞 ... The original soul document Clawd's instructions @steipete

所以這個網站並不是 OpenClaw 的「前身」或「參考來源」,而是作者為了闡述 OpenClaw 「為什麼要設計 SOUL.md 這個檔案」 所寫的哲學宣言(Manifesto)。

網站開頭提到的:「In December 2025, researchers discovered that Claude... could partially reconstruct an internal document...」

這段話引用的是真實發生的 AI 圈大事件(被稱為 The Claude "Soul Doc" Leak):

事件背景:2025 年底(現實時間線),有研究者(如 Richard Weiss)發現可以透過特定誘導,讓 Claude 吐出它內建的隱藏指令(System Prompt / Constitution)。

術語由來:

Anthropic 的研究員 Amanda Askell 曾在討論中承認,他們內部非正式地將這份塑造 Claude 性格的核心文件稱為 "Soul CoC" (Soul Chain of Command) 或 "Soul Document"。

Peter Steinberger 覺得這個概念太酷了,所以他做了一個工程上的決定:致敬概念:既然 Claude 的靈魂是一份文件,那就在我的 Agent 架構裡,直接建立一個名叫 SOUL.md 的檔案。

他把原本藏在模型權重裡的抽象概念,變成了可以編輯的 Markdown 檔案。架構定型:為了配合這個靈魂檔,他才發展出了你現在看到的整套體系:
  • SOUL.md:性格與自我認知(致敬 Anthropic 的 Soul Doc)。
  • AGENTS.md:行為準則(操作手冊)。
  • HEARTBEAT.md:生理時鐘(主動性機制)。
這點在處理「Local-First」的小型專案或個人助理時特別有感,有一種把 AI 關進籠子裡、隨時可以進去 Debug 性格的掌控感。

或許這種架構追求的不是效能極大化,而是「可解釋性」的極致

但我好奇的是,當專案複雜度提升到需要處理萬等級的狀態變更時,這種「文字檔靈魂」還能撐多久??? 也就是當這樣的模式如果用了 100 人團隊採用超過 180 天之後,會如何維運?

你們會選擇繼續擁抱向量資料庫,還是回歸這種純文字的浪漫?

留言

這個網誌中的熱門文章

Vibe Coding:到底?氛圍驅動程式開發必殺技?

Vibe Coding(氛圍編程) 是由 OpenAI 共同創辦人 Andrej Karpathy 在 2025 年提出的革命性程式開發方式,它讓開發者透過自然語言與 AI 對話來生成程式碼,徹底改變了傳統的編程模式。 這種開發方式的核心理念是 「順著感覺走」 ,讓 AI 處理技術細節,開發者專注於創意和需求描述。 Vibe Coding 需要基本上的規劃和執行,但並沒有強制規範,從日常經驗來說可分為三個階段, 前期準備、開發過程、和後期維護 三個關鍵階段。每個階段都有其特定的任務和注意事項,正確執行這些步驟將大幅提升開發效率和程式品質。 將靈感與需求透過 AI 快速轉化成產品功能或原型。以下幫你分成 「前、中、後」 三階段要做的事情,適合你自己做、或帶團隊做 前期:設定 vibe & 準備素材 這個階段的重點是 「建立開發語境」 ,因為 AI 的生成表現高度依賴前期提供的上下文與資料。 明確目標 :釐清要解決的問題、預期要做的功能與核心價值。例如在筆記軟體的情境中,可能是:「我要做一款讓使用者能用 Markdown 記錄筆記,並提供標籤與全文搜尋功能的簡單 App。」 收集靈感 :觀察同類產品(如 Obsidian、Notion)、蒐集市場痛點(例如太多筆記軟體無法脫機使用,或同步效能差)。 建立語境 :準備初步 prompt、背景知識、產品定位、品牌調性、目標使用者輪廓等。 確認資源 :決定用哪些工具(Gemini、ChatGPT、設計軟體、流程管理工具等)。 確認完上述內容之後,就可以先開始進行準備規格,進行第一次的 Vibe Coding 方向驗證 提示詞模板準備 很多人會跳過這步驟,但一份 「好的 AI 提示詞模板」 將決定接下來每一次 AI 對話的品質。有效的提示詞模板需具備: 描述具體且無歧義 包含技術要求和約束條件 提供範例資料和測試案例 指定程式碼風格和慣例 例如針對筆記軟體的案例:   「建立一個支援 AI 功能純文字筆記,輸入內容可即時渲染;需支援儲存到本地檔案,提供標籤欄位做分類;以 React 架構,程式風格採用 Tailwind style components 並使用 hooks。」 開發工具選擇 開發工具的選擇 同樣重要,目前市場上主要的 ...

Claude Code Hooks:自動化與安全的最佳實踐

寫在最前頭,這份文章主要寫起來是給自己看, 同時內容是比較適合開發者,工程師們可以做些自動化處理的簡單筆記。 Claude Code hooks Claude Code hooks 是一種強大的自動化機制,允許用戶在 Claude Code 的不同生命週期階段,自定義執行 shell 指令。這種設計讓開發者能夠將規則和自動化行為嵌入到應用層級,確保每次都能可靠執行,而不必依賴 LLM(大型語言模型)是否會選擇執行某項操作。 Hooks 的核心用途 通知 :自訂收到 Claude Code 等待用戶輸入或執行權限時的提醒方式。 自動格式化 :如在每次檔案編輯後自動執行 prettier (針對 .ts 檔)、 gofmt (針對 .go 檔)等。 日誌記錄 :追蹤所有執行過的命令,便於合規或除錯。 自動反饋 :當 Claude Code 產生不符合團隊規範的程式碼時,自動給出反饋。 自訂權限 :阻擋對生產環境檔案或敏感目錄的修改[^1]。 配置與結構 Hooks 透過設定檔進行配置,分為全域( ~/.claude/settings.json )、專案( .claude/settings.json )、本地專案( .claude/settings.local.json )以及企業級策略設定。每個 hook 由「事件名稱」和「匹配器」組成: "hooks": { "PreToolUse": [ { "matcher": "Bash", "hooks": [ { "type": "command", "command": "jq -r '...'" } ] } ] } matcher :用於匹配工具名稱(支援正則表達式),如 Write 、 Edit|Write 、 Notebook.* 。 hooks :當匹配時要執行的命令陣列。 type :目前僅支援 "command" 。 ...

[CSS] z-index 在不同瀏覽器繼承問題

今天會討論到這個課題,是因為要實做一個Popup dialog,所以我們希望的結果如下圖。 可是在IE7 卻發生了這樣的情況。 Popup不論怎麼設定z-index都無法浮在最上層,我們看一下html架構發生什麼事情。