theta-spec：一個謙遜的、與框架無關的AI智慧體配置規範
theta-spec 是一個宣告式的、與任何AI編碼智慧體框架無關的配置標準。它透過一個單一的 theta.toml 檔案定義完整的配置表面（指令、規則、工具、技能、子智慧體），並規定了配置檔案的宣告週期協議。任何符合規範的實現都可以解析、鎖定並將配置轉換為任何支援的框架。該專案還提供了參考實現 theta CLI（Rust 編寫）。
文章情報
要點
- theta-spec 提供統一的配置格式，解決不同AI智慧體框架配置不相容的問題。
- 支援 Claude Code、Codex CLI、Cursor 3+、GitHub Copilot 等主流框架。
- 包含 Rust 編寫的參考實現 theta CLI，可解析、鎖定和轉換配置。
- 專案旨在簡化配置管理、實現可復現的智慧體配置。
為什麼重要
這條新聞值得關注，因為theta-spec 提供統一的配置格式，解決不同AI智慧體框架配置不相容的問題。
技術影響
可能影響模型選型、推理成本、產品能力和評測基準。
近日，開源專案 theta-spec 在 Hacker News 上引起了關注。該專案定義了一個宣告式的、與具體 AI 編碼智慧體框架無關的配置標準。它的核心思想是：用一個單一的 theta.toml 檔案來完整描述一個 AI 智慧體的所有配置，包括系統指令、規則、工具、技能以及子智慧體。這樣做的好處是顯而易見的——開發者不再需要為每個不同的智慧體框架（如 Claude Code、Codex CLI、Cursor、GitHub Copilot 等）分別編寫和維護不同的配置檔案。
theta-spec 不僅定義了配置檔案的格式，還規定了其生命週期協議。任何符合該規範的實現都可以將 theta.toml 解析為一個標準化的中間表示，然後根據目標框架“投射”出對應的配置檔案。這一過程使得智慧體的配置變得可版本控制、可復現、可共享。
作為參考實現，專案提供了 theta CLI，一個用 Rust 編寫的命令列工具。它能夠解析 theta.toml 檔案，將其中引用的外部檔案（如指令、規則等）鎖定為具體版本，並最終生成目標框架所需的配置檔案。
專案的動機來自對現有生態的觀察：各種智慧體框架都在快速發展，但它們各自為政，配置格式各不相同。開發者需要付出額外的努力來維護和同步這些配置。theta-spec 試圖透過引數化配置表面，將所有這些配置統一到一個清單中，從而提供全景檢視、便於搜尋、實現可復現性、顯式化變更策略、簡化跨框架維護，併為未來的工具鏈（如配置最佳化）奠定基礎。
一個典型的 theta.toml 檔案看起來像這樣：指定模式版本、智慧體名稱、描述、模型、系統指令路徑、規則（可帶檔案匹配模式）、MCP 工具命令、技能路徑、以及子智慧體定義（可內聯或引用外部檔案）。
目前，theta-spec 已經支援 Claude Code、Codex CLI、Cursor（3.0 及以上）和 GitHub Copilot 等智慧體框架。專案的優先順序基於對這些框架的市場普及度的研究。此外，專案還提供了詳細的文件，包括如何貢獻、提出規範變更、請求新框架支援等。
總之，theta-spec 是一個旨在為 AI 智慧體配置帶來標準化和互操作性的專案。它仍處於早期階段（GitHub 上僅有 4 星），但它所解決的問題 —— 多框架下的配置碎片化 —— 確實是一個值得關注的痛點。隨著 AI 智慧體工具的發展，這種標準化努力可能會變得越來越重要。