ObjectOSIDE Skills（Claude Code / Cursor / Copilot）
把 ObjectOS Skills 安装进你的编码 Agent，让 Claude Code、Cursor、Copilot、Codex 等知道如何正确编写 ObjectOS 元数据。
IDE Skills
AI Builder 跑在 Console 内，跟你租户的数据库对话。但有时你希望同样的领域知识出现在 IDE 里 —— 当你手工编辑 *.object.ts、设计流程，或让 Cursor 写一个 CEL 谓词时。
ObjectOS 提供 9 个一方 Agent Skill，教编码助手如何编写各类 ObjectOS 元数据。它们通过开放的 skills 生态（Vercel Labs）分发，兼容 Claude Code、Cursor、Copilot、Codex、Gemini CLI、Windsurf、Cline、Continue、Roo、Goose、Kiro、opencode 及 ~50 个其它 Agent。
安装
在任何使用 @objectstack/* 包的项目里：
npx skills add objectstack-ai/frameworkCLI 会检测你配置了哪些 Agent（.claude/、.cursor/、.github/copilot/、AGENTS.md 等），并把 Skill 写到正确位置。随时重跑可拉取最新版本。
不改
package.json，不做全局安装。Skill 是被提交进仓库的纯 Markdown —— 整个团队（包括 CI Agent）共享同一份指令。
你拿到什么
| Skill | 何时加载 |
|---|---|
objectstack-platform | defineStack、Driver、Adapter、插件、服务、os CLI、部署 |
objectstack-data | *.object.ts、*.seed.ts、字段、关系、校验、索引、生命周期 Hook、RLS |
objectstack-query | ObjectQL —— 过滤、排序、分页、聚合、Join、窗口函数、全文搜索 |
objectstack-ui | View、App、Page、Dashboard、Report、Chart、Action |
objectstack-automation | Flow、Workflow、Trigger、审批、调度、Webhook |
objectstack-ai | Agent、Tool、Skill、对话、Model Registry、MCP |
objectstack-api | REST/GraphQL 端点、认证、实时、错误信封 |
objectstack-i18n | 翻译包、locale 回退、覆盖率 |
objectstack-formula | CEL 表达式 —— 公式字段、校验/共享/可见性谓词、条件 |
每个 Skill 作用域感知 —— 它告诉 Agent 何时加载自己、何时让位给兄弟 Skill，这样 Claude 就不会用 platform Skill 去建模对象、或用 data Skill 写 CEL 表达式。
工作原理
每个 Skill 是 framework 仓库 skills/ 下的一个文件夹：
skills/objectstack-data/
├── SKILL.md # YAML frontmatter + 散文指南
├── references/
│ └── _index.md # 指向 @objectstack/spec Zod 源码
└── rules/ # 可选的深入规则SKILL.md 的 frontmatter 就是 skills add 读取的内容，用以把 Skill 路由到正确的 Agent 表面：
---
name: objectstack-data
description: Design ObjectStack data schemas — objects, fields, ...
license: Apache-2.0
compatibility: Requires @objectstack/spec Zod schemas (v4+)
metadata:
domain: data
tags: object, field, validation, relationship, hook, permission, rls
---所有 Skill 共享一条核心规则：@objectstack/spec 里的 Zod schema 才是真理。Skill 给出意图;Agent 读 node_modules/@objectstack/spec/src/**/*.zod.ts 里的 schema 获得精确字段形态。这就是为什么装上 Skill 后幻觉字段几乎消失。
Skills 与 AI Builder
| AI Builder | IDE Skills | |
|---|---|---|
| 在哪运行 | Console（浏览器） | 你的 IDE / 编码 Agent |
| 改的是什么 | 你租户里的实时元数据 | 你仓库里的文件 |
| 代表谁 | 你的终端用户/管理员 | 你的开发者 |
| 审批模型 | HITL 队列（ai:approve） | Pull Request 评审 |
| 最适合 | 日常扩展、无代码用户 | 模板、包、复杂流程、库代码 |
两者互补。多数团队用 AI Builder 做租户定制，用 IDE Skill 做打算发布的包（见 Templates 和 Marketplace）。
升级
Skill 跟随 @objectstack/spec 版本。升级 spec 包后重跑 npx skills add objectstack-ai/framework，可让你的 Agent 与最新的 Zod schema、CEL 辅助函数、元数据词汇保持同步。
相关
- AI Builder —— Console 内的对应物
- Agents —— 声明跑在 ObjectOS 内 的服务端 Agent
- Templates —— 每个官方模板都带着这些 Skill 构建