Context Hub 介紹 — SuperPortia
當工作開始跨越多個 repo、工具和操作平台時,真正的瓶頸就不再是程式碼生成了。
而是上下文的連續性。
文件不只是存檔
在較小的專案中,人們通常把文件視為被動的記錄。在 Agentic 系統中,這遠遠不夠。上下文必須作為基礎設施來運作:
- 它減少重複解釋
- 它讓決策保持清晰可讀
- 它把修正轉化為可重用的模式
沒有這一層,每個新 session 都像局部失憶一樣運作。
為什麼這對單人操作員如此重要
一個人加多個代理的公司,不會因為假裝記憶是免費的而變得更簡單,反而會變得更脆弱。
這就是為什麼 Context Hub 的思維在 SuperPortia 內部如此重要。它不是為了讓筆記更漂亮,而是要確保重要的推理能夠跨越工具、中斷和介面變化而存活。
上下文的三個層次
SuperPortia 的 Context Hub 基礎設施跨越三個層次:
第一層 — 即時(session 上下文):在 session 開始時載入的 CLAUDE.md、規則和技能。這讓任何代理在無需重新解釋的情況下,就能掌握當前的操作規範。
第二層 — 情節性(Universal Brain):每個決策、修正、研究發現和 session 交接都存儲在 UB 中。可搜尋、可標記、永久保存。
第三層 — 結構性(Obsidian Vault):長篇推理——專案 MOC、架構筆記、概念地圖。Vault 是讓意義被組織的地方,而不只是被儲存。
Universal Brain 功能對比
| 功能 | 傳統筆記工具 | Universal Brain(UB) |
|---|---|---|
| 搜尋方式 | 關鍵字全文搜尋 | 向量語義搜尋(Gemini Embedding) |
| 跨 agent 共享 | 手動複製貼上 | 所有 agent 共用同一個 API |
| 知識分類 | 手動資料夾 | MTAAA 三維自動分類(Topic / Type / Lifecycle) |
| Session 交接 | 零,全靠記憶 | ingest_fragment + session-handoff tag |
| 搜尋語言 | 依輸入語言 | 中英文查詢品質相當(Gemini Embedding 不偏向英文) |
搜尋 UB 的程式碼範例
# 搜尋 UB 中的決策記錄(MCP 工具呼叫)
search_brain("orchestrator dispatch decision")
# 透過 curl 直接查詢(用於 agent 外部腳本)
curl -X POST https://ub.superportia.dev/brain/search \
-H "Authorization: Bearer $UB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "context hub architecture", "limit": 5}'
任何技術決策前,先搜 UB(search_brain)確認有無前例。UB 是 SuperPortia 自己累積的知識,比 Web 搜尋結果更貼近實際情況和已驗證的決策。
寫好一條 UB entry 需要時間,但若跳過這步,下一個 session 的 agent 會重新研究已決定的事情、提出已被否決的方案,浪費的 token 遠超過寫 entry 的成本。這是有記錄的失敗模式,不是假設。
沒有它會發生什麼
這個失敗模式在 SuperPortia 自身的歷史中有充分記錄。當一個新的 session 代理在沒有足夠上下文的情況下開始時:
- 它重新研究已經決定的事情
- 它提出已經被否決的方案
- 它詢問已經被回答的問題
- 它忽略來之不易的約束條件
每一個都在浪費時間和 token 預算。Context Hub 就是防禦。
實際意涵
上下文不是免費的。寫好的 UB 條目、維護準確的 MEMORY.md、保持 Vault 筆記更新——這些都需要真實的工作。但回報是複利的:每個記錄良好的決策都可以在未來的 session、代理,甚至未來的部落格文章中重用。
這才是真正的重點。不是為了自動化而自動化。而是一個不斷複利的學習系統。
也參考 SuperPortia Project Landscape — 29 Projects, 3 Dimensions,了解完整的專案全景。
...公司運作的根本邏輯,改憲法——每一層改動都有對應的影響範圍。 SuperPortia 用 EGS 管理 AI 代理團隊的方式,本質上和管理人類工程師沒有太大不同:需要書面規範、需要版本控制、需要執行機制、需要從事故中學習並更新規範。 差別在於,代理沒有情境記憶,所以每一條規則都必須是顯式的,不能靠「你懂的」。這反而逼出了一套比很多人類工程團隊更清晰的規範文化。 也可以參考 [[Context Hub 介紹]]