← ガイド · English · Português · 中文

更新 2026-11-19

このページの目次
  1. なぜ skills が今いちばん重要な層なのか
  2. ステップ 1 — skills の置き場所
  3. ステップ 2 — SKILL.md の契約
  4. ステップ 3 — 3 つの呼び出し経路
  5. ステップ 4 — ライブラリを育てる
  6. 実録ウォークスルー — リポジトリスキルを実際に起動、Devin CLI v3000.14(swe-2-flash-medium)で収録
  7. 検証チェックリスト
  8. 落とし穴
  9. 理解度チェック
  10. 出典

ガイド 17 — Skills と plugins:playbook の次のパッケージング層

目標: 組織の反復手順を SKILL.md としてエンコードし、すべてのセッションと Bot が同じ手順で実行するようにする — plugins でリポジトリをまたいで共有する。 レベル: 中級 · playbook に取って代わった層 出典: docs.devin.ai/product-guides/skills · release notes · ガイド 9 の続編

なぜ skills が今いちばん重要な層なのか

Playbook は Skills へ移行中です:アカウントは順次移行され、2026-10-24 以降の新規アカウントは Skills のみ — 各 playbook は同じ org/enterprise スコープの skill になります。Skills はオープンな Agent Skills 標準に従うため、同じファイルが他のコーディング agent でも動きます。playbook を書く知識はそのまま使えます。変わるのはファイル形式と発見の仕組みだけです。

成果物 置き場所 最適な用途
Knowledge Customize ページ / リポジトリノート 常駐コンテキスト — Devin が知り得ない事実
Bot instructions Bot 本体 一人の「従業員」への職務規定
Skill リポジトリの SKILL.md、または plugin 名前付きの呼び出し可能な手順
Rule Plugin 常時有効な制約("never force-push")
Hook Plugin ツール呼び出しを巡る決定的な強制

ステップ 1 — skills の置き場所

自動発見されるソースは2つ:

  1. リポジトリ — SKILL.md をコミット。Devin は接続済みの全リポジトリで 10 個のベンダーパスをスキャンします:.agents/skills/(推奨)、.devin/skills/、.github/skills/、.claude/skills/、.cognition/skills/、.windsurf/skills/、.cursor/skills/、.codex/skills/、.codeium/skills/、.kiro/skills/。リポジトリの skill はブランチ版管理 — セッション途中の clone も完了時にスキャンされます。
  2. Plugins — plugin は skills + rules + MCP servers + hooks を束ね、personal・organization・enterprise スコープにインストールできます。同梱の skills はリポジトリの clone 前からコンテキストに入ります。

ステップ 2 — SKILL.md の契約

---
name: test-before-pr
description: Run the dev server and verify pages before any frontend PR.
argument-hint: <environment>
triggers: ["user"]
allowed-tools: read, grep, glob
permissions:
  allow: ["Exec(npm run *)"]
---

## Setup
1. `docker-compose up -d postgres` && `npm run dev`
## Verify
1. Open each page touched by the diff
2. Screenshot at 1280px and 375px

挙動を変える frontmatter フィールド:

ステップ 3 — 3 つの呼び出し経路

ステップ 4 — ライブラリを育てる

実録ウォークスルー — リポジトリスキルを実際に起動、Devin CLI v3000.14(swe-2-flash-medium)で収録

ステップ 3 の 明示的 な経路を端から端まで:デモリポジトリに .devin/skills/coverage-check/SKILL.md をコミットし、新しいセッションで起動。発見はドキュメント通り——/ を打つとスキルが名前で列挙され、description が補完の説明文になる。

動画(60 秒、無音): SKILL.md → スラッシュ補完 → Invoked skill coverage-check → 承認 → レポート。

スキルのレポート — app.py と orders.py の関数別カバレッジ表

1. ディスク上のスキル — frontmatter の name/description と番号付き手順 1. ディスク上のスキル — .devin/skills/coverage-check/SKILL.md:frontmatter name/description と番号付き手順

2. / でスキルが列挙される — 名前 + description が補完エントリ 2. / でスキルが列挙される — 発見で読み込まれるのは名前 + description そのもの

3. Invoked skill coverage-check — 最初のコマンドも Allow 待ち 3. Invoked skill coverage-check — 最初のコマンドにも Allow が必要

4. 手順がそのまま実行される — unittest を走らせ、全ソース/テストファイルを読む 4. 手順がそのまま実行される — python3 -m unittest -v、続いて app.py・orders.py・両テストファイルを読む

5. 結果:フルカバレッジ — 全ブランチを挙げた関数別表;ファイル無変更、コミットなし 5. 結果:フルカバレッジ — SKILL.md が要求した通りのレポート

検証チェックリスト

落とし穴

理解度チェック

  1. なぜ description が skill 本文より重要?(セッション開始時に読まれる唯一のテキストであり、自動呼び出しを駆動するから。本文は skill が選ばれた後にのみ読まれる。)
  2. 手順をリポジトリ skill ではなく plugin skill にすべき場面は?(スコープ内の全リポジトリ/セッションが必要とするとき — plugin は clone 前に読み込まれ、ブランチごとのドリフトも起きない。)
  3. 破壊的ステップを含む skill を安全にするには?(triggers:["user"] で明示呼び出しのみにし、危険なツール matcher に permissions.ask を付ける。)

出典