> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# スキル概要

> エージェントの機能を拡張する再利用可能なプロンプトとワークフローを作成

スキルは、Devin CLI に覚えさせられる独立した機能単位です。プロンプト、ツールへのアクセス、権限、ワークフローをひとまとめにした、エージェントまたは人間のオペレーターが呼び出せる再利用可能なパッケージです。

***

<div id="what-are-skills">
  ## スキルとは？
</div>

スキルは、エージェントに与える専門知識だと考えてください。スキルでは、たとえば次のことを教えられます。

* チームの標準に従ってコードをレビューする
* 特定の種類のコンポーネントを生成する
* デプロイワークフローを実行する
* セキュリティ監査を実施する
* テンプレートから新しいサービスをセットアップする

<CardGroup cols={2}>
  <Card title="スラッシュコマンドでの呼び出し" icon="code">
    ユーザーは、チャットで `/skill-name` を使ってスキルを呼び出せます。
  </Card>

  <Card title="エージェントの自律性" icon="robot">
    エージェントは、必要に応じて自動的にスキルを呼び出せます。
  </Card>

  <Card title="スコープ限定の権限" icon="shield">
    スキルごとに独自の権限付与や制限を設定できます。
  </Card>

  <Card title="カスタムツールへのアクセス" icon="wrench">
    安全性のため、スキルが利用できるツールを制限できます。
  </Card>

  <Card title="サブエージェントとしての実行" icon="users">
    スキルを、それぞれ独自の前提情報ウィンドウを備えた独立した[サブエージェント](/ja/cli/subagents)として実行できます。
  </Card>

  <Card title="モデルのオーバーライド" icon="brain">
    特定のスキルでは別の[モデル](/ja/cli/models)を利用できます。
  </Card>
</CardGroup>

***

<div id="quick-example">
  ## 簡単な例
</div>

`.devin/skills/review/SKILL.md` (または `.windsurf/skills/review/SKILL.md`) に、コードレビュー用のスキルを作成します：

```markdown theme={null}
---
name: review
description: コミット前にコードの変更をレビューする
allowed-tools:
  - read
  - grep
  - glob
  - exec
---

現在のgit diffをレビューしてフィードバックを行う:

1. `git diff --staged` を実行する（ステージングされていない場合は `git diff`）
2. 以下を確認する:
   - ロジックエラーやバグ
   - エラーハンドリングの欠如
   - セキュリティの問題
   - スタイルの不一致
3. 確認結果をまとめて改善案を提案する
```

これで、どのセッションでも `/review` を使って呼び出せます。

***

<div id="how-skills-work">
  ## スキルの動作
</div>

スキルが呼び出されると、次の処理が行われます。

1. スキルのプロンプトが会話に挿入されます
2. ツールへのアクセスは、そのスキルの`allowed-tools`に制限されます (指定されている場合)
3. スキルの設定にある追加の権限が適用されます
4. 指定されたモデルが利用されます (現在のモデルと異なる場合)

スキルの実行が完了すると、セッションは通常の設定に戻ります。

***

<div id="skill-triggers">
  ## スキルのトリガー
</div>

スキルは次の2つの方法で呼び出せます。

| トリガー    | 説明                        | デフォルト |
| ------- | ------------------------- | ----- |
| `user`  | ユーザーが`/skill-name`で呼び出せます | 有効    |
| `model` | 必要に応じてエージェントが自律的に呼び出せます   | 有効    |

```yaml theme={null}
---
name: security-check
triggers:
  - user
  - model
---
```

エージェントが自らスキルを呼び出さないようにするには、`triggers: [user]` を設定します。

***

<div id="third-party-skills">
  ## サードパーティ製スキル
</div>

`.agents` のスキル標準に対応しているため、サードパーティ製のスキルインストールツールをDevin CLIで利用できます。

<Warning>
  サードパーティ製スキルは任意のコードを実行できるため、導入は自己責任で行ってください。
</Warning>

***

<div id="where-skills-live">
  ## スキルの保存場所
</div>

スキルは、1 つのプロジェクト専用にすることも、すべてのプロジェクトで共有することもできます。

| 場所                                            | スコープ                           | git にコミットされるか |
| --------------------------------------------- | ------------------------------ | ------------- |
| `.agents/skills/<name>/SKILL.md`              | プロジェクト固有                       | はい            |
| `.devin/skills/<name>/SKILL.md`               | プロジェクト固有                       | はい            |
| `.windsurf/skills/<name>/SKILL.md`            | プロジェクト固有                       | はい            |
| `~/.agents/skills/<name>/SKILL.md`            | グローバル (すべてのプロジェクト)             | いいえ           |
| `~/.config/devin/skills/<name>/SKILL.md`      | グローバル (すべてのプロジェクト)             | いいえ           |
| `~/.codeium/<channel>/skills/<name>/SKILL.md` | グローバル (すべてのプロジェクト、channel に依存) | いいえ           |

**プロジェクト スキル** は、プロジェクトルートの `.devin/skills/` または `.windsurf/skills/` ディレクトリにあり、バージョン管理にコミットされるため、チームで共有できます。どちらの場所でも同じ `SKILL.md` 形式を使用します。

**グローバル スキル** は `~/.config/devin/skills/` ([XDG の慣例](https://specifications.freedesktop.org/basedir-spec/latest/) に準拠) または `~/.codeium/<channel>/skills/` (`<channel>` は CLI の channel に応じて `windsurf`、`windsurf-next`、または `windsurf-insiders`) にあり、このマシン上のすべてのプロジェクトで利用できます。

<Note>
  **Windows:** グローバル スキルのパスは、システムのアプリケーション データ ディレクトリに従います。Windows では、`~/.config/devin/skills/` の代わりに `%APPDATA%\devin\skills\<name>\SKILL.md` (通常は `C:\Users\<YourUser>\AppData\Roaming\devin\skills\<name>\SKILL.md`) を使用してください。
</Note>

***

<div id="next-steps">
  ## 次のステップ
</div>

<CardGroup cols={2}>
  <Card title="スキルの作成" icon="plus" href="/ja/cli/extensibility/skills/creating-skills">
    フロントマターのオプション、動的コンテンツ、使用例を含む、スキルの完全な構成について学びます。
  </Card>

  <Card title="プラグイン" icon="box" href="/ja/cli/extensibility/plugins/overview">
    スキルをプラグインとしてまとめることで、インストールして複数のプロジェクトで共有できます。
  </Card>
</CardGroup>