構築

IDE スキル(Claude Code / Cursor / Copilot)

ObjectStack のスキルをインストールすると、Claude Code、Cursor、Copilot、Codex などのコーディングエージェントが、正しい ObjectStack メタデータ(ObjectOS が実行するオントロジー)を作成できるようになります。

対応エディション

AI Builder は ObjectOS の中にあり、テナントのデータベースと対話します。しかし、*.object.ts を手で編集しているとき、フローを設計しているとき、Cursor に CEL の述語を書かせるときなど、同じドメイン知識を IDE の中で使いたいこともあります。

ObjectStack には、コーディングアシスタントにあらゆる種類の ObjectStack メタデータ(ObjectOS が実行するオントロジー)の作成方法を教える 9 つのファーストパーティのエージェントスキルが付属します。これらはオープンな skills エコシステム(Vercel Labs)を通じて配布され、Claude Code、Cursor、Copilot、Codex、Gemini CLI、Windsurf、Cline、Continue、Roo、Goose、Kiro、opencode をはじめとする約 50 のエージェントで動作します。

インストール

@objectstack/* パッケージを使う任意のプロジェクトで:

npx skills add objectstack-ai/objectstack/skills

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

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

得られるもの

スキル読み込むのは、次の作業をしているとき
objectstack-platformdefineStack、ドライバー、アダプター、プラグイン、サービス、os CLI、デプロイ
objectstack-data*.object.ts、*.seed.ts、フィールド、リレーションシップ、検証、インデックス、ライフサイクルフック、RLS
objectstack-queryObjectQL:フィルター、ソート、ページネーション、集計、結合、ウィンドウ関数、全文検索
objectstack-uiビュー、アプリ、ページ、ダッシュボード、レポート、グラフ、アクション
objectstack-automationフロー、ワークフロー、トリガー、承認、スケジュール、Webhook
objectstack-aiエージェント、ツール、スキル、会話、モデルレジストリ、MCP
objectstack-apiREST エンドポイント、認証プロバイダー、リアルタイムチャネル、エラーエンベロープ、バッチ/バージョニングの契約
objectstack-i18n翻訳バンドル、ロケールのフォールバック、カバレッジ
objectstack-formulaCEL 式:数式フィールド、検証/共有/表示の述語、条件

各スキルはスコープを認識しています。いつ自分を読み込み、いつ兄弟スキルに任せるべきかをエージェントに伝えるので、Claude がプラットフォームのスキルでオブジェクトをモデル化しようとしたり、データのスキルで CEL 式を書こうとしたりすることはありません。

仕組み

各スキルはフレームワークのリポジトリの 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 のフロントマターは、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 のスキーマから読み取ります。スキルをインストールすると、でっち上げのフィールドが事実上なくなるのはこのためです。

スキルと AI Builder の比較

AI BuilderIDE スキル
実行場所ブラウザIDE / コーディングエージェント
変更するものテナント内の稼働中のメタデータリポジトリ内のファイル
誰の代わりに動くかエンドユーザー / 管理者開発者
承認モデルHITL キュー(ai:approve)プルリクエストのレビュー
最適な用途日々の拡張、ノーコードのユーザーテンプレート、パッケージ、複雑なフロー、ライブラリのコード

両者は補完し合います。ほとんどのチームは、テナントのカスタマイズには AI Builder を、公開するつもりのパッケージの作業には IDE スキルを使います(テンプレートとマーケットプレイスを参照してください)。

更新

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

  • AI Builder:ブラウザ内の対になるもの
  • エージェント:ObjectOS の中で実行されるサーバー側のエージェントを宣言する
  • テンプレート:公式テンプレートはすべて、これらのスキルを読み込んで構築されています