與 Agent 合作

OpenPress 的核心創新在於：它是一個打從第一天起就為 AI Agent 所設計的文件框架。理解「與 Agent 合作」背後的哲學，有助於您更有效地引導 AI 產出高品質的結果。

Agent 與框架的職責劃分

在傳統工具中，人類使用者必須包辦從內容構思到排版微調的所有工作。在 OpenPress 中，我們建立了一個清晰的契約，區分了框架（Framework）、Agent（Skills）與原始碼的責任歸屬。

框架（引擎）的被動性

OpenPress 引擎本身是極度被動的。它不理解何謂「美感」，不具備「說故事」的能力，也不包含任何特定領域的商業邏輯。它的職責是純粹機械性的：解析元件樹、處理排版演算法、驗證結構正確性，並產生最終的靜態產物。這種被動性確保了引擎的穩定性與通用性。

Agent（Skills）的主動性

相對地，Agent 是充滿觀點與主動性的。透過不同的「技能（Skills）」，Agent 可以扮演文案指導、視覺設計師或是技術文件專家。它們負責理解使用者的意圖、選擇合適的版面配置、產生內容，並做出關於排版與品味的決策。

唯一的真實來源：工作區原始碼

當 Agent 為您建立或修改文件時，所有變更都必須發生在工作區的「原始碼」層級。這是 OpenPress 設計中不可妥協的原則。

為什麼不能直接修改輸出結果？ 如果 Agent 繞過原始碼，直接去修改編譯後的 HTML 或排版完成的 PDF，這些修改將是脆弱且不可重現的。當文件需要再次更新時，這些直接針對輸出的修改就會遺失。

透過強制 Agent 只編輯原始碼（如 MDX 內容、React 元件或 CSS 代幣），我們確保了文件的每一點修改都是宣告式的、可被版本控制追蹤的，並且能夠被引擎可靠地重新編譯。

驗證迴圈的意義

一個稱職的 Agent 在修改完程式碼後不應該直接停止。OpenPress 提供了一系列的驗證工具（從型別檢查到本機預覽），這構成了一個封閉的「驗證迴圈」。

這個迴圈的存在，是為了讓 Agent 具備「自我修正」的能力。在向使用者展示最終結果之前，Agent 必須透過這些工具來驗證其修改是否符合框架的結構規範、是否會導致編譯失敗。這種機制大幅降低了使用者的審閱負擔，確保了交付品質。

產品邊界的尊重

儘管 Agent 能力強大，但 OpenPress 制定了嚴格的邊界（Hard Stops）。Agent 被限制在文件創作的範疇內，它們不能隨意修改框架的底層程式碼、不能憑空捏造業務數據，更不能在沒有明確授權的情況下將內容發佈到公開的正式環境。這些邊界是為了在自動化與安全性之間取得完美的平衡。