mcpField
O
oci

oci

github.com/oracleクラウド・DevOps904513 回インストール3 週間前に更新
リポジトリ

oci について

OKE、Functions、IoT、Enterprise AI を扱う Oracle Cloud Infrastructure 向けスキル集です。タスク別のガイダンスをまとめ、リソース変更前の読み取り専用調査と承認を重視します。

主な機能

  1. 01OKE の設計とトラブルシューティング
  2. 02Functions のデプロイと診断
  3. 03IoT リソースとデジタルツインのワークフロー
  4. 04Enterprise AI とガバナンスのガイド
  5. 05運用操作における承認ルール

活用シーン

  1. 01OKE クラスターの計画や調査
  2. 02OCI Function のデプロイや診断
  3. 03IoT デジタルツインの探索とテレメトリー公開
  4. 04ガバナンスに沿った Enterprise AI エージェントの計画

MCP 対応

OCI Internet of Things Platform のワークフローでは MCP による任意の操作支援を扱い、MCP を使う OCI Responses API エージェントのガイドも含みます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/oracle/skills --skill oci

インストール後、Claude Code で/ociを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

enterprise-ai/agent-workflows/
agent-tools.md
hosted-applications.md
responses-api-agents.md
enterprise-ai/agents/
openai.yaml
enterprise-ai/cost/
cost-estimation.md
enterprise-ai/data/
rag-and-search.md
enterprise-ai/governance/
private-endpoints-and-governance.md
enterprise-ai/integrations/
oracle-platform-integrations.md
enterprise-ai/models/
custom-and-imported-models.md
enterprise-ai-models.md
functions/oci-functions-deploy/agents/
openai.yaml
functions/oci-functions-deploy/references/
cidr-sizing.md
functions-vcn-requirements.md
oci-functions-quickstart.md
functions/oci-functions-deploy/scripts/
build_and_deploy.sh
common.sh
configure_context.sh
confirm_gate.sh
discover_state.sh
ensure_app.sh
ensure_network.sh
install_fn_linux.sh
install_missing.sh
preflight_check.sh
run_linux_pkg_install.sh
functions/oci-functions-deploy/tests/
test_skill_contract.sh
functions/oci-functions-troubleshoot/agents/
openai.yaml
functions/oci-functions-troubleshoot/references/
create.md
deploy.md
error-patterns.md

詳細

Oracle Cloud Infrastructure スキル

Oracle Cloud Infrastructure に関する実践的なガイダンスには、このドメインを使用してください。現在のコンテンツでは、OCI Kubernetes Engine（OKE）を扱っています。対象は、クラスター設計、運用上のトラブルシューティング、Generic VNIC Attachment（GVA）、および Multus のマルチインターフェース Pod の検証です。また、OCI Internet of Things Platform のリソース検出、デジタルツインのライフサイクルワークフロー、デバイスの公開フロー、およびオプションの MCP による操作も扱っています。OCI Functions のローカルデプロイと、診断を優先するトラブルシューティングも扱っています。さらに、Enterprise AI も対象です。これは、OCI Generative AI、OCI ネットワーク、IAM、コスト見積もり、ホスト型アプリケーション、および OCI プラットフォームとの統合を基盤としているためです。

このドメインの使用方法

  1. まず、以下のルーティング表を確認してください。
  2. ユーザーのタスクに一致する最小限のサービスファイルまたはネストされたスキルのみを読み込んでください。
  3. 設計や修復に関する提案を行う前に、Oracle の公式ドキュメントと、ライブ環境に対する読み取り専用の検出コマンドを優先してください。
  4. OCI または Kubernetes リソースを作成、更新、削除、再起動、スケーリング、ドレイン、またはその他の方法で変更するコマンドを実行する前に、許可を求めてください。
  5. OCI が所有する設計上の判断はここで扱い、データベースが所有する SQL、ベクトル、および Select AI の実装詳細は db/features/ に振り分けてください。

ディレクトリ構成

oci/
├── SKILL.md
├── enterprise-ai/
│   ├── SKILL.md
│   ├── models/
│   ├── agent-workflows/
│   ├── governance/
│   ├── data/
│   ├── cost/
│   └── integrations/
├── functions/
│   ├── oci-functions-deploy/
│   │   ├── SKILL.md
│   │   ├── agents/
│   │   ├── references/
│   │   ├── scripts/
│   │   └── tests/
│   └── oci-functions-troubleshoot/
│       ├── SKILL.md
│       ├── agents/
│       └── references/
├── iot-platform/
│   ├── SKILL.md
│   ├── agents/
│   ├── references/
│   ├── scripts/
│   ├── templates/
│   └── tests/
└── oke/
    ├── cluster-design.md
    ├── troubleshooting.md
    ├── gva-node-pools.md
    ├── multus-multihome.md
    ├── skills/
    ├── scripts/
    ├── agents/
    ├── shared/
    ├── examples/
    └── tests/

カテゴリー別ルーティング

トピック最初に確認するもの
OKE クラスター、Terraform スタック、または OCI Resource Manager スタックを設計または作成するまず oci/oke/cluster-design.md を確認し、次に oci/oke/skills/oke-cluster-generator/SKILL.md を読み込んでください
OKE のワークロード、Pod、サービス、DNS、アドオン、Ingress、ロードバランサー、イメージのプル、ストレージ、Workload Identity、またはクラスターアクセスのトラブルシューティングまず oci/oke/troubleshooting.md を確認し、次に oci/oke/skills/oke-troubleshooter/SKILL.md を読み込んでください
Generic VNIC Attachment のセカンダリ VNIC プロファイルと Application Resources を使って OKE マネージドノードプールを構成するまず oci/oke/gva-node-pools.md を確認し、次に oci/oke/skills/oke-gva-deployer/SKILL.md を読み込んでください
OKE 上に Multus NetworkAttachmentDefinitions とマルチインターフェース Pod をデプロイまたは検証するまず oci/oke/multus-multihome.md を確認し、次に oci/oke/skills/oke-multihome-deployer/SKILL.md を読み込んでください
ローカルの macOS または Linux ワークステーションから OCI Function をデプロイするoci/functions/oci-functions-deploy/SKILL.md
OCI Functions のセットアップ、デプロイ、呼び出し、またはオブザーバビリティをトラブルシューティングするoci/functions/oci-functions-troubleshoot/SKILL.md
OCI IoT のドメイン、ドメイングループ、デジタルツインモデル、アダプター、インスタンス、関係、未加工コマンド、Data API アクセス、または HTTPS 公開フローoci/iot-platform/SKILL.md
OCI Generative AI のモデル、カスタム／インポート済みモデル、エンドポイント、またはプライベートエンドポイントoci/enterprise-ai/SKILL.md
OCI Responses API のエージェント、ツール、メモリ、File Search、Code Interpreter、MCP、または SQL Searchoci/enterprise-ai/SKILL.md
OCI Generative AI および OCI Generative AI Agents のコスト見積もりoci/enterprise-ai/cost/cost-estimation.md
OCI Enterprise AI のガバナンス、IAM、API キー、OAuth、ガードレール、または ZPRoci/enterprise-ai/governance/private-endpoints-and-governance.md

主な参照先

  • oci/oke/cluster-design.md
  • oci/oke/troubleshooting.md
  • oci/oke/gva-node-pools.md
  • oci/oke/multus-multihome.md
  • oci/functions/oci-functions-deploy/SKILL.md
  • oci/functions/oci-functions-troubleshoot/SKILL.md
  • oci/functions/oci-functions-deploy/references/oci-functions-quickstart.md
  • oci/functions/oci-functions-troubleshoot/references/error-patterns.md
  • oci/iot-platform/SKILL.md
  • oci/iot-platform/references/cli-workflows.md
  • oci/iot-platform/references/mcp-optional-use.md
  • oci/enterprise-ai/SKILL.md
  • oci/enterprise-ai/models/enterprise-ai-models.md
  • oci/enterprise-ai/agent-workflows/responses-api-agents.md
  • oci/enterprise-ai/cost/cost-estimation.md
  • oci/enterprise-ai/governance/private-endpoints-and-governance.md

運用ツール

OKE 運用スキルには、oci/oke/scripts/ にある決定論的なヘルパーツールと、oci/oke/skills/*/scripts/ にあるスキル固有のヘルパースクリプトが含まれます。

  • 読み取り専用の検出ツールやエビデンス収集ツールは、コンテキストの収集に使用できます。
  • 生成のみを行うツールでは、マニフェスト、コマンド、Terraform のコードスニペット、レポートを生成できます。
  • OCI または Kubernetes リソースを作成、更新、削除、パッチ適用、再起動、スケーリング、ドレイン、デバッグ、IP アドレス割り当て、マニフェスト適用など、その他の変更を加えるツールやコマンドを使用するには、事前にユーザーの明示的な承認が必要です。
  • oci/oke/scripts/gva-menu.sh は、ユーザーが実行を承認し、最後の CREATE 確認を完了した場合に限り、GVA ワークフロー向けの OKE ノードプールを作成できます。
  • oci/oke/scripts/node-doctor-run.sh は、一時的なデバッグポッドを作成し、クリーンアップ時にそのポッドを削除する場合があるため、実行前に承認が必要です。

一般的な複数ステップのワークフロー

タスク推奨される手順
本番環境向け OKE クラスターを計画するoke/cluster-design.md
ロードバランサーの IP アドレスがない OKE サービスを診断するoke/troubleshooting.md
ワークロード固有のセカンダリ VNIC プロファイルを使用してノードプールを構築するoke/gva-node-pools.md -> ポッドに複数のインターフェイスが必要な場合は oke/multus-multihome.md
GVA 対応ノードで Multus ポッドネットワーキングを検証するoke/multus-multihome.md -> 症状が残る場合は oke/troubleshooting.md
OKE ワークロードによる OCI API へのアクセスを調査するoke/troubleshooting.md
ローカル関数をデプロイするfunctions/oci-functions-deploy/SKILL.md -> 事前チェック -> Fn コンテキストの検証 -> OCIR 認証の確認 -> アプリケーションの選択 -> スキャフォールドの作成 -> デプロイ
関数のデプロイ失敗をトラブルシューティングするfunctions/oci-functions-troubleshoot/SKILL.md -> functions/oci-functions-troubleshoot/references/error-patterns.md -> functions/oci-functions-troubleshoot/references/deploy.md
関数の呼び出し失敗をトラブルシューティングするfunctions/oci-functions-troubleshoot/SKILL.md -> functions/oci-functions-troubleshoot/references/invoke.md -> ログ、トレース、メトリクス、制限
OCI IoT デジタルツインのリソースを調査または更新するiot-platform/SKILL.md -> iot-platform/references/cli-workflows.md -> iot-platform/references/resilience-guidance.md
テスト用テレメトリを OCI IoT ツインに公開するiot-platform/SKILL.md -> iot-platform/references/cli-workflows.md -> iot-platform/templates/publish-curl.template.sh
ガバナンスを備えたエンタープライズアシスタントを構築するenterprise-ai/SKILL.md -> enterprise-ai/agent-workflows/agent-tools.md -> enterprise-ai/data/rag-and-search.md -> enterprise-ai/governance/private-endpoints-and-governance.md

対象範囲の境界

  • OCI サービス、ネットワーキング、IAM、エージェントのホスティング、コスト見積もりに関するガイダンスは、このドメインで扱います。
  • OCI IoT のドメイン、デジタルツイン、アダプター、デバイスからの公開、raw コマンド、Data API のワークフローは oci/iot-platform/ に移管します。
  • Oracle Database が所有する実装の詳細は db/features/ に移管します。
  • APEX アーティファクトの生成は apex/apexlang/ に移管します。
  • OCI サービスの制限、IAM 動詞、エンドポイント形式、リージョン、料金の入力値は頻繁に変更されるため、Oracle の公式ドキュメントを優先してください。

Sources

コメント

Markdown 対応