Agent 開發指南
別教每個開發者手寫應用。教你的 Agent 目標格式。
ObjectStack 是面向“Agent 編寫、人審閱”設計的開放型別化後設資料目標格式與執行時。完整 CRM 全應用（含 UI）小於 150k tokens，Agent 能在一個上下文裡掌握全域性；Strict TypeScript、Zod schema 與 validation gate 會在無效輸出進入執行時前將其攔下。
- <150k tokens
- 完整 CRM 全應用（含 UI），一個上下文視窗
- <100k tokens
- 物件、流程、許可權與其他業務邏輯
- 約 50k tokens
- 完整 CRM 的 UI 後設資料
Agent 指令
一份好的規則檔案把目標格式寫得明明白白
最重要的開發者產物不是一篇手寫介面的教程，而是一份緊湊、可檢索的指令集：告訴 Agent 該改什麼、不該發明什麼、必須通過哪些 schema，以及如何同時返回可審閱 diff 與“已考慮整個應用”的證明。
When building an ObjectStack app:
1. Model business objects before UI.
2. Write Strict TypeScript metadata that conforms to the published Zod schemas.
3. Prefer metadata definitions over generated application code.
4. Add conservative permissions and expose AI actions only through approved tools.
5. Run the validation gate before proposing deployment.
6. Return a small diff, reviewer checklist, and whole-context proof.工作流
Agent 編寫的開發閉環
閉環刻意保持簡單：給 Agent 完整的當前定義與運營上下文，讓它編輯型別化後設資料，跑 validation gate，然後在部署前由人審閱業務許可權。
1. 提供運營上下文
把業務流程、物件命名、許可權邊界、流程狀態、整合約束與完整的當前定義交給 Agent。完整 CRM 全應用（含 UI）小於 150k tokens，因此可以被整體檢視，無需從碎片裡拼湊。
2. 生成後設資料
Agent 以 Strict TypeScript 編輯物件、檢視、流程、動作、儀表盤、翻譯與工具定義，而不是生成應用膠水程式碼。
3. 通過 validation gate
以 Strict TypeScript 模式編譯，逐項用 Zod schema 校驗定義，再檢查許可權、必填標籤、示例資料、物件查詢與流程流轉。
4. 審閱許可權
人審的是許可權變化：資料訪問、寫權、審批繞行、匯出與 AI 工具暴露。
模式
Agent 應該生成什麼
最好的生成式變更用清晰的業務概念命名，並讓執行時權力保持顯式。
物件與欄位
使用業務命名、關係、校驗、索引與生命週期規則，與真實運營一一對應，並符合已釋出的 Zod schema。
檢視與動作
從物件模型生成列表、表單、看板、儀表盤與動作後設資料，而不是一次性介面。
流程與審批
把流轉與審批閘門顯式定義出來，執行時才能對人和 Agent 一體執行。
Agent 工具
只通過 MCP 暴露有邊界的物件查詢與動作，帶策略檢查和便於審計的命名。
決策面
改什麼、誰來審、跑什麼
| 舊的開發表面 | Agent 編寫的 ObjectStack 表面 | 評審者要問的 |
|---|---|---|
| 控制器程式碼 | 物件動作後設資料 | 誰能呼叫這個動作？ |
| 自定義鑑權檢查 | 物件、行級與欄位級許可權 | 資料許可權發生了什麼變化？ |
| 手搭的介面 | 檢視與表單後設資料 | 這個介面支撐哪條流程？ |
| 臨時拼的 AI 提示詞 | 策略感知的工具契約 | 模型能讀什麼、能改什麼？ |
評審清單
Agent 編寫的 ObjectStack diff 評審清單
- Agent 是否檢視了完整的當前應用，而不是根據碎片猜測缺失狀態？
- 變更是否通過 Strict TypeScript 編譯、Zod schema 校驗與 validation gate？
- 這份 diff 改的是業務許可權，還是隻有呈現？
- 物件與欄位命名是否穩定且貼合領域？
- 讀、寫、匯出與工具的預設值是否保守？
- 敏感動作的審批閘門是否顯式？
- 測試或示例資料能否演示這條流程？
- 未來的 Agent 能否檢索並複用同一個模式？
FAQ
這一頁應該回答的問題
開發者還需要懂 ObjectStack 嗎？
需要，但主要任務變了。人負責設計邊界、審閱 diff、寫測試、維護示例；重複性的後設資料編寫更多交給 Agent。
任何編碼 Agent 都能寫 ObjectStack 嗎？
只要有清晰的文件、示例、規則、測試與完整的當前定義，任何強力編碼 Agent 都能使用這個格式。Strict TypeScript、Zod schema 與 validation gate 會在部署前給出確定性反饋；通過後，同一應用可自託管於 ObjectStack，也可由 ObjectOS 使用同一開源執行時代為運營。
下一步