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 使用同一开源运行时代为运营。
下一步