Skip to content

native container cli_ja

Jump to bottom
Kazushi Kamegawa edited this page Nov 1, 2026 · 1 revision

Native Container CLI スキル

承認日: 2026-11-01。本チャットで計画とIssue構成が承認され、Wikiは日本語のみと指定されたため、この計画の英語版は作成しません。

追跡

種別 Issue
親 #99 Prefer native container CLIs on Windows and macOS
スキル #100 Add native container routing and Docker fallback approval guidance
配布・検証 #101 Register and validate the native-container-cli plugin

背景と目的

WindowsではWSL Containers、macOSではAppleのcontainerをローカルLinuxコンテナー操作の第一選択とします。参照ドキュメントにDockerコマンドが記載されていても、同じ動作を提供できるネイティブCLIのコマンドに自動変換します。Composeなど対応できない機能が必要な場合は、Dockerへ切り替える前にユーザーの確認を得ます。

設計

  • プラグインとスキルの名前はnative-container-cliとし、通常の自動検出を有効にします。
  • 実行対象のOS、アーキテクチャ、CLIの所在、バージョン、サブコマンドとオプションを確認します。Windowsはwslc.exe、macOSはAppleのcontainerを使用します。WSLシェル、SSH先、CI、コンテナー内の実行は、エージェントのホストOSと区別します。
  • 英語のSKILL.mdに共通方針とDocker切り替えの確認手順を置き、OS別の詳細はreferences/windows.mdとreferences/macos.mdへ分離します。日本語の説明はスキル検出対象外のdocs/skill-guides/native-container-cli_ja.mdに置きます。
  • 置換は実行ファイル名だけでなく、サブコマンド、マウント、公開ポート、環境変数、作業ディレクトリ、プラットフォーム、出力形式、終了・削除の意味を保ちます。未対応オプションを黙って捨てません。
  • CLIやランタイムの不足、停止状態、能力不明はDockerへの自動切り替え理由にはしません。インストール、更新、サービス起動などが必要なら、元の依頼で認められた範囲を判断し、追加の許可が必要な操作だけを確認します。
  • Compose、Buildx、Docker API／ソケット、Testcontainersなどは、利用中のバージョンで必要な動作を提供できるか確認します。製品名の類似性だけで互換と判断せず、Composeを個別のrunへ分解して依存関係やボリュームなどの意味を失わせません。
  • Dockerを使う必要がある場合は、未対応機能と実行予定コマンドを提示して確認します。Dockerのバージョン確認や、Dockerを内部起動するスクリプト・ライブラリもこの確認に含めます。同じ範囲について明示的に得た許可は再確認しません。
  • シェルのグローバルalias、Dockerラッパー、既存Docker環境の削除、無関係なCIの書き換えは行いません。このスキルはエージェントへの指示であり、OSレベルの強制フックではありません。

配布

  • plugins/native-container-cli/にMITライセンス、Claude/Copilot用とCodex用のmanifest、スキルUIメタデータを含めます。
  • .claude-plugin/marketplace.jsonと.agents/plugins/marketplace.jsonへ登録します。
  • AGENTS.mdのスキル一覧、英日READMEのプラグイン一覧とインストール例を更新します。

実装手順

  1. OS別の能力確認と変換例、Docker切り替えの確認条件を実装します。
  2. プラグインのmanifest、ライセンス、両marketplace登録、英日説明を追加します。
  3. 構造検証と独立した行動シナリオ検証を実施し、実際のランタイム実行と静的検証の結果を区別して報告します。

検証方針

  • skill-creatorのquick_validate.pyでfrontmatter、名前、未完成の雛形を確認します。
  • リポジトリのvalidate_marketplaces.pyでmanifest、カタログ、ライセンス、リンクとプラグイン境界を確認します。
  • WindowsとmacOSでの通常操作、WSLシェル、LinuxのCI先、Compose未対応、Docker API依存、未対応オプション、ネイティブCLI未導入のシナリオを、独立したエージェントで読み取り専用検証します。
  • macOSで利用可能なCLIのバージョンとヘルプを確認します。Windows実機やランタイム起動を伴うE2Eは、実施した場合のみ成功と報告します。

根拠資料

以下は2026-11-01に確認した公開公式資料です。将来の対応状況は実行時のヘルプと公式資料で再確認します。

資料 採用理由
Microsoft Learn: WSL container WSL Containersの正式CLIはwslc.exeであり、Linuxコンテナーを扱うことを確認するため。
Microsoft Learn: Get started with containers on WSL バージョン確認、コマンド別ヘルプ、build/run/container/image操作を確認するため。
Apple container README Apple siliconと対応macOS、container CLIの位置付けを確認するため。
Apple Container CLI Command Reference list、image pull、registryなどDockerと異なるコマンド階層とオプションを確認するため。

単純なDocker互換aliasでは引数やAPIの意味を保てないため、能力を確認して変換するスキルを採用します。

Clone this wiki locally