Prompt Files（Slash Commands）作成スキル（VS Code / GitHub Copilot）
このSkillは、VS Code の prompt files（.prompt.md）を、再利用可能なスラッシュコマンドとして設計し、ワークスペースへ追加する。
まず決める（最小）
- •目的: 1回の実行で完結する、繰り返しタスクにする（例: 雛形生成、レビュー、要約、チェックリスト適用）
- •入力: チャット入力の追加文 /
${selection}/${file}/${input:...}のどれを使うか - •出力: 期待する形式（箇条書き、差分、ファイル作成、コマンド列など）を明記する
使い分け（重要）
- •prompt files: 単発で繰り返す作業を
/で呼び出す - •custom agents: 継続的な人格/役割や、複数ツールを使った長いワークフロー向け
作成フロー
1) 置き場所を選ぶ
ワークスペース内の標準配置は次の通り:
- •
.github/prompts/（ワークスペース限定）
補足: 追加の配置場所は chat.promptFilesLocations 設定で増やせる。
2) ファイル名（= 既定の / コマンド名）を決める
- •迷ったら
kebab-caseを使う（例:review-pr.prompt.md） - •YAML の
nameを省略すると ファイル名が / 名として使われる
3) YAML frontmatter を書く（必要最小限）
最低限は description だけでもよい。
- •
description: 何をする prompt か - •
argument-hint: 入力欄に表示するヒント（例:topic=... output=...） - •
agent: 実行するエージェント（未指定なら現在のエージェント） - •
tools: 使えるツールのリスト（指定すると tool 制約がかかる） - •
model: 使用モデル（未指定なら model picker の選択）
ツールの優先順位（競合時）:
- •prompt file の
tools - •prompt file が参照する custom agent の
tools - •現在選択中エージェントの既定ツール
4) 本文（プロンプト）を書く
- •指示は短く、出力形式と手順を優先する
- •既存の規約は
.github/copilot-instructions.mdや.instructions.mdに寄せ、prompt file では そのタスク固有に集中する - •他ファイルを参照したい場合は、prompt file から 相対パスの Markdown リンクで参照する
5) ツールと変数を活用する
- •変数:
${selection}/${fileBasename}/${workspaceFolder}/${input:name}など - •ツール参照:
#tool:<tool-name>（本文中で明示したい場合）
6) テストとデバッグ
- •prompt file をエディタで開き、右上の実行（再生）でテストする
- •Chat で
/を入力して候補に出るか確認する - •期待通りに適用されない場合は Chat の Diagnostics（Configure Chat → Diagnostics）で読み込み状況とエラーを見る
期待する出力
- •
.github/prompts/<name>.prompt.mdの新規作成、または既存 prompt file の改善 - •変更時は「何をどう変えたか（入力/出力/ツール/安全性）」を短く添える
テンプレとチェックリスト
- •すぐ使える雛形: references/TEMPLATES.md