GitHub Copilot Agent Skills完全ガイド - 特化型AIスキルでエージェントを強化する

1
2
3
4
5
6
7
8

---
name: github-actions-debugging
description: GitHub Actionsワークフローのデバッグ手順を提供します。失敗したワークフローのログ分析、エラー原因の特定、修正方法の提案を行います。
license: MIT
metadata:
  author: your-team
  version: "1.0"
---

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

---
name: github-actions-debugging
description: GitHub Actionsワークフローのデバッグを支援します。失敗したワークフロー分析、ログ調査、修正方法の提案を行います。
---

# GitHub Actionsデバッグガイド

このスキルは、GitHub Actionsワークフローが失敗した際のデバッグ手順を提供します。

## 手順

1. GitHub MCP Serverの `list_workflow_runs` ツールでPRの最近のワークフロー実行状況を確認
2. `summarize_job_log_failures` ツールで失敗ジョブのAI要約を取得
3. 詳細が必要な場合は `get_job_logs` で完全なログを取得
4. ローカル環境で失敗を再現してテスト
5. 原因を特定し、修正を実施

## よくある失敗パターン

- **依存関係のインストール失敗**: package.jsonやrequirements.txtのバージョン不整合
- **テスト失敗**: 環境変数の未設定、シークレットの欠落
- **ビルドエラー**: Node.jsやPythonのバージョン不一致

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

#!/usr/bin/env python3
# scripts/analyze_workflow.py
"""GitHub Actionsワークフローの失敗ログを解析するスクリプト"""

import sys
import json

def analyze_log(log_content: str) -> dict:
    """ログ内容を解析してエラー情報を抽出"""
    errors = []
    for line in log_content.split('\n'):
        if 'error' in line.lower() or 'failed' in line.lower():
            errors.append(line.strip())
    return {'errors': errors, 'count': len(errors)}

if __name__ == '__main__':
    log = sys.stdin.read()
    result = analyze_log(log)
    print(json.dumps(result, indent=2))

1

mkdir -p .github/skills/code-review-checklist

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

---
name: code-review-checklist
description: コードレビュー時のチェックリストを提供します。セキュリティ、パフォーマンス、可読性の観点からコードを評価し、改善点を提案します。
---

# コードレビューチェックリスト

このスキルは、コードレビュー時に確認すべき項目を体系的に提供します。

## セキュリティチェック

- [ ] SQLインジェクション対策（パラメータ化クエリの使用）
- [ ] XSS対策（出力のエスケープ処理）
- [ ] 認証・認可の適切な実装
- [ ] シークレットのハードコーディング禁止
- [ ] 入力バリデーションの実施

## パフォーマンスチェック

- [ ] N+1クエリの有無
- [ ] 適切なインデックスの使用
- [ ] 不要なAPIコールの排除
- [ ] メモリリークの可能性

## 可読性チェック

- [ ] 命名規則の一貫性
- [ ] 適切なコメントの有無
- [ ] 関数の単一責任原則
- [ ] コードの重複排除

## レビュー結果の報告形式

レビュー結果は以下の形式でまとめてください：

\`\`\`markdown
## レビュー結果

### 重大な問題
- [問題の説明と修正方法]

### 改善提案
- [パフォーマンスや可読性の向上案]

### 良い点
- [評価できるポイント]
\`\`\`

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

---
name: github-actions-failure-debugging
description: GitHub Actionsワークフローの失敗をデバッグするためのガイドです。失敗したワークフローの分析を依頼された際に使用してください。
---

# GitHub Actionsデバッグガイド

GitHub Actionsワークフローが失敗した場合、以下のプロセスに従ってデバッグを行います。GitHub MCP Serverのツールを活用します。

## デバッグ手順

1. `list_workflow_runs` ツールでPRの最近のワークフロー実行と状態を確認
2. `summarize_job_log_failures` ツールで失敗ジョブのAI要約を取得（コンテキストウィンドウを節約）
3. 詳細が必要な場合は `get_job_logs` または `get_workflow_run_logs` で完全なログを取得
4. ローカル環境で失敗を再現
5. 原因を特定し、修正をコミット

## よくあるエラーパターン

### 依存関係エラー
- npm/yarnのロックファイル不整合
- Pythonパッケージのバージョン競合
- 対処: `npm ci` または `pip install --upgrade` を使用

### テスト失敗
- 環境変数の未設定
- シークレットの欠落
- タイムゾーン差異による日時テスト失敗
- 対処: ワークフローYAMLで環境変数を明示的に設定

### ビルドエラー
- ランタイムバージョンの不一致（Node.js、Python等）
- 対処: `.nvmrc` や `pyproject.toml` でバージョンを固定

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

---
name: api-documentation-generator
description: REST APIのドキュメントをOpenAPI仕様に準拠した形式で生成します。APIエンドポイントのドキュメント作成を依頼された際に使用してください。
---

# APIドキュメント生成ガイド

このスキルは、REST APIのドキュメントを標準的な形式で生成します。

## ドキュメント構造

各エンドポイントについて、以下の情報を含めてください：

### エンドポイント情報
- HTTPメソッド（GET, POST, PUT, DELETE, PATCH）
- パス（パスパラメータを `{id}` 形式で表記）
- 説明（エンドポイントの目的を簡潔に）

### リクエスト
- ヘッダー（必須/任意を明記）
- クエリパラメータ
- リクエストボディ（JSON Schema形式）

### レスポンス
- ステータスコードごとのレスポンス
- レスポンスボディのサンプル

## テンプレート

\`\`\`markdown
## [エンドポイント名]

[エンドポイントの説明]

### リクエスト

\`\`\`http
[METHOD] /api/v1/[path]
Content-Type: application/json
Authorization: Bearer {token}
\`\`\`

### パラメータ

| パラメータ | 型 | 必須 | 説明 |
|-----------|-----|------|------|
| id | string | Yes | リソースID |

### レスポンス

#### 200 OK

\`\`\`json
{
  "id": "abc123",
  "name": "Sample",
  "createdAt": "2026-01-09T12:00:00Z"
}
\`\`\`

#### 404 Not Found

\`\`\`json
{
  "error": "Resource not found",
  "code": "NOT_FOUND"
}
\`\`\`
\`\`\`

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

---
name: database-migration-safety
description: データベースマイグレーションの安全性を確保するためのガイドです。マイグレーションファイルの作成やレビューを依頼された際に使用してください。
---

# データベースマイグレーション安全ガイド

このスキルは、本番環境でも安全に適用できるマイグレーションの作成を支援します。

## 必須チェック項目

### ダウンタイム回避
- [ ] カラム追加は `NULL` 許容または `DEFAULT` 値付きで
- [ ] カラム削除は段階的に（1. コードから参照削除 → 2. カラム削除）
- [ ] インデックス作成は `CONCURRENTLY` オプションを使用（PostgreSQL）

### データ整合性
- [ ] 外部キー制約は既存データを確認してから追加
- [ ] `NOT NULL` 制約は既存データの処理後に追加
- [ ] トリガーの実行順序を確認

### ロールバック計画
- [ ] 各マイグレーションに対応するロールバックを用意
- [ ] ロールバック時のデータ損失範囲を明記

## 危険なパターン

### 即座にロックを取得する操作
\`\`\`sql
-- 危険: テーブル全体をロック
ALTER TABLE users ADD COLUMN email VARCHAR(255) NOT NULL;

-- 安全: NULL許容で追加後、データ移行、NOT NULL追加
ALTER TABLE users ADD COLUMN email VARCHAR(255);
UPDATE users SET email = 'default@example.com' WHERE email IS NULL;
ALTER TABLE users ALTER COLUMN email SET NOT NULL;
\`\`\`

### 大量データの更新
\`\`\`sql
-- 危険: 全行ロック
UPDATE users SET status = 'active';

-- 安全: バッチ処理
UPDATE users SET status = 'active' WHERE id BETWEEN 1 AND 10000;
UPDATE users SET status = 'active' WHERE id BETWEEN 10001 AND 20000;
-- ...
\`\`\`

1
2
3
4
5

# 悪い例
description: PDFを扱います。

# 良い例
description: PDFファイルからテキストとテーブルを抽出し、フォームの入力、複数PDFの結合を行います。PDFドキュメントの処理やフォーム入力を依頼された際に使用してください。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

#!/usr/bin/env python3
"""安全なスクリプトの例"""

import sys

def main():
    if len(sys.argv) < 2:
        print("Error: ファイルパスを指定してください", file=sys.stderr)
        print("Usage: script.py <file_path>", file=sys.stderr)
        sys.exit(1)
    
    file_path = sys.argv[1]
    try:
        with open(file_path, 'r') as f:
            content = f.read()
        # 処理を実行
        print(f"Processed {len(content)} characters")
    except FileNotFoundError:
        print(f"Error: ファイルが見つかりません: {file_path}", file=sys.stderr)
        sys.exit(1)
    except PermissionError:
        print(f"Error: ファイルの読み取り権限がありません: {file_path}", file=sys.stderr)
        sys.exit(1)

if __name__ == '__main__':
    main()

1
2
3
4
5

# skills-refライブラリをインストール
pip install skills-ref

# スキルを検証
skills-ref validate ./my-skill