setup-github

GitHub セットアップアシスタント

リポジトリの GitHub 環境全体（プロジェクトボード、ラベル、Actions ワークフロー）をセットアップします。各フェーズは冪等性を備えており、既存の設定を検出してスキップします。

npx でインストール：

npx skills add fellowship-dev/dogfooded-skills/skills/ops/setup-github

重要：Claude を利用するワークフローをインストールする前に、Claude GitHub App がインストールされていることを必ず確認してください（https://github.com/apps/claude）。インストールされていないと、ワークフローは認証エラーで失敗します。

使用するタイミング

• 新しいリポジトリの GitHub 環境を最初から最後までセットアップするとき
• 自動レビューのパイプライン（double-check → cto-review）を追加するとき
• ワークフロー追跡用の標準ラベルを作成するとき
• CI/CD ワークフローをインストールするとき

レビューパイプライン

このスキルでは、3 段階の自動 PR レビューパイプラインをセットアップします。

1. PR opened
        ↓
2. GitHub Actions: claude-code-review.yml
   - Claude reviews the diff
   - Applies "reviewed" label
        ↓
3. event-rules.yml: review-pr-on-reviewed
   - /double-check PR_NUMBER org/repo dispatched
   - Curates CI findings, fixes must-fix items
   - Applies "double-checked" label
        ↓
4. event-rules.yml: cto-review-on-double-checked
   - /cto-review PR_NUMBER org/repo dispatched
   - Docs/deps/downstream checklist
   - Applies "approved" or "needs-work" label
   - Merges if approved

ステージ 3〜4 を担うスキル：fellowship-dev/dogfooded-skills の double-check と cto-review。

---

前提条件：Claude GitHub App

Claude を利用するワークフローを使用する前に、Claude GitHub App をインストールしてください。

1. インストール：https://github.com/apps/claude — リポジトリまたは組織を選択します

2. 認証（いずれか 1 つを選択）：

   オプション A：Claude CLI 経由の OAuth トークン（推奨）

   unset GH_TOKEN
   gh auth login
   claude
   /install-github-app
   # Select repo → "long-lived token" → auto-adds CLAUDE_CODE_OAUTH_TOKEN secret
   

   オプション B：API キー

   • キーを取得：https://console.anthropic.com/settings/keys
   • シークレット ANTHROPIC_API_KEY として追加：https://github.com/{owner}/{repo}/settings/secrets/actions

---

手順

1. 検出フェーズ

リポジトリを分析します。

# Repo identity
gh repo view --json nameWithOwner

# Existing labels
gh label list --repo $REPO --json name

# Existing workflows
ls .github/workflows/ 2>/dev/null || echo "No workflows"

# Project board
gh project list --owner $ORG --format json 2>/dev/null | head -20

存在するものと不足しているものを示すステータステーブルを報告します。

2. ラベルフェーズ

既存のラベルはスキップします（冪等性）。gh label create で作成します。

ワークフローラベル（PR パイプライン用）：

ラベル	色	説明
reviewed	#3da46e	CI／自動レビュー完了
double-checked	#0075ca	全体レビューと修正完了
approved	#0e8a16	CTO 承認済み — マージ可能
needs-work	#d93f0b	マージ前に対応が必要
ready-to-work	#f6a80a	実装準備完了
in-progress	#97f157	作業中

タイプラベル：

ラベル	色	説明
bug	#d73a4a	正常に動作していません
enhancement	#54d9ee	新機能または改善
documentation	#0075ca	ドキュメントのみ
groundwork	#C5DEF5	インフラ／ツール／リファクタリング

# Create all labels (idempotent — 2>/dev/null suppresses "already exists" errors)
gh label create "reviewed" --repo $REPO --color "3da46e" --description "CI/automated review complete" 2>/dev/null || true
gh label create "double-checked" --repo $REPO --color "0075ca" --description "Full review + fixes complete" 2>/dev/null || true
gh label create "approved" --repo $REPO --color "0e8a16" --description "CTO approved — ready to merge" 2>/dev/null || true
gh label create "needs-work" --repo $REPO --color "d93f0b" --description "Needs work before merge" 2>/dev/null || true
gh label create "ready-to-work" --repo $REPO --color "f6a80a" --description "Ready for implementation" 2>/dev/null || true
gh label create "in-progress" --repo $REPO --color "97f157" --description "Actively being worked on" 2>/dev/null || true
gh label create "bug" --repo $REPO --color "d73a4a" --description "Something isn't working" 2>/dev/null || true
gh label create "enhancement" --repo $REPO --color "54d9ee" --description "New feature or improvement" 2>/dev/null || true
gh label create "documentation" --repo $REPO --color "0075ca" --description "Documentation only" 2>/dev/null || true
gh label create "groundwork" --repo $REPO --color "C5DEF5" --description "Infra/tooling/refactoring" 2>/dev/null || true

「N 個のラベルを作成し、N 個をスキップしました（既存）。」と報告します。

3. プロジェクトボードフェーズ

このリポジトリに GitHub Project がすでに存在する場合はスキップします。

# Create project
gh project create --owner $ORG --title "$REPO_NAME"

# Add Status field with standard columns
# (Use GitHub UI to configure Status options — API support is limited)
# Columns: Backlog → Ready → In Progress → In Review → Done

# Link repo to project
gh project link $PROJECT_NUMBER --owner $ORG --repo $REPO

注：GitHub Projects の UI で自動移動の自動化を設定します。

• PR が開かれたときに「In Review」に自動移動
• PR がマージされたとき、または issue がクローズされたときに「Done」に自動移動

4. ワークフローのインストールフェーズ

.github/workflows/ にすでに存在するワークフローはスキップします。

利用可能なワークフローを提示し、確認を待ちます。

AI を活用したワークフロー（Claude GitHub App が必要）

• claude-code-review.yml — PR を自動レビューします。reviewed ラベルを追加します。推奨 — これが完全なレビューパイプラインを開始します。
• claude-issue-triage.yml — 新しい issue に自動でラベルを付けます
• claude-prd-creation.yml — 機能リクエストから PRD を生成します

デプロイワークフロー

• deploy-fly.yml — Fly.io にデプロイします
• deploy-ecs-production.yml — AWS ECS にデプロイします（本番環境）
• deploy-ecs-staging.yml — AWS ECS にデプロイします（ステージング環境）
• deploy-mkdocs.yml — ドキュメントをビルドし、GitHub Pages にデプロイします

メンテナンス

• dependabot.yml — 依存関係を自動更新します（週次）
• sync-api-docs.yml — ドキュメントを別のリポジトリに同期します

確認後、選択したワークフローをインストールします。

mkdir -p .github/workflows
# Copy selected templates from this skill's templates/ directory
# Skip if file already exists

5. まとめフェーズ

## GitHub Setup Complete: $REPO

### Labels
- ✅ Created N labels, skipped N (already existed)

### Project Board
- ✅ Created "$REPO_NAME" project (or "Skipped — already exists")
  ⚠️ Configure automations manually in project settings

### Workflows
- ✅ Installed: claude-code-review.yml
- ⏭️ Skipped: dependabot.yml (already existed)
- ⚠️ Secrets needed: ANTHROPIC_API_KEY or CLAUDE_CODE_OAUTH_TOKEN

### Review Pipeline (after claude-code-review.yml is installed)
PR opened → reviewed label → double-check → double-checked label → cto-review → approved/needs-work

### Manual Next Steps
- [ ] Install Claude GitHub App: https://github.com/apps/claude
- [ ] Add ANTHROPIC_API_KEY or CLAUDE_CODE_OAUTH_TOKEN secret
- [ ] Configure project board automations (link above)
- [ ] Wire event-rules.yml with review-pr-on-reviewed + cto-review-on-double-checked rules

---

ワークフローカタログ

すべての Claude ワークフローには、ANTHROPIC_API_KEY または CLAUDE_CODE_OAUTH_TOKEN が必要です。

ワークフロー	トリガー	出力	パイプラインでの役割
claude-code-review.yml	PR のオープンまたは再オープン	レビューコメント + reviewed ラベル	ステージ 1
claude-issue-triage.yml	新しい issue	ラベル + 優先度	単独
claude-prd-creation.yml	issue のラベルまたは @claude	PRD ドキュメント	単独
deploy-fly.yml	main へのプッシュ	Fly.io のデプロイ	CD
deploy-ecs-production.yml	main へのプッシュ	ECS のデプロイ（本番環境）	CD
deploy-ecs-staging.yml	develop へのプッシュ	ECS のデプロイ（ステージング環境）	CD
dependabot.yml	週次 cron	依存関係更新の PR	メンテナンス

---

必要なシークレット

シークレット	場所	備考
ANTHROPIC_API_KEY	https://console.anthropic.com/settings/keys	推奨です。sk-ant- で始まります
CLAUDE_CODE_OAUTH_TOKEN	claude /install-github-app を実行	API キーの代替
FLY_API_TOKEN	flyctl auth token	Fly.io のデプロイ用
AWS_ACCESS_KEY_ID	AWS IAM コンソール	ECS のデプロイ用
AWS_SECRET_ACCESS_KEY	AWS IAM コンソール	ECS のデプロイ用

---

関連ファイル

• templates/claude-code-review.yml — 汎用 Claude PR レビューワークフロー
• templates/claude-issue-triage.yml — issue のラベル付けワークフロー
• templates/claude-prd-creation.yml — PRD 生成ワークフロー
• templates/dependabot.yml — Dependabot の設定
• templates/deploy-fly.yml — Fly.io のデプロイ
• templates/deploy-ecs-production.yml — AWS ECS 本番環境
• templates/deploy-ecs-staging.yml — AWS ECS ステージング環境
• templates/deploy-mkdocs.yml — MkDocs ドキュメント