知識ベースのパッケージには、構造だけでなく業務記録、Skill指示、AirAppコードも入ります。正式になる時点は、Agentの次の読取と実行に影響します。
何を入れるかに加えて、どう受け入れるかを決めます。構造作成、即時マージ、審査待ちは別の結果です。ディレクトリが現れる前に受入方式を選びます。
構造とコンテンツでは反映方法が違う
Busabaseのpackageは、Gitリポジトリのbusabase.jsonとcontent/ツリーでリソースを表します。公式のインストール手順では、Folder、Base、フィールド、ビューは直ちに作成されます。レコード、Doc、Skill、AirAppなどの内容は、書き込み権限があればデフォルトで直接マージされます。
先に内容を確認する場合は、画面で Send the content for review first を選ぶか、CLIで--require-reviewを指定します。内容はChangeRequestに残りますが、構造の作成は延期されません。新しいBaseが見え、Inboxに審査待ちがある状態は両立します。
したがって、ツリーが増えたことだけで全内容が承認済みとは判断できません。逆に、審査を指定しないインストールを一時保管と考えることもできません。
実際の参照元と作成予定を見る
画面の Install from GitHub… では、インストール前にサーバーが生成したプレビューを確認します。パッケージの情報、解決されたリポジトリとref、構成、件数、名前の衝突、警告が表示されます。配置先を変えたら、衝突条件が変わるため新しいプレビューを読み直します。
リポジトリとrefを記録します。デフォルトブランチは取得時点の内容です。同じソースを後から確実に確認したい場合は、特定のcommit SHAを使います。Skillやアプリを含む場合は、名前だけでなく指示やコードのファイルを開きます。
Baseのslugはスペース内、ノードのslugはフォルダー内で一意です。重複をリネームして導入すると、接尾辞の付いた別リソースが作られ、関係も新しいBaseへ書き換えられます。既存業務データを自動で新版に更新する操作とは異なるため、別セットを作る目的かを確認します。
審査を選べない場合とサンプルの扱い
通常のpackageでレコード間の関係値が設定されている場合、実際のIDを得るためインストール中のマージが必要です。この場合--require-reviewは使えず、画面も直接導入が必要だと説明します。空の関係フィールドを定義しただけでは、この制限は生じません。
直接受け入れる判断ができない場合は、導入を止めて範囲を見直すか、提供者に個別確認しやすい内容を依頼します。先へ進むために審査を外すこと自体が受け入れの判断です。
テンプレートのサンプル行は別扱いで、デフォルトではマージされます。CLIでサンプルも審査に回したい場合は--no-sample-recordsを併用します。アプリの内容とサンプルの両方を確認対象にします。
導入前の確認を一枚に残す
既存のタスクBase、または一度の作業ならDocを使い、参照元とref、配置先、リソース範囲、コードや指示、衝突の処理、内容の審査設定、サンプルの扱い、警告を残します。該当ファイルへのリンクも添えると、次の担当者が同じ材料を確認できます。
接続済みAgentへの依頼例です。
このプレビューとパッケージのファイルを読み、参照元、作成範囲、指示やコード、名前の衝突、審査設定、警告の確認表を作ってください。該当ファイルへリンクし、分析結果だけを返してください。インストール、スペースの変更、提案の承認は行いません。
この整理は権限の代わりにはなりません。画面のプレビューと導入にはスペースの書き込み権限が必要で、CLIにも対象リソースへの書き込み権限が必要です。
受入方式と認証権限を合わせて決める
先に審査したいなら導入時に経路を選び、認証権限を確認します。構造作成と内容マージは別で、どの記録や指示が正式入力になったかを把握します。
導入後も構造と内容を別々に読みます。正式値は本文、関係、出所、待審はInboxの差分を確認します。サンプルや関係の例外も文書に従い、一つの成功表示で全対象を済ませません。
導入後は二段階で照合する
まずFolder、Base、フィールド、ビューと名前をプレビューに照合します。次に内容の状態を確認します。直接マージした場合は実際のレコードとファイルを開き、審査を選んだ場合は対応するChangeRequestの差分を確認します。待ち件数が表示されたらInboxで判断し、未受け入れの内容をすぐ業務の根拠にしないようにします。
警告も確認します。packageは権限、変更履歴、Vault secrets、webhook rulesを含まず、添付フィールドの値も運びません。ファイルのアップロードはホストのストレージ条件にも左右されます。スペース全体を履歴やファイルとともに戻す目的なら、バックアップと復元を選びます。
参照元、範囲、受け入れ方法、実際の結果が残れば、作成済みの構造、正式な内容、残る判断を引き継ぎ先が区別できます。