> ## Documentation Index > Fetch the complete documentation index at: https://docs.corgea.app/llms.txt > Use this file to discover all available pages before exploring further. # エージェント統合 > AIコーディングエージェントによるセキュリティ脆弱性のスキャン、トリアージ、修正を自動化 ## 自律型セキュリティへの道 Corgeaは、アプリケーションセキュリティを完全に自動化し、ユーザーが開発に集中できる環境を目指しています。すでに脆弱性の検出、誤検知の削減、AIによる修正案の生成を自動化していますが、検出結果への対応、修正の適用、結果の検証には、開発者やセキュリティエンジニアの操作が必要な場合があります。 そこで役立つのがCorgeaのエージェント統合です。Corgeaを、すでに利用しているAIコーディングエージェント(Cursor、Claude Code、GitHub Copilot、OpenAI Codexなど)に直接接続することで、セキュリティタスクの実行に必要なコンテキストと機能をエージェントに提供できます。その結果、セキュリティ問題を検出するだけでなく、最小限の手作業で解決できる開発ワークフローが実現します。 Corgeaは、**Corgea Agent Skill**と**Corgea MCP**の2つのエージェント連携機能を提供します。 *** ## Corgea Agent Skill [Agent Skills](https://agentskills.io/)は、AIエージェントに新たな機能を提供するためのオープンフォーマットです。スキルは、エージェントが必要に応じて検出・利用できる、構造化された指示、コマンド、コンテキストのセットです。特定のツールとの操作方法をエージェントに教えるプレイブックと考えることができます。 Corgea Agent Skillは、Corgea CLIを使用してコードをスキャンし、問題の一覧表示、脆弱性の確認、AI生成の修正の表示と適用を行う方法をコーディングエージェントに提供します。MCP(Corgeaデータへの読み取りアクセスを提供)とは異なり、Agent Skillではエージェントが**実際に操作を実行**できます。スキャンの実行、diffの取得、コードベースへの修正適用が可能です。 Agent Skillsは、**Cursor**、**Claude Code**、**OpenAI Codex**、**GitHub Copilot**、**VS Code**、**Roo Code**、**Windsurf**など、[多くのAI開発ツール](https://agentskills.io/)でサポートされています。 CursorでCorgea Agent Skillを使用 ### 前提条件 スキルをインストールする前に、マシンへ**Corgea CLI**をインストールして認証する必要があります。このスキルは、`corgea scan`、`corgea ls`、`corgea inspect`などのCLIコマンドを使ってCorgeaとやり取りします。 CLIのインストールと認証ガイドに従ってセットアップします。 ### Skills Registry CorgeaのSkills Registryでは、会社が作成したチーム向けAgent Skillsを作成、管理できます。`SKILL.md`を追加し、必要に応じてバージョンを指定してレビューに提出します。各バージョンは、インストール可能になる前に個別にレビューされます。 CLIを通じてインストールできるのは承認されたスキルバージョンのみです。保留中、却下、または失敗したバージョンはレジストリ上で表示され、チームがアップデートを提出する前に状況、メモ、過去のバージョンを確認できます。 ### `npx skills`でインストール メンテナンスされている公開スキルは、ファーストパーティの[`Corgea/skills`](https://github.com/Corgea/skills)リポジトリにある[`corgea-scan`](https://github.com/Corgea/skills/tree/main/plugins/corgea/skills/corgea-scan)です。[Skills CLI](https://github.com/vercel-labs/skills)は`npx`で実行するため、グローバルインストールは不要です。Node.js 18以降とnpmが必要です。 Skills CLIは、エージェントにCorgeaの使用方法を伝える指示をインストールします。Corgea CLI自体のインストールや認証は行いません。先に[Corgea CLIの前提条件](#prerequisites)を満たしてください。 スキャン対象のリポジトリルートでコマンドを実行します。用途に合うスコープを選択してください。 現在のリポジトリで動作するエージェント向けにスキルをインストールします。 ```bash theme={null} npx skills add corgea/skills --skill corgea-scan ``` プロジェクトスコープがデフォルトです。スキルを特定のリポジトリに限定する場合に使用します。他のコントリビューターにもスキルを提供する場合は、生成されたスキルファイルをコミットしてください。 すべてのリポジトリで使用できるよう、ユーザーアカウントにスキルをインストールします。 ```bash theme={null} npx skills add corgea/skills --skill corgea-scan --global ``` グローバルスコープは、同じコーディングエージェントを複数のリポジトリで使い、各プロジェクトにスキルファイルを追加したくない場合に便利です。 デフォルトでは、インストーラーがサポート対象のエージェントを検出し、インストール先を確認します。対象を明示して再現可能なインストールを行うには、1つ以上の`--agent`フラグを指定します。 ```bash theme={null} npx skills add corgea/skills --skill corgea-scan \ --agent claude-code \ --agent cursor \ --agent codex ``` エージェントIDには`claude-code`、`cursor`、`codex`、`opencode`、`github-copilot`、`windsurf`などがあります。詳細は[対応エージェント一覧](https://github.com/vercel-labs/skills#supported-agents)を参照してください。無人インストールでは`--yes`を追加します。 ```bash theme={null} npx skills add corgea/skills --skill corgea-scan \ --global \ --agent codex \ --yes ``` 通常、インストーラーは各エージェントからスキルの共有コピーへのリンクを作成します。シンボリックリンクをサポートしていない環境では、`--copy`を追加して個別のコピーを作成します。 ##### スキルの検証、更新、削除 Skills CLIを使ってインストールの点検と保守を行います: ```bash theme={null} # List project and global skills npx skills list # List only global skills npx skills list --global # Update the project or global installation npx skills update corgea-scan --project npx skills update corgea-scan --global # Remove the project or global installation npx skills remove corgea-scan npx skills remove --global corgea-scan ``` インストール時にすでにコーディングエージェントが動作している場合は、再起動するか新しいセッションを開いてください。そして、次の質問をします: > このリポジトリをCorgeaでスキャンしてください。 エージェントは `corgea-scan`を読み込み、Corgea CLIが利用可能かつ認証済みであることを確認し、現在のリポジトリからスキャンを開始します。 プロジェクトへのインストールは`npx skills list`、グローバルインストールは`npx skills list --global`で確認します。特定のエージェントを指定した場合は、`npx skills list --agent `で確認します。正しい`--agent`とスコープで再インストールし、エージェントを再起動してください。 このスキルにはCorgea CLIが必要です。`corgea --version`と`corgea login`を実行してから、リクエストを再実行してください。プラットフォーム別の設定は[CLIインストールガイド](/ja/cli)を参照してください。 `--copy`を指定して再インストールします。共有コピーへのリンクではなく、選択したエージェントごとに個別のスキルファイルが作成されます。 現在のスコープから削除し、意図したスコープに再インストールします: ```bash theme={null} npx skills remove corgea-scan npx skills add corgea/skills --skill corgea-scan --global ``` ### インストール 公開されているCorgea Agent Skillについては、スキルファイルがGitHubにホストされています: ``` https://raw.githubusercontent.com/Corgea/cli/refs/heads/main/skills/corgea/SKILL.md ``` 最速のインストール方法はCorgea CLIで、Corgeaレジストリから承認されたスキルを取得し、エージェントの適切なディレクトリに配置します。 ```bash theme={null} corgea skill install corgea ``` 設定済みのデフォルトエージェントを対象に、現在のプロジェクトへインストールされます。特定のエージェントは`--agent`（例:`cursor`、`claude-code`、`codex`）、スコープは`--scope project`または`--scope user`、カスタムパスは`--dir`で指定できます。対応エージェントの一覧は[CLIリファレンス](/ja/cli#install-agent-skills)を参照してください。今後使用するデフォルトエージェントは`corgea skill set-default-agent `で設定します。 ```bash theme={null} corgea skill install corgea --agent cursor --scope user corgea skill set-default-agent claude-code ``` ファイルを手動で配置する場合は、使用するエージェントの手順を選択してください。 Cursorは指定されたディレクトリに置かれた `SKILL.md` ファイルからスキルを検出します。Corgeaスキルをインストールするには: 1. プロジェクトまたはホームフォルダにスキルディレクトリを作成する: ```bash theme={null} mkdir -p ~/.cursor/skills/corgea ``` 2. スキルファイルのダウンロード: ```bash theme={null} curl -o ~/.cursor/skills/corgea/SKILL.md \ https://raw.githubusercontent.com/Corgea/cli/refs/heads/main/skills/corgea/SKILL.md ``` 一度配置されると、リクエストがセキュリティタスクに合致すると、Cursorは自動的にエージェントモードでスキルを読み込みます。チャット内の `@corgea` を使って明示的に呼び出すこともできます。 チームと共有するプロジェクトレベルのスキルについては、代わりにリポジトリ内の `.cursor/skills/corgea/SKILL.md` にファイルを配置してください。 Claude Codeは `.claude/skills/` ディレクトリからスキルを読み取る。インストール方法: 1. スキルディレクトリの作成: ```bash theme={null} mkdir -p ~/.claude/skills/corgea ``` 2. スキルファイルのダウンロード: ```bash theme={null} curl -o ~/.claude/skills/corgea/SKILL.md \ https://raw.githubusercontent.com/Corgea/cli/refs/heads/main/skills/corgea/SKILL.md ``` セキュリティスキャンや脆弱性修復について尋ねると、Claude Codeが自動的にスキルを検出し、適用します。 gitで共有するプロジェクトレベルのスキルについては、リポジトリ内の `.claude/skills/corgea/SKILL.md` にファイルを置いてください。 Codexは `~/.codex/skills/` ディレクトリからスキルを読み取ります。インストール方法: 1. スキルディレクトリの作成: ```bash theme={null} mkdir -p ~/.codex/skills/corgea ``` 2. スキルファイルのダウンロード: ```bash theme={null} curl -o ~/.codex/skills/corgea/SKILL.md \ https://raw.githubusercontent.com/Corgea/cli/refs/heads/main/skills/corgea/SKILL.md ``` Codexは起動時に自動的にスキルを検出します。また、リポジトリのルートに `AGENTS.md` ファイルを追加して、プロジェクト固有の用途でスキルを参照することもできます。 GitHub Copilot in VS Codeは `.github/skills/` や `~/.copilot/skills/`のスキルを読み取っています。インストール方法: 1. スキルディレクトリの作成: ```bash theme={null} mkdir -p ~/.copilot/skills/corgea ``` 2. スキルファイルのダウンロード: ```bash theme={null} curl -o ~/.copilot/skills/corgea/SKILL.md \ https://raw.githubusercontent.com/Corgea/cli/refs/heads/main/skills/corgea/SKILL.md ``` スキルが読み込まれているかは、VS Codeのチャットパネルで「 `/skills` 」と入力することで確認できます。 プロジェクトレベルのスキルについては、リポジトリ内の `.github/skills/corgea/SKILL.md` にファイルを配置してください。 Windsurfは、 `.windsurf/skills/` (プロジェクト)や `~/.codeium/windsurf/skills/` (グローバル)からのスキルを読みます。グローバルにインストールするには: 1. スキルディレクトリの作成: ```bash theme={null} mkdir -p ~/.codeium/windsurf/skills/corgea ``` 2. スキルファイルのダウンロード: ```bash theme={null} curl -o ~/.codeium/windsurf/skills/corgea/SKILL.md \ https://raw.githubusercontent.com/Corgea/cli/refs/heads/main/skills/corgea/SKILL.md ``` Cascadeは、リクエストが説明に合うと自動的にスキルを発動します。また、Cascade入力の `@corgea` を使って明示的に有効化することもできます。 プロジェクトレベルのスキルについては、リポジトリ内の `.windsurf/skills/corgea/SKILL.md` にファイルを配置してください。 Roo Codeは `.roo/skills/` (プロジェクト)や `~/.roo/skills/` (グローバル)からスキルを読み取っています。グローバルにインストールするには: 1. スキルディレクトリの作成: ```bash theme={null} mkdir -p ~/.roo/skills/corgea ``` 2. スキルファイルのダウンロード: ```bash theme={null} curl -o ~/.roo/skills/corgea/SKILL.md \ https://raw.githubusercontent.com/Corgea/cli/refs/heads/main/skills/corgea/SKILL.md ``` Roo Codeは段階的開示を採用しています。検出時にはスキルのfrontmatterを読み、リクエストがスキルの説明に一致したときに完全な指示を読み込みます。 プロジェクトレベルのスキルについては、リポジトリ内の `.roo/skills/corgea/SKILL.md` にファイルを配置してください。 [Agent Skills](https://agentskills.io/)オープンフォーマットをサポートするすべてのエージェントでCorgeaスキルを利用できます。一般的な方法は次のとおりです。 1. エージェントのドキュメントでスキルディレクトリを確認する。 2. その中に `corgea` サブディレクトリを作成します。 3. スキルファイルをそのディレクトリにダウンロードする: ```bash theme={null} curl -o SKILL.md \ https://raw.githubusercontent.com/Corgea/cli/refs/heads/main/skills/corgea/SKILL.md ``` 対応するエージェントと設定ガイドの一覧は、[Agent SkillsのWebサイト](https://agentskills.io/)を参照してください。 ### スキルマーケットプレイス Corgeaは、[github.com/Corgea/skills](https://github.com/Corgea/skills)でAgent Skillsのオープンマーケットプレイスも公開しています。上記のCLIスキルに加え、完全にローカルで動作するツールのスキルも含まれ、Agent Skills形式をサポートする70以上のエージェントにインストールできます。 | スキル | 何をするか | | ----------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | [`corgea-scan`](https://github.com/Corgea/skills/tree/main/plugins/corgea/skills/corgea-scan) | CorgeaのAI搭載BLASTスキャナーでスキャンし、AIが生成した修正を確認して適用します。CorgeaアカウントとCLIが必要です。 | | [`sighthound`](https://github.com/Corgea/skills/tree/main/plugins/sighthound/skills/sighthound) | [Sighthound](https://github.com/Corgea/Sighthound)は、パターン解析とテイントフロー解析を備えた高速なTree-sitterベースのSASTスキャナーです。完全にローカルで動作し、アカウントやネットワーク接続は不要です。 | [スキル CLI](https://github.com/vercel-labs/skills)で単一のスキルをインストール: ```bash theme={null} npx skills add corgea/skills --skill corgea-scan ``` Claude Codeユーザーは代わりにマーケットプレイス全体をプラグインとして追加でき、すべてのスキルを一度に利用可能にします: ``` /plugin marketplace add corgea/skills ``` Sighthoundを使用する場合や、複数のスキルをまとめて管理する場合はマーケットプレイスが適しています。Corgea CLIスキルだけをインストールする場合は、上記の`corgea skill install corgea`の方が手順が少なく、Corgeaレジストリで承認されたバージョンを取得できます。 ### ユースケース Corgeaがプルリクエストをスキャンし脆弱性を報告すると、各検出結果を手動で確認し修正を書く必要はなくなります。コーディングエージェント(Cursor、Claude Codeなど)を開いて、問題の修正を求めてください: > 「最新のPRスキャンでCorgeaが見つけたすべてのセキュリティ問題を修正してください。」 エージェントがCorgeaに接続し、スキャンの問題を一覧表示してAI生成の差分を取得し、コードベースへ修正を適用します。これらを1回の操作で実行できます。 AI支援(バイブコーディング)を使ってコードを素早く反復していると、セキュリティが見落とされがちです。エージェントを使って、各コミット前にセキュリティチェックを実行します: > 「未コミットの変更をセキュリティ問題がないかスキャンし、見つけたものはすべて修正してください。」 エージェントが`corgea scan --only-uncommitted`を実行し、結果を確認して修正を適用します。開発速度を落とさずに、頻繁に変更されるコードの安全性を維持できます。 作業中のファイルまたはディレクトリだけをスキャン対象にできます。 > 「src/auth/ディレクトリをスキャンしてセキュリティ脆弱性を探せ」 エージェントが`--target src/auth/`を指定してBLASTスキャンを実行し、検出結果を確認して、その場で修正を適用できます。 検出結果を修正する前に理解したい場合: > 「詳細を見せて、問題ISSUE\_IDの修正をしてください。」 エージェントが問題の詳細を取得して脆弱性を説明し、AI生成の修正案を差分で提示します。ユーザーは、その情報に基づいて修正するかどうかを判断できます。 *** ## Corgea MCP [Model Context Protocol（MCP）](https://modelcontextprotocol.io/)は、AIエージェントが外部のツールやデータソースに安全に接続するためのオープン標準です。CorgeaのMCPサーバーは、スキャン結果、脆弱性の詳細、SCAの検出結果、ブロッキングルールをMCP対応エージェントに直接公開します。 Corgea MCPを使えば、AIエージェントはスキャン結果のクエリ、問題の詳細取得、重大度やプロジェクト別にフィルタリングされた脆弱性のリスト、ポリシー設定の確認など、データをコピー&ペーストしたりツールを切り替えたりすることなく対応できます。 Claude Desktop、Cursorなどの完全なセットアップ手順、利用可能なツール、クライアント設定。 ### ユースケース * **コンテキストコードレビュー**:エージェントに「直近のスキャンで検出された重大な脆弱性は何か?」と尋ね、実際のスキャンデータに基づいた実用的な回答を得ることができます。 * **脆弱性トリアージ**:重大度、悪用可能性、組織のブロッキングルールに基づいて、優先的に修正する問題をエージェントに判断させます。 * **修復計画**:エージェントに特定のプロジェクトやスキャンにおける未解決の高重大度問題の修正計画を作成するよう依頼します。 * **依存リスク評価**:SCAの検出結果をクエリし、既知の脆弱性を持つサードパーティライブラリやアップグレードすべきバージョンを把握します。 *** ## Agent SkillとMCPの使い分け | | **Corgea Agent Skill** | **Corgea MCP** | | -------------- | ------------------------------- | ------------------------------- | | **適した用途** | スキャンの実行と修正の適用 | 既存のスキャンデータのクエリと分析 | | **機能** | スキャンの実行、問題の一覧表示、検出結果の確認、修正差分の適用 | スキャン結果、問題、SCAデータ、ブロッキングルールの参照 | | **要件** | Corgea CLIのインストールと認証 | APIトークンとMCPクライアント | | **エージェントの操作** | エージェントがターミナルでCLIコマンドを実行 | エージェントがMCPプロトコル経由でCorgea APIを照会 | | **理想的なワークフロー** | 「コードをスキャンして修正して」 | 「どのような脆弱性が存在するか」 | 最も包括的に利用するには、**両方を組み合わせます**。Agent Skillは検出結果に対する操作に、MCPはセキュリティ態勢の照会と把握に使用します。 *** ## はじめに [CLIインストールガイド](/ja/cli)に従ってインストールと認証を行います。 上記のインストール手順に従って、Corgeaスキルをコーディングエージェントに追加します。 AIエージェントをCorgeaのMCPサーバーに接続し、セキュリティデータにアクセスできるようにします。詳細は[MCPセットアップガイド](/ja/modelcontextprotocol)を参照してください。 自然言語で指示し、エージェントにコードのスキャン、検出結果の確認、修正の適用を実行させます。