スキル
専門的なワークフロー向けの再利用可能な指示セットを作成します。カスタムワークフローを定義し、サポートファイルを追加し、一貫した結果のためにBobに専門タスクを教えます。
スキルは、Bobに新しいワークフローと専門的なタスクを教える再利用可能な指示セットです。特定の種類の作業を一貫して繰り返し可能な方法で完了するためにBobが従うレシピのようなものです。
なぜスキルを使うのか
- 再利用性: ワークフローを一度定義し、複数の会話で使用できます。
- 一貫性: 特定のタスクにおいてBobが毎回同じアプローチを取るようにします。
- 専門化: コードレビュー、テスト、ドキュメント作成などのためのドメイン固有の専門知識を作成します。
- チームコラボレーション: バージョン管理を通じてチームで標準化されたワークフローを共有します。
- 柔軟性: チェックリスト、テンプレート、参考資料などのサポートファイルを含めます。
要件
スキルはAdvancedモードでのみ利用可能です。これにより、Bobがスキルベースのワークフローを効果的に実行するために必要なすべてのツールにアクセスできるようになります。
スキルの仕組み
スキルを有効化すると、Bobはスキルの指示を受け取り、スキルディレクトリ内のサポートファイルにアクセスできるようになります。次にBobはこれらの指示に従い、定義されたワークフローに従ってタスクを完了します。
スキルは重複したプロンプトを避けるために会話ごとに一度読み込まれます。Bobはあなたのリクエストとスキルの説明に基づいて、スキルをいつ有効化するかを自動的に判断します。
スキルの作成
基本設定
プロジェクトルートの .bob/skills/ 内にフォルダを作成するか、グローバルスキルには ~/.bob/skills/ を使用します。
そのフォルダ内に SKILL.md ファイルを追加します。
構造の例:
SKILL.mdのフォーマット
SKILL.md ファイルはYAMLフロントマターの後にスキルの指示が続く形式です：
---
name: code-review
description: Review code for bugs, security issues, and best practices
---
When reviewing code, check for:
- Security vulnerabilities
- Performance issues
- Missing error handling at API boundaries
- Unused imports and dead code
Provide a summary with severity levels for each finding.必須フィールド:
name: Bobインターフェースで表示されるスキルの名前description: このスキルをいつ有効化するかをBobが判断するための明確な要約 — 説明のないスキルは無視されます
指示セクション:
--- デリミタの下にあるすべてのものが、スキルが有効化されたときにBobが受け取る指示になります。
サポートファイルの追加
SKILL.md の隣に参考資料、テンプレート、チェックリスト、スクリプト、その他のリソースを提供するための追加ファイルやサブフォルダを含めることができます。スキルが有効化されると、Bobはこれらのファイルを自動的に読むことができます。
サポートファイルを含む例:
サポートファイルとフォルダには以下を含めることができます：
- チェックリストとテンプレート
- 参考ドキュメント
- 設定例
- サブフォルダ内のスクリプトとユーティリティ
- スタイルガイド
- スキルに必要なその他のリソース
スキルの保存場所
スキルは2つのレベルで定義できます：
| 場所 | スコープ | 使用例 |
|---|---|---|
<project>/.bob/skills/ | プロジェクト固有 | このプロジェクト固有のワークフロー |
~/.bob/skills/ | グローバル | 個人または組織全体のワークフロー |
優先度: 両方の場所に同じ名前のスキルがある場合、プロジェクトレベルのスキルが優先されます。
スキルの承認
デフォルトでは、Bobはスキルを有効化する前に許可を求めます。これにより、専門的なワークフローが適用されるタイミングを制御できます。
承認プロンプトをスキップするには：
Bobの設定を開きます。
「自動承認」セクションに移動します。
Skills のトグルをオンにします。
この設定を有効にすると、Bobは許可を求めずに適切なタイミングで自動的にスキルを有効化します。
スキル設定タブ
Bobの設定のSkillsタブでは、ワークスペースで利用可能なスキルを表示・管理する一元的な場所を提供しています。どのスキルが読み込まれているかを確認し、場所を確認し、プロジェクトまたはグローバルディレクトリのスキルが正しく認識されていることを確認するために使用します。
効果的なスキルの書き方
明確な説明
スキルをいつ使用すべきかを明確に示す説明を書きます。Bobはこれらの説明を使ってスキルの関連性を判断します。
良い例: "Review code for bugs, security issues, and best practices"
避けるべき例: "Code review skill"
焦点を絞った指示
メインの SKILL.md ファイルをコアワークフローに集中させます。詳細な参考資料、例、チェックリストはサポートファイルに移動します。
例:
---
name: api-documentation
description: Generate API documentation following OpenAPI standards
---
Generate API documentation that includes:
- Endpoint descriptions
- Request/response schemas
- Authentication requirements
- Example requests and responses
Follow the style guide in `api-style-guide.md` and use the template in `api-template.md`.実行可能なステップ
BobがSystematicallyに従える明確で実行可能なステップとして指示を構造化します。
例:
---
name: feature-implementation
description: Implement new features following team standards
---
<Steps>
<Step>
Review the feature requirements.
</Step>
<Step>
Create a plan with file changes needed.
</Step>
<Step>
Implement the feature with tests.
</Step>
<Step>
Update documentation.
</Step>
<Step>
Verify all tests pass.
</Step>
</Steps>
Follow coding standards in `coding-standards.md`.スキルの例
コードレビュースキル
---
name: security-review
description: Review code for security vulnerabilities and best practices
---
Perform a security-focused code review:
<Steps>
<Step>
Check for common vulnerabilities:
- SQL injection risks
- XSS vulnerabilities
- Authentication/authorization issues
- Sensitive data exposure
</Step>
<Step>
Review security best practices:
- Input validation
- Output encoding
- Secure configuration
- Error handling
</Step>
<Step>
Provide findings with:
- Severity level (Critical, High, Medium, Low)
- Location in code
- Recommended fix
- Reference to security standards
</Step>
</Steps>
Use the severity guide in `severity-levels.md` for classification.ドキュメントスキル
---
name: api-docs
description: Generate comprehensive API documentation
---
Create API documentation that includes:
<Steps>
<Step>
Overview section:
- Purpose and use cases
- Authentication requirements
- Base URL and versioning
</Step>
<Step>
For each endpoint:
- HTTP method and path
- Description and purpose
- Request parameters
- Request body schema
- Response codes and schemas
- Example requests and responses
</Step>
<Step>
Additional sections:
- Error handling
- Rate limiting
- Pagination
</Step>
</Steps>
Follow the template in `api-doc-template.md` and examples in `api-examples.md`.ヒントとベストプラクティス
- シンプルに始める: 基本的な指示から始め、結果に基づいて改良します。
- サポートファイルを使用する: 詳細なコンテンツをコンパニオンファイルに移動することで
SKILL.mdを簡潔に保ちます。 - 十分にテストする: チームと共有する前にスキルが期待通りに機能することを確認します。
- バージョン管理: チームの一貫性のためにプロジェクトスキルをリポジトリに含めます。
- 明確な命名: スキルの目的を示す説明的なスキル名を使用します。
- 単一責任: 複数の無関係なワークフローを扱おうとせず、特定のタスクのための焦点を絞ったスキルを作成します。