ID Protocol

ID Protocol — AI ツール向けの持ち運び可能なコンテキスト

自分で管理するファイルに作業上の設定を保存します。ID は、レビュー済みのプロファイルを、AI ツールやリポジトリ間で持ち運べる、プライバシーに配慮してフィルタリングされたコンパクトなコンテキストに変換します。

5 分で試す

Python 3.11 以降が必要です。

uv tool install id-protocol
mkdir my-id-profile && cd my-id-profile
idctl init --owner-id demo

profiles/demo/profile.minimal.md を編集し、ポータブルな出力を生成して確認します。

idctl validate --owner-id demo
idctl refresh-soul --owner-id demo
idctl export-compact --owner-id demo
idctl diff --owner-id demo --since 7d

スタータープロファイルは、レビューするまでは暫定的なものです。demo や my-work-profile などのエイリアスを使いましょう。法的な氏名は必要ありません。ID が生成ファイルをアップロードすることはありません。

ファイルと所有権

ファイル	役割
profile.minimal.md	所有者が編集する簡潔な開始用プロファイル
profile.core.md	より詳細な情報源が必要な場合の正式なプロファイル
profile.extended.md	ワークフローやコンテキストの詳細を記載する任意のファイル
privacy-policy.v1.json	フィールドごとのエクスポート許可設定
handshake.md	コンテキストを適用するための簡潔なルール
soul.md	エージェント用に生成された短いブートストラップ
context.compact.json	プライバシーに配慮してフィルタリングされたポータブルなコンテキスト
mcp.context.resource.json	外部 MCP アダプター用のリソースペイロード

Markdown プロファイルが信頼できる唯一の情報源です。生成される JSON は転送用のビューであり、細かなニュアンスが省略される場合があります。このパッケージはローカル CLI であり、MCP サーバーの提供やベンダーアカウントとの同期は行いません。

プライバシーの動作

コンパクトなエクスポートと MCP リソースのエクスポートには、要求されたプロファイルの owner_id と一致する、有効なポリシーが必要です。リストにないフィールドはローカルにのみ保持されます。ポリシーが存在しない場合、形式が不正な場合、内容が混在している場合、競合がある場合、または所有者が一致しない場合は、エクスポートがブロックされます。

以前のリリースで使われていた従来のリスト形式のポリシーは、検証とエクスポートの際にメモリ上で正規化されます。元のファイルは変更されず、制限も有効なままです。--allow-unfiltered は、レビュー済みの従来のワークフローでポリシーが存在しない場合に限りエクスポートを許可します。有効でないポリシーを回避することはできません。

別のツールに添付する前に、生成されたエクスポートを確認してください。プライバシーモデル、ポリシースキーマ、脅威モデルを参照してください。

ABVX ツールチェーン

製品	役割	テスト済みリリース
ID	人の設定と運用上の制約	0.5.2
agentsgen	リポジトリの指示とコマンド	0.5.0
SET	レビュー優先のワークフロー計画とエクスポート	0.4.0
abvx-agent-skills	再利用可能な任意のワークフロー	0.15.0

これらはそれぞれ独立してインストールできます。ID は関連ツールをインストールせず、ツールの権限を付与することもありません。

すでにレビュー済みの ID プロファイルがあるリポジトリでは、次のようにします。

idctl install-set-hook --path .

アダプターは SET 用の所有者ローカルなブートストラップ参照を返し、既存のカスタムフックを保持します。SET 連携ガイドを参照してください。

根拠

再現可能な 3 つのデモでは、インストール後のオンボーディング、ポリシーによるフィルタリングと除外、従来のポリシーとの互換性、合成データを使った agentsgen／SET との引き継ぎを検証します。測定対象はローカル CLI の動作と実行時間であり、AI の回答品質ではありません。

過去のベンチマークスナップショットは、明示的な制限事項を含む、小規模なチェックイン済みサンプルです。AI クライアントの動作は、各クライアントの設定とコンテキストのルールにも左右されます。

開発

git clone https://github.com/markoblogo/ID.git
cd ID
python -m venv .venv
. .venv/bin/activate
python -m pip install ".[dev]" build twine
make validate
make drift-check
make coverage
make release-build
make release-check

まず、ドキュメントインデックス、プロトコル、統合の境界、コントリビューションガイドを確認してください。公開イシューやプルリクエストでは、合成プロフィールを使用してください。

ABVX エコシステム

• AGENTS.md_generator — レビュー済みのコンテキストをリポジトリのガイダンス用にエクスポートします。現在のリリース：v0.5.1。
• AGENTS.md_generator — リポジトリのガイダンスと機械可読なコンテキストを最新の状態に保ちます。現在のリリース：v0.5.1。
• abvx-agent-skills — メンテナンス時に、共有されレビュー可能なエージェント機能を使用します。現在のリリース：v0.16.1。

このブロックは、レビュー済みの ABVX エコシステムレジストリから生成されています。