Claude Code×GitHub（gh CLI・API・Actions）【2026】Issueから実装・PR・CI修正までAIエージェントに任せる

# インストール（macOS の例。Linux/Windows は公式手順を参照）
brew install gh

# ① 手軽な方法：ブラウザでログイン
gh auth login

# ② 推奨：権限を絞った fine-grained PAT で認証（トークンは標準入力から渡す）
gh auth login --with-token < ~/.secrets/gh-agent-token.txt

# 認証状態とアカウント・スコープを確認
gh auth status

my-app/
├── CLAUDE.md                        # ブランチ命名・テスト・コミット規約など
├── .claude/
│   ├── settings.json                # permissions（allow/ask/deny）と hooks
│   ├── hooks/
│   │   └── guard-git.sh             # main への push 等を実行前にブロック
│   └── skills/
│       └── release-notes/SKILL.md   # リリースノート下書きの手順
├── scripts/
│   ├── ci_failed_log.sh             # 直近の失敗ログを取得
│   └── stale_issues.sh              # 古いIssueを JSON で書き出す
├── reports/                         # 棚卸しレポート等の出力先（.gitignore 済み）
├── .github/
│   ├── CODEOWNERS                   # 重要ディレクトリのレビュー担当
│   └── workflows/
│       └── claude.yml               # claude-code-action
└── src/ …

#!/usr/bin/env bash
# 使い方: scripts/ci_failed_log.sh [ブランチ名]（省略時は現在のブランチ）
set -euo pipefail

BRANCH="${1:-$(git branch --show-current)}"
mkdir -p tmp

# 対象ブランチで直近に失敗した実行のIDを取得
RUN_ID=$(gh run list --branch "$BRANCH" --status failure --limit 1 \
  --json databaseId --jq '.[0].databaseId')

if [ -z "$RUN_ID" ] || [ "$RUN_ID" = "null" ]; then
  echo "失敗した実行はありません: $BRANCH"
  exit 0
fi

# 失敗したステップのログだけを保存（長大なログ全体は読ませない）
gh run view "$RUN_ID" --log-failed > tmp/ci_failed.log
echo "saved: tmp/ci_failed.log (run $RUN_ID, $(wc -l < tmp/ci_failed.log) lines)"

#!/usr/bin/env bash
# 90日以上更新のないオープンIssueを JSON で書き出す（GNU date 前提。macOS は gdate 等）
set -euo pipefail

CUTOFF=$(date -d '90 days ago' +%Y-%m-%d)
mkdir -p reports

gh issue list --state open --limit 300 \
  --search "updated:<${CUTOFF}" \
  --json number,title,labels,assignees,updatedAt,url \
  > reports/stale_issues.json

echo "$(jq length reports/stale_issues.json) issues (updated before ${CUTOFF})"

# PRのレビューコメント一覧（読み取り）
gh api repos/{owner}/{repo}/pulls/45/comments --jq '.[] | {path, line, body}'

# 直近のリリースとタグ（読み取り）
gh api repos/{owner}/{repo}/releases --jq '.[0:3] | .[] | {tag_name, published_at}'

# 注意：-f / -F でフィールドを付けると既定のメソッドが POST になる（書き込み）
gh api repos/{owner}/{repo}/releases/generate-notes -f tag_name=v1.4.0

# 開発ルール（AIエージェント向け）

## ブランチ
- main に直接コミット・push しない。必ず作業ブランチを切る
- 命名: feat/<issue番号>-<短い英語>、fix/<issue番号>-<短い英語>、chore/<内容>
  例: feat/123-csv-export, fix/140-login-redirect
- 強制push（--force / -f）はしない。履歴を書き換えない

## テスト（PRを出す前に必ず全部通す）
- 単体テスト: npm test
- 型チェック: npm run typecheck
- Lint: npm run lint
- 失敗したテストを削除・skip して通すのは禁止。直せない場合は PR 本文にそう書く

## コミット規約
- Conventional Commits: feat: / fix: / docs: / refactor: / test: / chore:
- 1コミット1目的。件名は日本語可・72文字以内
- 本文に関連 Issue を書く（例: Refs #123）

## PR
- gh pr create --draft で作成する（レビュー準備ができたら人が Ready にする）
- 本文に「変更内容」「テスト結果」「確認してほしい点」「Closes #番号」を書く
- マージはしない。gh pr merge は使わない

## CIが落ちたとき
- scripts/ci_failed_log.sh でログを取得し、原因の仮説を先に説明してから修正する
- .github/workflows/ は変更しない（変更が必要なら提案だけする）

{
  "permissions": {
    "allow": [
      "Bash(gh issue view:*)",
      "Bash(gh issue list:*)",
      "Bash(gh pr view:*)",
      "Bash(gh pr diff:*)",
      "Bash(gh pr checks:*)",
      "Bash(gh pr list:*)",
      "Bash(gh run list:*)",
      "Bash(gh run view:*)",
      "Bash(gh pr create:*)",
      "Bash(scripts/ci_failed_log.sh:*)",
      "Bash(scripts/stale_issues.sh:*)",
      "Bash(git status)",
      "Bash(git diff:*)",
      "Bash(git log:*)",
      "Bash(git switch -c:*)",
      "Bash(git add:*)",
      "Bash(git commit:*)",
      "Bash(npm test:*)",
      "Bash(npm run lint:*)",
      "Bash(npm run typecheck:*)"
    ],
    "ask": [
      "Bash(git push:*)",
      "Bash(gh api:*)",
      "Bash(gh pr comment:*)",
      "Bash(gh pr review:*)",
      "Bash(gh issue comment:*)",
      "Bash(gh issue close:*)",
      "Bash(gh release create:*)"
    ],
    "deny": [
      "Bash(git push --force:*)",
      "Bash(git push -f:*)",
      "Bash(git push origin main:*)",
      "Bash(git reset --hard:*)",
      "Bash(gh pr merge:*)",
      "Bash(gh repo delete:*)",
      "Bash(gh api -X DELETE:*)",
      "Bash(gh secret:*)",
      "Read(./.env)",
      "Read(./.env.*)"
    ]
  }
}

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/guard-git.sh" }
        ]
      }
    ]
  }
}

#!/usr/bin/env bash
# 標準入力で渡される JSON から、実行しようとしているコマンドを取り出す
CMD=$(jq -r '.tool_input.command // ""')

# git push を含まなければ何もしない
echo "$CMD" | grep -Eq 'git[[:space:]]+push' || exit 0

# 強制push（--force, --force-with-lease, -f, +refspec）を拒否
if echo "$CMD" | grep -Eq '(--force|[[:space:]]-f([[:space:]]|$)|[[:space:]]\+[^[:space:]]+)'; then
  echo "強制pushは禁止です。通常のpushで作業ブランチに出してください。" >&2
  exit 2
fi

# main / master への push を拒否（明示指定・HEAD:main 形式の両方）
if echo "$CMD" | grep -Eq '(^|[[:space:]:])(main|master)([[:space:]]|$)'; then
  echo "main への直接pushは禁止です。作業ブランチを切ってPRを作成してください。" >&2
  exit 2
fi

# 引数なしの git push でも、現在のブランチが main なら拒否
if [ "$(git branch --show-current)" = "main" ]; then
  echo "現在 main ブランチにいます。git switch -c で作業ブランチを作ってください。" >&2
  exit 2
fi
exit 0

> Issue #123 を読んで実装して。受け入れ条件を満たしたら draft PR まで作って。
  不明点があれば実装前に質問して。

> PR #145 の CI が落ちてる。失敗ログを読んで、原因の仮説を3つ以内で説明してから直して。
  テストを消したり skip したりするのは禁止。

> PR #150 を一次レビューして。観点は ①バグの可能性 ②テスト不足 ③セキュリティ（認証・入力検証・秘密情報）
  ④CLAUDE.md の規約違反。結果は reviews/pr-150.md に書いて、GitHub には投稿しないで。

name: Claude Code

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]

jobs:
  claude:
    # @claude を含むコメント・Issueのときだけ起動（無駄な実行と課金を防ぐ）
    if: |
      contains(github.event.comment.body, '@claude') ||
      contains(github.event.issue.body, '@claude')
    runs-on: ubuntu-latest
    timeout-minutes: 30
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          # 追加の CLI 引数（ターン数の上限など）を渡せる
          claude_args: "--max-turns 15"

# リモートのMCPサーバーを登録する一般形（URL・ヘッダーは公式手順のものを使う）
claude mcp add --transport http github <公式のMCPサーバーURL>

# チームで共有するなら --scope project（.mcp.json に保存される。トークンは書かない）
claude mcp add --scope project --transport http github <公式のMCPサーバーURL>

# Claude Code 内で接続状況を確認
/mcp

---
name: release-notes
description: 前回のリリースタグ以降にマージされたPRからリリースノートの下書きを作る。リリース準備・リリースノート作成を頼まれたときに使う。
---

# リリースノート下書きの手順
1. 前回タグを取得: git describe --tags --abbrev=0
2. マージ済みPRを取得:
   gh pr list --state merged --base main --limit 200 \
     --search "merged:>=<前回タグの日付>" --json number,title,labels,author,url
3. ラベルで分類: 新機能(feature) / 改善(enhancement) / 不具合修正(bug) / その他
4. 利用者向けの言葉に書き換える（内部のリファクタリングは「その他」にまとめる）
5. 破壊的変更（breaking ラベル）は先頭に「⚠️ 移行が必要な変更」として書く
6. RELEASE_NOTES.md に保存し、次のコマンドを提案する（実行は人の確認後）:
   gh release create <新タグ> --draft --notes-file RELEASE_NOTES.md

claude -p "scripts/stale_issues.sh を実行し、reports/stale_issues.json を読んで、
クローズ候補・要追加情報・継続の3分類で reports/stale_issues.md にまとめて。
Issueのクローズやコメントはしないこと。" \
  --allowedTools "Bash(scripts/stale_issues.sh:*),Read,Write" \
  --output-format json