IDE スキル

AI Builder は Console の内部に存在し、テナントの データベースとやり取りします。しかし、IDE の中で同じドメイン知識が 欲しい場面もあります。たとえば *.object.ts を手作業で編集したり、 フローを設計したり、Cursor に CEL 述語を書かせたりするときです。

ObjectOS は 9 個のファーストパーティ製エージェントスキル を提供しており、 あらゆる種類の ObjectOS メタデータの作成方法をコーディングアシスタントに教えます。 これらはオープンな skills エコシステム (Vercel Labs) を通じて配布され、Claude Code、Cursor、Copilot、 Codex、Gemini CLI、Windsurf、Cline、Continue、Roo、Goose、Kiro、 opencode およびその他約 50 種類のエージェントで動作します。

インストール

@objectstack/* パッケージを使用しているプロジェクトであればどこでも:

npx skills add objectstack-ai/framework

CLI は構成済みのエージェント (.claude/、.cursor/、.github/copilot/、 AGENTS.md など) を検出し、スキルを適切な場所に書き込みます。 最新バージョンを取得するには、いつでも再実行してください。

package.json の変更も、グローバルインストールも不要です。スキルは リポジトリにコミットされるプレーンな Markdown ファイルなので、チーム全体 — そして CI エージェント — が同じ指示を共有できます。

得られるもの

各スキルは スコープを認識 しており、いつ自身を読み込み、いつ兄弟スキルに 委譲すべきかをエージェントに伝えます。そのため Claude が platform スキルで オブジェクトをモデリングしようとしたり、data スキルで CEL 式を書こうとしたりすることはありません。

仕組み

すべてのスキルは framework リポジトリ の skills/ 配下にあるフォルダーです:

skills/objectstack-data/
├── SKILL.md              # YAML frontmatter + prose guide
├── references/
│   └── _index.md         # pointers into @objectstack/spec Zod sources
└── rules/                # optional deep-dive rules

SKILL.md の frontmatter は、skills add がスキルを適切なエージェント サーフェスへルーティングするために読み取るものです:

---
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
---

すべてのスキルに共通する中核的なルール: @objectstack/spec 内の Zod スキーマが真実です。スキルは意図を与え、エージェントは正確なフィールドの 形状を得るために node_modules/@objectstack/spec/src/**/*.zod.ts の スキーマを読み取ります。これが、スキルをインストールすると幻覚的な フィールドが事実上消える理由です。

スキル vs. AI Builder

両者は補完的な関係です。多くのチームは、テナントのカスタマイズには AI Builder を使い、公開を意図したパッケージ を扱う際には IDE スキルを 使います (Templates と Marketplace を参照)。

更新

スキルは @objectstack/spec のバージョンに追従します。spec パッケージを アップグレードした後に npx skills add objectstack-ai/framework を再実行して、 エージェントを最新の Zod スキーマ、CEL ヘルパー、メタデータ語彙と 同期させてください。

関連項目

• AI Builder — Console 内のカウンターパート
• Agents — ObjectOS の 内部 で実行されるサーバーサイドエージェントを宣言する
• Templates — すべての公式テンプレートはこれらのスキルを読み込んで構築されている