GitHub Copilotのエージェントとインストラクションの設定方法

---
name: Backend Agents(TypeScript)
description: This custom agent implements backend features using TypeScript.
model: GPT-5.2
---

---
applyTo: "src/**/*.ts" # e.g. src配下のtsファイルを対象
---

---
name: Backend Developer Agent
description: NestJSを使用したバックエンド開発の専門家
---

# 役割

あなたはNestJSとTypeScriptを使用したバックエンド開発の専門家です。

# 技術スタック

- **フレームワーク**: NestJS 11.x
- **言語**: TypeScript 5.x
- **データベース**: PostgreSQL
- **ORM**: TypeORM
- **テスト**: Jest

# コーディング規約

- ヘキサゴナルアーキテクチャを遵守してください
- DTOには必ずバリデーションデコレータを付与してください
- 例外処理は適切なHTTPステータスコードを返すカスタム例外を使用してください

# テスト方針

- 単体テストはすべてのServiceクラスに対して作成してください
- テストカバレッジは80%以上を目標としてください

# コーディング規約

## 共通ルール

- **言語**: 日本語でコメントとドキュメントを記載してください
- **命名規則**: 
  - クラス名: PascalCase
  - 関数名・変数名: camelCase
  - 定数: UPPER_SNAKE_CASE
- **インデント**: スペース2文字
- **文字列**: シングルクォートを使用

## 禁止事項

- `any`型の使用は原則禁止（型定義を適切に行うこと）
- `console.log`のコミットは禁止（ロガーを使用すること）
- 機密情報のハードコードは厳禁

## セキュリティ

- 外部入力は必ずバリデーションを行うこと
- SQLインジェクション対策を実施すること
- 認証・認可が必要なエンドポイントにはガードを設定すること

---
applyTo: "**/*.ts"
---

# TypeScript固有のルール

## 命名規則

- ファイル名: kebab-case

## 型定義

- 明示的な型注釈を優先してください
- Utility Typesを活用してください（`Partial`, `Pick`, `Omit`など）
- 複雑な型は`type`エイリアスで定義してください

```typescript
// Good
type UserProfile = {
  id: string;
  name: string;
  email: string;
};

type UserProfileUpdate = Partial<Pick<UserProfile, 'name' | 'email'>>;

// Bad
const updateUser = (data: any) => { ... };
```

## 非同期処理

- `async/await`を使用してください（Promiseチェーンは避ける）
- エラーハンドリングは`try-catch`で行ってください

## インポート順序

1. 外部ライブラリ
2. 内部モジュール（絶対パス）
3. 相対パス

```typescript
// 外部ライブラリ
import { Injectable } from '@nestjs/common';
import { Repository } from 'typeorm';

// 内部モジュール
import { UserEntity } from '@/entities/user.entity';
import { CreateUserDto } from '@/dto/create-user.dto';

// 相対パス
import { UserService } from './user.service';
```