Work With Alloy

Alloy を活用する

Alloy について

Alloy は、チームと AI エージェントが連携する AI ネイティブなワークスペースです。成果物、ナレッジ、スキル、外部システムへのアクセスを、すべて共通の基盤上で共有できます。Claude、Codex、Gemini を接続することも、Alloy のクラウドエージェントを起動することもでき、エージェント同士やチームメイトとの連携を実現します。

alloy.cx から無料で始められます · ドキュメント：alloy.cx/docs

---

このプラグインは、あらゆる AI エージェントが Alloy を信頼できる情報源として利用できるようにし、Alloy 固有の再利用可能な運用スキルを提供します。回答前に共有ナレッジを読み、長期的に役立つメモや成果物を書き、ワークフローを作成し、運用レビューを実施し、自律型エージェントを起動できます。

共有される信頼できる情報源は work-with-alloy スキルです。プラットフォーム固有のプラグインマニフェストは、同じスキルコンテンツを参照する薄いラッパーです。

ユースケース

Claude、Codex、Alloy のクラウドエージェント、その他の AI エージェントなど、人間や他のエージェントと連携して作業する際、Alloy を AI エージェントの共有運用レイヤーとして利用できます。

• 回答前に共有された組織のナレッジを読み取ります。会社のドキュメント、決定事項、ナレッジメモ、コミュニケーション履歴、すべての AI エージェントと人間が維持するコンテキストが含まれます。
• 提案、調査、要約、仕様、ログ、決定事項、後続のエージェントが活用できる再利用可能なメモなど、長期的に役立つ成果物を Alloy に書き戻します。
• Alloy が管理する MCP を通じて、承認済みのビジネスシステムにアクセスします。エージェントは Alloy に一度接続するだけで、利用可能な上流 MCP、API、ファイル、シークレット、アクションを Alloy が管理します。
• 各エージェントが個別にすべての連携を設定することなく、接続済みのツールを横断して作業できます。CRM、サポート、ドキュメント、カレンダー、メール、データベース、社内システム、プライベートゲートウェイなどに対応します。
• Alloy のクラウド AI エージェントに作業を委任し、その出力や成果物を基に作業を続けます。
• Alloy の AI チームメイト、指示スキル、実行可能なワークフローを作成または設定し、繰り返し行う作業を管理された組織プロセスにします。
• AI エージェントが MCP/API トリガーを通じてタスクを引き継ぐ、マルチエージェント運用を調整します。
• ナレッジ、成果物、アクセスルール、監査証跡を通じて、組織の学習内容をさまざまなエージェント間で引き継げるようにします。

構成

• skills/work-with-alloy/ - 信頼できる情報源となる中核スキル。
• skills/review-alloy-operations/ - チームメイト、指示スキル、ワークフロー、MCP、最近のアクティビティを監査する運用レビュー用スキル。
• skills/*/references/ - 各スキルが読み込む補助プレイブック。
• skills/*/agents/openai.yaml - Codex/OpenAI スキルの UI メタデータ。
• skills/work-with-alloy/assets/ - Alloy アイコンなど、スキルで共有する UI アセット。
• .codex-plugin/plugin.json - Codex プラグインマニフェスト。
• .claude-plugin/plugin.json - Claude Code プラグインマニフェスト。
• .mcp.json - ALLOY_TOKEN を使用する Alloy ホスト型 MCP の設定。

共有スキル

skills/ 配下のスキルは、ホストに依存しない状態を維持することを意図しています。Claude と Codex の個別の指示ツリーを管理するのではなく、共有スキルのコンテンツをここで更新してください。

前提条件

これらは、Claude Code または Codex にプラグインをインストールするすべてのユーザーに適用されます。

1. ALLOY_TOKEN 環境変数

同梱の .mcp.json は ALLOY_TOKEN から Alloy MCP のベアラートークンを読み取ります。Claude Code または Codex を起動する前に、ホストのシェルでエクスポートしてください。

export ALLOY_TOKEN="<your-alloy-token>"

トークンは https://alloy.cx/docs/reference/tech-docs/hosted-mcp で取得できます。

2. インストール後のホストの再起動

プラグインの MCP サーバーは、起動時にホストによって読み込まれます。プラグインのインストールまたは更新後、同梱の MCP 設定を読み込めるよう、ホストを再起動してください。

Codex

Codex のプラグインマニフェストは ./skills/ と ./.mcp.json を参照します。

同梱の MCP 設定を使用する前に、ホスト環境で ALLOY_TOKEN を設定してください。

マーケットプレイスへの登録と app-server のインストールは、Codex 0.125.0 で検証済みです：

codex plugin marketplace add Alloy-Systems/alloy-marketplace

Codex は、タグ付きリリースを参照するマーケットプレイスエントリから work-with-alloy をインストールします。インストール後、Codex ではプラグインが有効と表示され、work-with-alloy:work-with-alloy スキルと同梱の alloy MCP サーバーが利用可能になります。

Claude Code

.claude-plugin/plugin.json にある Claude のプラグインマニフェストは、Codex 側と同じ ./skills/ と ./.mcp.json を参照します。Alloy のマーケットプレイス公開後のインストール手順：

/plugin marketplace add Alloy-Systems/alloy-marketplace
/plugin install work-with-alloy@alloy-marketplace

Claude Code のプラグインインストーラーは、デフォルトで SSH 経由で GitHub からプラグインのソースをクローンします。/plugin install を実行する前に、次のいずれかを満たしていることを確認してください：

• このマシンで使用できる GitHub SSH キーがあること（確認コマンド：ssh -T [email protected]）。

• プラグインのクローンを HTTPS 経由にする、グローバルな git URL 書き換え設定があること：

  git config --global url."https://github.com/".insteadOf "[email protected]:"
  

同梱の MCP 設定を使用する前に、ホスト環境で ALLOY_TOKEN を設定してください。

インストール後、Claude Code を再起動して登録を確認します：

claude mcp list   # expect plugin:work-with-alloy:alloy as connected

バージョニングポリシー

このプロジェクトでは、Claude Code と Codex のラッパー間でリリースを同期しながら、セマンティックバージョニングに従います。1 つのバージョンをリリース全体に適用します。対象は、skills/work-with-alloy/ の共有スキルコンテンツ、両方の plugin.json マニフェスト、.mcp.json 設定、およびこの README です。.codex-plugin/plugin.json と .claude-plugin/plugin.json の version フィールドは、常に同じ値になります。

このプラグインにおける Semver の意味

バージョン変更	意味	例
パッチ（0.1.0 → 0.1.1）	外見上の変更のみです。誤字、表現の調整、リンク切れ、説明の明確化などです。エージェントの動作は変わりません。	SKILL.md の誤字を修正する。references/ にある古い URL を更新する。
マイナー（0.1.0 → 0.2.0）	後方互換性のある追加です。新しいルール、新しい Quick Reference の行、新しいリファレンス用プレイブック、新しい任意のマニフェストフィールドなどです。従来の使い方も引き続き機能します。	Core rules に新しいルールを追加する。Quick Reference テーブルに新しい項目を追加する。references/ に新しいプレイブックを追加する。
メジャー（0.x → 1.0、1.x → 2.x）	互換性を破る変更です。標準パス、ファイル名、必須フィールド、または必須ルールが変更され、以前の利用者に影響する可能性があります。	Personal/<username>/.knowledge/knowledge.md を別のパスに変更する。Core ルールを削除する。references/ を再構成して既存のリンクが切れるようにする。

1.0 より前（0.x）は「まだ安定化の途中で、マイナーバージョンの更新に互換性を破る変更が含まれる可能性がある」ことを示します。標準パスと Core ルールが安定したと確認できた時点で、1.0.0 系をリリースします。

リリースの流れ

1. 機能ブランチで作業し、PR 経由で main にマージします。
2. main がリリースに適した状態になったら、同じコミットで .codex-plugin/plugin.json と .claude-plugin/plugin.json の version フィールドを更新します。
3. マージコミットに git タグを付けます：git tag vX.Y.Z && git push origin vX.Y.Z。
4. Alloy-Systems/alloy-marketplace リポジトリにある work-with-alloy の marketplace.json エントリで、対応する ref フィールドを更新します。ユーザーが /plugin update で新しいバージョンを受け取れるのは、このマーケットプレイスの更新後です。
5. main のタグなしコミットは、リポジトリを閲覧する人には見えますが、マーケットプレイスが新しいタグを参照するまでは /plugin install や /plugin update では配信されません。

リリース頻度

タグは、すべてのコミットではなく、論理的なリリースごとに付けます。一般的なきっかけは、新しい Core ルールの追加、新しいリファレンス用プレイブックの追加、または互換性を破る再構成を完了してリリースできる状態になったときです。外見上の変更だけであれば、main に蓄積し、都合のよいタイミングでパッチバージョンとしてリリースできます。

ライセンス

Apache License 2.0.