appdb-collection-create

AppDB コレクション作成（CLI）

アプリで新しい AppDB ストレージが必要で、CLI からデータストアとコレクションを一度の操作で作成できる場合に、このスキルを使用します。

目的

このスキルでは、ストレージの初期化ライフサイクルを扱います。

• 必要なデータストアを作成する
• そのデータストア内にコレクションを作成する
• 作成された識別子を記録する
• 後続のマニフェストマッピングとドキュメント書き込みの使用に備える

コレクションの作成後にドキュメントの CRUD 操作を行う場合は、~/.agents/skills/appdb/SKILL.md を使用してください。

想定する CLI の動作

community-domo-cli に次のコマンドが含まれていることを前提とします。

• appdb collection-create

この操作では、必要に応じてデータストアも自動的にプロビジョニングされます。

主な実行方法

CLI を優先してください。

community-domo-cli --instance <instance> appdb collection-create --body-file collection.json

CLI を利用できない環境では、直接エンドポイントを使用するワークフローに切り替えます。

• POST /api/datastores/v1（データストアを作成）
• POST /api/datastores/v1/{datastoreId}/collections（コレクションを作成）

必須の入力仕様

少なくとも次の内容を含むボディを使用してください。

• コレクションの name
• コレクションの schema.columns
• 任意の syncEnabled

例：

{
  "name": "TasksCollection",
  "schema": {
    "columns": [
      { "name": "title", "type": "STRING" },
      { "name": "status", "type": "STRING" }
    ]
  },
  "syncEnabled": true
}

出力要件

次の値を返すか、保存してください。

• datastoreId
• collectionId
• collectionName

これにより、後続のスキルで次の操作が可能になります。

• マニフェストマッピングを設定する
• 新しいコレクションにドキュメントを作成する

マニフェストの後続作業

作成が成功したら、このリポジトリ内のアプリプロジェクトの規約で想定されているコレクションの設定が、アプリのマニフェストに含まれていることを確認してください。

チェックリスト

• アプリで既存コレクションの再利用ではなく、新しい AppDB ストレージが必要
• まず CLI の collection-create パスを使用
• データストアとコレクションの識別子を記録
• マニフェストのコレクションマッピングの後続作業を実施
• ドキュメント CRUD ワークフロー（~/.agents/skills/appdb/SKILL.md）への引き継ぎが明確