OpenCode: OpenCode Skills System
最終更新：2026-08-31
--- title: OpenCode Skillsと使用方法 description: Skillsシステムを学び、定義済みの専門的なワークフロー機能を習得する order: 18 lang: ja
SkillsはOpenCodeの定義済みスキルシステムで、AIに専門的なワークフローと知識を提供します。
1. 学習内容
- Skillsの概念と位置づけ
- 内蔵Skills一覧
- Skillsの読み込みと使用
- カスタムSkills開発
2. Skillsとは
Skillsは定義済みのプロンプトテンプレート＋ワークフロー＋ナレッジベースで、AIが特定領域で専門的な能力を獲得します。
| 特徴 | 説明 |
|---|---|
| オンデマンド読み込み | 事前読み込みなし、キーワードトリガー時のみ読み込み |
| テンプレート化 | 標準化されたワークフロー |
| 再利用可能 | 1つのSkillを複数プロジェクトで使用可能 |
| 拡張可能 | カスタムSkillsの開発が可能 |
3. Skillsトリガー機構
| トリガーキーワード | 読み込まれるSkill |
|---|---|
| "新規""開発""モジュール""機能" | brainstorming |
| "エラー""失敗""bug""異常" | systematic-debugging |
| 計画承認後 | writing-plans |
| "完了""修正済み" | verification-before-completion |
| スクリプト作成、ロジック変更 | test-driven-development |
| コミット前 | requesting-code-review |
| バッチ翻訳、多言語 | subagent-driven-development |
4. コアSkills
| Skill | 目的 |
|---|---|
| brainstorming | 創造的作業前に意図、ニーズ、設計を探索 |
| writing-plans | 仕様をステップバイステップの実装計画に変換 |
| executing-plans | 計画に従ってステップごとに実行、脱線防止 |
| systematic-debugging | 根因を理解してから修正——推測しない |
| test-driven-development | 失敗テスト作成→最小実装→通過（RED-GREEN-REFACTOR） |
| verification-before-completion | 完了宣言前に検証コマンドを実行——証拠が先、断言が後 |
| requesting-code-review | コミット前セキュリティスキャン＋品質ゲート＋自動修正 |
| subagent-driven-development | バッチタスク時にサブエージェントを並列実行 |
5. カスタムSkills
Skillsディレクトリ：~/.config/opencode/skills/（グローバル）または.opencode/skills/（プロジェクト）
各SkillはMarkdownファイルで、frontmatterで名前、説明、トリガーを定義し、本文にワークフロー手順を記述。
❓ FAQ
Q Skillsは自動読み込みされますか？
A いいえ。Skillsはタスクキーワードがマッチした時にオンデマンドで読み込まれます。これによりトークンを節約。
Q SkillsとAGENTS.mdの違いは？
A AGENTS.mdはプロジェクトルール（何をしないか）；Skillsはワークフロー（特定タスクのやり方）。両者は補完関係。
📖 まとめ
- Skillsは定義済みの専門的ワークフロー
- キーワードトリガーでオンデマンド読み込み
- コアSkills：brainstorming、debugging、TDD、verification等
- カスタムSkills開発に対応
- AGENTS.mdと補完：ルール＋ワークフロー
📝 練習問題
-
基本問題：TUIでbrainstorming Skillをトリガーし、構造化ブレインストーミングを体験してください。
-
応用問題：systematic-debugging Skillをトリガーし、体系的にバグをデバッグしてください。
-
チャレンジ問題：チーム固有のコードレビューワークフローを定義するカスタムSkillを開発してください。
