Cloud Skills

手続き型メモリとスキルアーキテクチャ

Cloud Skills は XMemo におけるユーザー作成の手続き型メモリを提供し、開発者やチームが標準作業手順書（SOP）、ランブック、チェックリスト、再利用可能なプロンプトを永続ストレージに直接保存できるようにします。一度保存されると、サポートされているツール全体で接続されたエージェントが、エージェントごとのインストールや手動のプロンプトコピーを行うことなく、それらを発見、想起、解釈できます。保存された Cloud Skill は、エージェント側の接続ブリッジとして機能するインストール済みの XMemo Skill クライアントランタイム（@xmemo/skill、node scripts/xmemo-skill.mjs）とは異なります。

• Preview 機能: Cloud Skills は現在 Memory Console（#skills）で Preview として提供されています。
• アイデンティティとアセット: 各スキルには一意の skill_id、人間が判読可能なスラッグ、名前、説明、所有者スコープ（Personal または Team）、およびアセットステータス（active または archived）があります。
• 不変のリビジョンチェーン: スキルには SkillRevision スナップショットの追記専用（append-only）シーケンスが含まれます。各リビジョンは revision_id、revision_number、instruction_body、canonical_hash、およびオプションの型付き SkillComponent リソースを保持します。
• サイズ制限: ルート指示本文は 64 KiB UTF-8 に制限されています。1 つのリビジョンには最大 50 個の宣言されたコンポーネントを含めることができ、各コンポーネントは 128 KiB に制限されます。
• コンポーネントリソースタイプ: コンポーネントは、reference、example、template、document、artifact、script を含む明示的なセマンティックタイプを宣言します。

公開ライフサイクルとチームレビュー

Cloud Skill のリビジョンは、本番ワークフローを保護し共同作成をサポートするために、構造化されたライフサイクルを通じて遷移します：

• draft: 公開アクティベーション前の作成およびプライベートステージング中の初期リビジョン状態。
• proposed: Team ワークスペース内で作成されたリビジョンは proposed ステータスに遷移し、チームの所有者または管理者による明示的なレビューとアクティベーションを待機します。
• published: エージェントによる検出およびデフォルトの Level 1 想起の対象となるアクティブなリビジョン。指定されたスラッグに対して一度に published として指定できるリビジョンは 1 つだけです。
• deprecated: 古いリビジョンや置き換えられたリビジョンには deprecated のマークを付けて廃止を示しつつ、過去の再現可能な想起を維持できます。
• Personal と Team の公開の違い: Personal ワークスペースでは、公開意図で保存すると直接 published に遷移します。Team ワークスペースでは、提案された（proposed）リビジョンにより、未レビューの手順変更がエージェントのワークフローを変更するのを防ぎます。

プログレッシブ想起：Level 0、Level 1、Level 2

接続されたエージェントは、未使用のドキュメントで LLM コンテキストウィンドウを飽和させるのを防ぐために、Progressive Recall を使用してオンデマンドでスキルを想起します：

• Level 0（ディスカバリ）: クエリ検索により、完全な指示を読み込むことなく、ユーザータスクに一致する軽量の記述子（slug、name、description）が返されます。
• Level 1（ルート想起）: 指定されたスラッグのスキルルート指示とコンポーネントマニフェストを想起し、デフォルトで公開リビジョンを取得し、最新リビジョンへのフォールバックを備えています。
• Level 2（リソース想起）: 宣言された単一のコンポーネント（チェックリストテンプレートやリファレンススキーマなど）を想起し、リソースの不整合（resource tearing）を防ぐために呼び出し元が明示的な revision_id を指定する必要があります。

recall_cloud_skill(query="incident response")  # Level 0: lightweight descriptors
recall_cloud_skill(slug="incident-response-checklist")  # Level 1: root instructions + manifest
recall_cloud_skill(
  slug="incident-response-checklist",
  revision_id="<revision-id-from-level-1>",
  resource="templates/triage-template.md",
)  # Level 2: one pinned resource component

リビジョンの固定によりリソースの不整合を防ぐ

スキルが更新されると、XMemo は過去のコンテンツを上書きするのではなく、次の不変リビジョンを作成します。Level 1 のルート想起では、不変の revision_id およびコンポーネントマニフェストとともにルート指示が提供されます。Level 2 のリソースリクエストでは、呼び出し元がその正確な revision_id を固定する必要があります。エージェントがワークフローを実行している最中に作成者が新しいリビジョンを公開した場合でも、エージェントの固定された読み取りは開始時とまったく同じスナップショットを解決し続けるため、リソースの不整合が排除されます。

{
  "kind": "root",
  "data": {
    "skill_id": "skill_inc_triage_01",
    "revision_id": "rev_v1_inc_triage",
    "revision_number": 1,
    "canonical_hash": "c7b14d8e9f2a4c10...",
    "resources": [
      {
        "logical_path": "templates/triage-template.md",
        "type": "template",
        "content_hash": "e3b0c44298fc1c14..."
      }
    ]
  }
}

インポート、エクスポート、およびオーサリング環境

開発者は Web コンソールで対話形式で Cloud Skills を作成したり、標準配布パッケージから既存のスキルをインポートしたりできます：

• コンソールでの作成: マークダウンエディタとコンポーネント管理を備えた Memory Console（#skills）で対話的にスキルを作成します。
• パッケージインポート: 標準の SKILL.md ファイル（YAML フロントマター付き）、マルチファイル ZIP アーカイブ、または URL（ClawHub または GitHub）経由のリモートリポジトリをインポートします。
• リビジョン差分比較: 単語レベルの差分比較により、任意の 2 つのリビジョン間で指示の変更とコンポーネントの修正を比較します。
• Source Capsule のエクスポート: 任意のスキルリビジョンを、SKILL.md、コンポーネントリソース、およびメタデータマニフェストを含む可逆の Source Capsule ZIP アーカイブとしてエクスポートします。

エージェントアクセスプロファイルとサンドボックス分離

承認されたエージェントは、サポートされているクライアント環境において、契約上定義された MCP ツールを通じて Cloud Skills にアクセスします：

• 契約上の MCP ツール: ツール recall_cloud_skill（読み取り専用）および save_cloud_skill（作成）は、cursor-plugin および ordinary-full クライアントプロファイル（config/mcp-documentation-contract.json）で契約上公開されています。generic-public、chatgpt-public、claude-code プロファイルには公開されていません。
• プロンプト実行可能な手順: ほとんどの Cloud Skills は、コードを実行することなくプロンプトガイダンスとしてエージェントによって直接解釈される標準作業手順書です。
• サンドボックス実行境界: execute_cloud_skill を介したオプションのバックエンドスクリプト実行は、SandboxExecutionEngine によって管理される高度なサーバー側機能です（現在どのクライアントプロファイルにも公開されていません）。ローカルの bubblewrap コンテナ分離が存在しない場合、実行は SANDBOX_UNAVAILABLE でフェイルクローズします。

提供状況とライフサイクルの境界

アカウントで手続き型 Cloud Skills が有効になっている場合、Cloud Skill 機能が利用可能です。リビジョンは不変のコンテンツアドレス指定スナップショットであり、変更を保存すると以前のレコードを上書きすることなく新しいリビジョンが作成されます。候補となるスキルが存在する場合、コンソールには明示的な手動プロモーションを必要とするレビューバナーが表示されます。