菜单
.instructions.mdファイルを作成・編集する。frontmatter（applyTo）の設計、repo-wide vs path-specific の使い分け、glob パターンの書き方を支援。instructions.md作成、.instructions.md編集、.agent/instructions、.github/instructions、applyTo、globパターン、path-specific、repo-wideなどの言及時に使用。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | instruction-writing |
| description | .instructions.mdファイルを作成・編集する。frontmatter（applyTo）の設計、repo-wide vs path-specific の使い分け、glob パターンの書き方を支援。instructions.md作成、.instructions.md編集、.agent/instructions、.github/instructions、applyTo、globパターン、path-specific、repo-wideなどの言及時に使用。 |
| user-invokable | false |
VS Code Copilot 用の .instructions.md ファイルを作成・編集するためのガイド。ファイル編集時に自動適用される指示を定義する。
instructions は常時読み込み。特に圧縮重要。
作成・編集後は必ず圧縮レビュー実施（Reviewer モード・圧縮レビュー実施中は除く）:
ファイルパスのリンク化: 必須参照は [path](path)、補足情報は path のみ。詳細は copilot-instructions-maintenance
❌ applyTo を指定しない
applyTo: "**" で全ファイル、applyTo: "**/*.rb" でRubyファイルのみ❌ applyTo が広すぎる
app/**/*.rb など❌ 追跡対象（.github/instructions/）を直接編集
.agent/instructions/ に配置✅ 正しいやり方
.agent/instructions/ に配置| 種類 | ファイル | いつ使う | 編集可否 |
|---|---|---|---|
| repo-wide | .github/copilot-instructions.md | 全チャットに常時適用したい全体ルール | 提案のみ |
| path-specific (shared) | .github/instructions/*.instructions.md | チームで共有したいファイル種別ごとのルール | 提案のみ |
| path-specific (local) | .agent/instructions/*.instructions.md | 個人用のファイル種別ごとのルール | 直接編集OK |
---
applyTo: "**/*.rb" # 必須: 自動適用する glob パターン
name: Ruby Coding Guidelines # 任意: 表示名（省略時はファイル名）
description: Rubyコーディング規約 # 任意: 短い説明
---
| パターン | 対象 |
|---|---|
** | 全ファイル |
**/*.rb | 全Rubyファイル |
app/**/*.rb | app/配下のRubyファイル |
spec/**/*_spec.rb | specファイルのみ |
*.{js,ts,jsx,tsx} | JS/TSファイル |
app/frontend/** | フロントエンドディレクトリ配下 |
テンプレートからファイルを生成:
.agents/skills/99_instruction-writing/scripts/init_instruction.sh {instruction-name}
生成先: .agent/instructions/{instruction-name}.instructions.md
ファイル名にはプレフィックス（00_, 10_, 20_, 30_, 99_）を付けて分類します。
詳細: プレフィックス命名規則
❌ Bad: 追跡対象（.github/instructions/）を直接編集
❌ Bad: applyTo を省略して「手動で添付すればいい」と考える
✅ Good: ローカル用は .agent/instructions/ に配置
✅ Good: 追跡対象の変更は提案のみ
| 種類 | いつ使う |
|---|---|
| instructions | 常に自動適用される（コーディング規約、安全策、禁止事項） |
| prompts | 明示的に呼び出す（PR作成、Issue作成などの定型作業） |
| skills | キーワードで自動発火する知識（判断基準、ルール、落とし穴） |
applyTo を必ず設定し、対象を適切に絞って自動適用する。ローカル用は .agent/instructions/ に配置。
.agents/scripts/ や skills/*/scripts/ 配下のシェルスクリプトを作成・整備する。エージェントが実行する前提の統一ルール（shebang、エラーハンドリング、日本語コメント、ステップ分割）に従う。「.agents/scripts」「skills/*/scripts」「#!/bin/bash」「スクリプト作成」「スクリプトを整える」などの言及時に使用。
.agent.mdファイルを作成・編集する。frontmatter（tools, handoffs, model）の設計、エージェントの責務定義を支援。agent.md作成、.agent.md編集、.github/agents、カスタムエージェント、handoffs、tools、エージェント定義などの言及時に使用。
Copilot向け instructions/prompts/skills/agents の整備。`.github/agents`/`.agents` 配下の `*.instructions.md`/`*.prompt.md`/`*.agent.md`/`SKILL.md` を編集、追跡対象（`.github/copilot-instructions.md`等）は提案のみ。instructions整備、applyTo、excludeAgent、.git/info/exclude、ルール変更などで使用。
Agent Hook（.json）の作成・編集を行う。hookイベント、matcher、入出力フォーマット、exit code、設置場所の設計を支援する。hook作成、hooks、PreToolUse、PostToolUse、SessionStart、Stop、.github/hooks、/hooks、agent hook、hookファイルなどの言及時に使用。
VS Code用のprompt.mdファイルを作成・編集する。frontmatter（name/description/argument-hint必須）、本文の手順記述、skillとの役割分担を支援。prompt.md作成、.prompt.md編集、.agent/prompts、.github/prompts、プロンプトファイル、テンプレート利用などの言及時に使用。
スキル定義ファイル（SKILL.md）の作成・更新を支援する。frontmatter 設計、description のトリガーキーワード調整、本文構成、progressive disclosure 設計、発火テストを含む。スキル作成、SKILL.md、frontmatter、description、.agents/skills、発火しない、トリガーワード、name フィールド、スキル競合などの言及時に使用。