菜单
.agent.mdファイルを作成・編集する。frontmatter（tools, handoffs, model）の設計、エージェントの責務定義を支援。agent.md作成、.agent.md編集、.github/agents、カスタムエージェント、handoffs、tools、エージェント定義などの言及時に使用。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | agent-writing |
| description | .agent.mdファイルを作成・編集する。frontmatter（tools, handoffs, model）の設計、エージェントの責務定義を支援。agent.md作成、.agent.md編集、.github/agents、カスタムエージェント、handoffs、tools、エージェント定義などの言及時に使用。 |
| user-invokable | false |
VS Code Copilot 用の .agent.md ファイルを作成・編集するためのガイド。特定の役割を持つカスタムエージェントを定義。
Agent 定義は「役割」と「参照先」が中心。詳細はスキル側に。
作成・編集後は必ず圧縮レビュー実施（Reviewer モード・圧縮レビュー実施中は除く）:
ファイルパスのリンク化: スキル参照（「xxxスキルに基づいて行動する」等）は必ず [skill-name](path) でリンク化。詳細は copilot-instructions-maintenance
❌ tools を多く指定しすぎる
❌ 本文に詳細を書きすぎる
❌ name/description が曖昧
✅ 正しいやり方
---
name: Agent Name # 任意: 表示名（省略時はファイル名）
description: エージェントの目的 # 推奨: 1文で役割を説明
argument-hint: 入力のヒント # 任意: チャット入力欄のヒント
tools: ['search', 'fetch'] # 任意: 利用可能なツール
model: Claude Sonnet 4 # 任意: 使用するモデル
handoffs: # 任意: 次のエージェントへの遷移
- label: Start Implementation
agent: implementation
prompt: Implement the plan.
send: false
---
| フィールド | 必須/任意 | 説明 |
|---|---|---|
name | 任意 | 表示名（省略時はファイル名） |
description | 推奨 | エージェントの目的（1文） |
argument-hint | 任意 | チャット入力欄のヒント |
tools | 任意 | 利用可能なツール/ツールセット |
model | 任意 | 使用するモデル |
infer | 任意 | サブエージェントとして使用可能か（デフォルト: true） |
handoffs | 任意 | 次のエージェントへの遷移定義 |
handoffs:
- label: Start Implementation # ボタンラベル
agent: implementation # 遷移先エージェント名
prompt: Implement the plan. # 遷移時のプロンプト
send: false # 自動送信するか（デフォルト: false）
テンプレートからファイルを生成:
.agents/skills/99_agent-writing/scripts/init_agent.sh {agent-name}
生成先: .github/agents/{agent-name}.agent.md
プレフィックスなし（例: reviewer.agent.md）
詳細: プレフィックス命名規則
エージェントは薄く保つ
責務を明確に
ツールを絞る
❌ Bad: エージェント本文にルールや知識を詰め込む
❌ Bad: tools に全ツールを指定
✅ Good: スキルへの参照を記述
{skill-name} スキルを参照」✅ Good: 役割に必要な最小限の tools のみ
---
name: Plan
description: 実装計画を作成するエージェント
tools: ['search', 'fetch', 'githubRepo', 'usages']
handoffs:
- label: Implement Plan
agent: agent
prompt: Implement the plan outlined above.
send: false
---
---
name: Reviewer
description: コードレビューに特化したエージェント
tools: ['search', 'githubRepo']
---
エージェントは薄く保ち、詳細は skill に分離。tools は必要最小限に絞る。
.agents/scripts/ や skills/*/scripts/ 配下のシェルスクリプトを作成・整備する。エージェントが実行する前提の統一ルール（shebang、エラーハンドリング、日本語コメント、ステップ分割）に従う。「.agents/scripts」「skills/*/scripts」「#!/bin/bash」「スクリプト作成」「スクリプトを整える」などの言及時に使用。
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ファイルなどの言及時に使用。
.instructions.mdファイルを作成・編集する。frontmatter（applyTo）の設計、repo-wide vs path-specific の使い分け、glob パターンの書き方を支援。instructions.md作成、.instructions.md編集、.agent/instructions、.github/instructions、applyTo、globパターン、path-specific、repo-wideなどの言及時に使用。
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 フィールド、スキル競合などの言及時に使用。