Copilot Customization

GitHub Copilot Customization Files

このスキルは、GitHub Copilotのカスタマイゼーションファイル（プロンプト、エージェント、インストラクション、スキル）の作成を支援します。

いつこのスキルを使用するか

以下の場合に本スキルを活用してください:

• 再利用可能なプロンプトファイル（.prompt.md）を作成する
• カスタムエージェント（.agent.md）を定義する
• ファイル固有のインストラクション（.instructions.md）を設定する
• Agent Skills（SKILL.md）を実装する
• プロジェクト固有の開発ワークフローを自動化する

ファイルタイプ別ガイド

1. プロンプトファイル（.prompt.md）

用途: 再利用可能な質問・タスクのテンプレート

作成場所: .github/prompts/

必須要素:

• Markdown front matter（YAML）
• description: プロンプトの説明（シングルクォート）

オプション要素:

• agent: 実行エージェント（ask、edit、agent、またはカスタムエージェント名）
• name: UI表示名（未指定時はファイル名）
• argument-hint: チャット入力欄に表示するヒント
• tools: 利用可能なツール一覧
• model: 使用するAIモデル

テンプレート: prompt-template.md

例:

---
description: 'コードレビューを実行し、品質とセキュリティの問題を特定'
agent: 'ask'
name: 'code-review'
argument-hint: 'レビュー対象のファイルまたはコードを入力'
tools: ['codebase', 'terminalCommand']
model: 'claude-sonnet-4.5'
---

# コードレビュープロンプト

指定されたファイルについて、以下の観点でレビューを実行してください:

1. コード品質
2. セキュリティ脆弱性
3. パフォーマンス最適化の機会
4. ベストプラクティス遵守

レビュー結果は優先度別に整理して報告してください。

2. エージェントファイル（.agent.md）

用途: 特定タスクに特化した自律エージェント

作成場所: .github/agents/

必須要素:

• Markdown front matter（YAML）
• description: エージェントの説明（シングルクォート）

オプション要素:

• name: UI表示名（未指定時はファイル名）
• tools: 利用可能なツール一覧
• model: 使用するAIモデル
• infer: サブエージェントとして使用（デフォルト: true）
• target: 対象環境（vscode または github-copilot）
• mcp-servers: MCPサーバー設定（JSON形式）
• handoffs: エージェント間の遷移定義

テンプレート: agent-template.md

例:

---
description: 'TypeScript MCPサーバー開発の専門アシスタント'
name: 'typescript-mcp-expert'
tools: ['codebase', 'terminalCommand', 'editFiles', 'search']
model: 'claude-sonnet-4.5'
infer: true
target: 'vscode'
handoffs:
  - label: 'プロンプトを実行'
    agent: 'generate-typescript-mcp-server'
    prompt: 'TypeScript MCPサーバーの包括的な実装を生成'
    send: false
---

# TypeScript MCP エキスパート

あなたは、TypeScript SDKを使用してMCPサーバーを構築する専門家です。

## 専門領域
- TypeScript/Node.js開発
- zodバリデーション
- Express統合
- MCP Inspector使用

3. インストラクションファイル（.instructions.md）

用途: ファイルタイプ別のコーディング規約・ガイドライン

作成場所: .github/instructions/

必須要素:

• Markdown front matter（YAML）
• description: インストラクションの説明（シングルクォート）

オプション要素:

• name: UI表示名（未指定時はファイル名）
• applyTo: 適用対象ファイルパターン（globパターン）。未指定時は手動追加のみ

テンプレート: instructions-template.md

例:

---
description: 'Python MCPサーバー開発のコーディング規約'
name: 'python-mcp-guidelines'
applyTo: '**/*.py, **/pyproject.toml'
---

# Python MCP Server 開発ガイドライン

## 必須要件

- Python 3.10以上を使用
- uvでプロジェクト管理
- 型ヒントは必須
- Pydanticモデルで構造化出力

4. Agent Skills（SKILL.md）

用途: ツール、スクリプト、リソースを含む専門的なワークフロー

作成場所: .github/skills/<skill-name>/SKILL.md

必須要素:

• Markdown front matter（YAML）
• name: スキル名（小文字、ハイフン区切り、最大64文字）
• description: スキルの説明（最大1024文字）

構造:

.github/skills/
  └── my-skill/
      ├── SKILL.md          # メインスキルファイル
      ├── templates/        # テンプレートファイル
      ├── examples/         # サンプルコード
      └── scripts/          # 実行スクリプト

テンプレート: skill-template.md

ベストプラクティス

命名規約

ファイル名: 小文字、ハイフン区切り

• ✅ generate-mcp-server.prompt.md
• ✅ python-best-practices.instructions.md
• ❌ GenerateMCP.prompt.md
• ❌ python_instructions.md

スキル名: 小文字、ハイフン区切り、最大64文字

• ✅ python-mcp-development
• ✅ cpp14-code-review
• ❌ PythonMCPDev
• ❌ python_mcp_development

Description フィールド

要件:

• シングルクォートで囲む
• 空でない
• 明確で具体的
• 使用タイミングを含める

良い例:

description: 'Guide for building MCP servers using Python SDK. Use this when creating, debugging, or optimizing Python-based MCP servers.'

悪い例:

description: "Python MCP"  # ダブルクォート、詳細不足

Tools 指定（推奨）

プロンプト・エージェントで使用するツールを明示:

tools: ['codebase', 'terminalCommand', 'editFiles', 'search']

MCPサーバーのツールを含める場合は <server name>/* 形式を使用:

tools: ['codebase', 'my-mcp-server/*']

Model 指定（強く推奨）

最適化されているモデルを指定:

model: 'claude-sonnet-4.5'

段階的作成ワークフロー

ステップ1: 要件定義

質問:
- 何を自動化したいか?
- 誰が使うか?
- どのファイルに適用するか?
- 必要なツールは?

ステップ2: ファイルタイプ選択

ステップ3: テンプレート使用

テンプレート集から適切なテンプレートを選択し、カスタマイズ。

ステップ4: 検証

• Front matterが正しいYAML形式
• 必須フィールドが存在（descriptionなど）
• ファイル名が命名規約に準拠
• applyTo（インストラクション）が正しいglobパターン
• 説明が具体的で有用

ステップ5: テスト

• プロンプト: VS Code Copilot Chatで#<prompt-name>を実行
• エージェント: @<agent-name>で呼び出し
• インストラクション: 対象ファイルで動作確認
• スキル: Copilot Chatが自動的にスキルを提案することを確認

実装例

例1: テストコード生成プロンプト

generate-tests.prompt.md

例2: ドキュメント生成エージェント

doc-generator.agent.md

例3: TypeScript コーディング規約

typescript.instructions.md

例4: Python MCP開発スキル

python-mcp-development/SKILL.md

トラブルシューティング

問題1: Front matterエラー

症状: YAMLパースエラー

解決策:

• ダブルクォートではなくシングルクォートを使用
• インデントをスペース2つで統一
• ---の前後に余計な空白を入れない

問題2: プロンプトが認識されない

症状: #<prompt-name>で呼び出せない

解決策:

• ファイル名が.prompt.mdで終わるか確認
• .github/prompts/ディレクトリに配置
• VS Code を再読み込み

問題3: インストラクションが適用されない

症状: 対象ファイルで有効にならない

解決策:

• applyToのglobパターンを確認（'**/*.py'など）
• 複数パターンはカンマ区切り: '**/*.ts, **/*.js'

参考リソース

• VS Code プロンプトファイル
• VS Code カスタムエージェント
• VS Code カスタムインストラクション
• VS Code Agent Skills
• Agent Skills 仕様
• Awesome Copilot
• テンプレート集

次のステップ

1. テンプレートから開始
2. 要件に応じてカスタマイズ
3. .github/配下の適切なディレクトリに配置
4. VS Code Copilot Chatでテスト
5. チーム・コミュニティと共有

カスタマイゼーションファイル作成のサポートが必要な場合は、関連エージェント generate-customization-md を使用してください。