# Shiiman Github:setup

> GitHub 設定ファイルをセットアップする。「GitHub 設定をセットアップ」「.github を作って」「Issue テンプレート作成」「PR テンプレート作成」「GitHub 設定を初期化」「リポジトリ設定をセットアップ」「ラベル設定を作成」などで起動。.github ディレクトリに必要な設定ファイルを一括生成。「何が作られるか確認」と伝えれば生成予定の一覧表示のみ行う。

- Skill: `shiiman/shiiman-github-setup` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add shiiman/shiiman-github-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/shiiman/shiiman-github-setup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: shiiman (https://skillmd.com/u/shiiman)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/shiiman/shiiman-github-setup

---


# Setup GitHub

プロジェクトの `.github` ディレクトリに GitHub 設定ファイルを一括生成します。

## Help

`$ARGUMENTS` に `--help` が含まれる場合、以下を表示して終了:

```text
/shiiman-github:setup - GitHub 設定セットアップ

概要:
  .github ディレクトリに Issue テンプレート、PR テンプレート、
  ラベル定義、GitHub Actions workflow を一括生成する。

使用方法:
  /shiiman-github:setup

オプション:
  --help  このヘルプを表示

実行モードの伝え方（フラグの代わり）:
  「確認だけ」「何が作られるか見たい」  → 生成予定のファイル一覧のみ表示（生成しない）
  指定なし                             → ファイルを生成（既存ファイルは確認してから上書き）

例:
  /shiiman-github:setup           # 設定ファイルを生成
  「何が作られるか先に見せて」      # 生成予定のファイルを確認
```

## 起動時の自動判断（フラグの代わり）

引数・発話から実行モードを判定する。明示がなければ「生成」とする。

| モード | 条件                                       | 動作                                            |
| ------ | ------------------------------------------ | ----------------------------------------------- |
| 確認   | 「確認だけ」「見せて」「プレビュー」等あり | 生成予定のファイル一覧のみ表示して終了          |
| 生成   | 既定                                       | ファイルを生成（既存は AskUserQuestion で確認） |

## 生成されるファイル

| ファイル                                     | 説明                       |
| -------------------------------------------- | -------------------------- |
| `.github/ISSUE_TEMPLATE/config.yml`          | Issue テンプレート設定     |
| `.github/ISSUE_TEMPLATE/bug-report.yml`      | バグ報告テンプレート       |
| `.github/ISSUE_TEMPLATE/feature-request.yml` | 機能リクエストテンプレート |
| `.github/ISSUE_TEMPLATE/improvement.yml`     | 改善提案テンプレート       |
| `.github/pull_request_template.md`           | PR テンプレート            |
| `.github/copilot-instructions.md`            | GitHub Copilot 設定        |
| `.github/labels.yml`                         | ラベル定義                 |
| `.github/labeler.yml`                        | 自動ラベル付けルール       |
| `.github/workflows/sync-labels.yml`          | ラベル同期 workflow        |
| `.github/workflows/labeler.yml`              | 自動ラベル付け workflow    |

## 実行手順

### ステップ 1: 事前確認

1. `.github` ディレクトリの存在確認
2. 既存ファイルの有無をチェック

**既存ファイルがある場合**:

`AskUserQuestion` で上書き可否を必ず確認する（既存設定を失う不可逆操作のため）。

```text
question: "既存の .github 設定ファイルがあります。どうしますか？"
options:
  - 上書きする: 既存ファイルを生成内容で置き換える
  - 既存を残す: 既存ファイルはスキップし、未作成のファイルのみ生成
  - 中止する: 生成を行わず終了
```

### ステップ 2: プロジェクト情報収集

ユーザーに以下を確認:

1. **プロジェクト名**（リポジトリ名から推測、確認）
2. **プロジェクトタイプ**（選択肢を提示）
   - Web アプリ (React/Vue/etc.)
   - バックエンド (Node.js/Go/Python/etc.)
   - ライブラリ/パッケージ
   - CLI ツール
   - その他

### ステップ 3: テンプレート読み込み

`skills/setup/assets/` からテンプレートを読み込み、プロジェクト情報で変数を置換。

**置換する変数**:

| 変数               | 説明               |
| ------------------ | ------------------ |
| `{{REPO}}`         | リポジトリ名       |
| `{{OWNER}}`        | リポジトリオーナー |
| `{{PROJECT_TYPE}}` | プロジェクトタイプ |

### ステップ 4: ファイル生成

以下の順序で生成:

1. `.github/` ディレクトリ作成（なければ）
2. `.github/ISSUE_TEMPLATE/` ディレクトリ作成
3. `.github/workflows/` ディレクトリ作成
4. 各テンプレートファイルを生成

### ステップ 5: 完了報告

生成されたファイル一覧と次のステップを表示:

```
## 生成完了

以下のファイルを生成しました:

- .github/ISSUE_TEMPLATE/config.yml
- .github/ISSUE_TEMPLATE/bug-report.yml
- .github/ISSUE_TEMPLATE/feature-request.yml
- .github/ISSUE_TEMPLATE/improvement.yml
- .github/pull_request_template.md
- .github/copilot-instructions.md
- .github/labels.yml
- .github/labeler.yml
- .github/workflows/sync-labels.yml
- .github/workflows/labeler.yml

## 次のステップ

1. 各テンプレートをプロジェクトに合わせてカスタマイズ
2. `git add .github && git commit -m "chore: GitHub 設定ファイルを追加"`
3. GitHub にプッシュしてラベル同期を実行
```

## 生成ファイルのテンプレート

テンプレートファイルは `assets/` ディレクトリに配置:

- `assets/ISSUE_TEMPLATE/` - Issue テンプレート
- `assets/pull_request_template.md` - PR テンプレート
- `assets/copilot-instructions.md` - Copilot 設定
- `assets/labels.yml` - ラベル定義
- `assets/labeler.yml` - 自動ラベル付けルール
- `assets/workflows/` - GitHub Actions workflow

## 重要な注意事項

- ✅ テンプレートは汎用的な内容なので、プロジェクトに合わせて調整が必要
- ✅ ラベル同期 workflow は main ブランチへのプッシュ時に実行される
- ❌ 既存の設定ファイルを無断で上書きしない