🔍 トラブルシューティング

Workflow 実行時に発生しやすい問題と対処法をまとめています。

（ここをクリック）目次

⚠️ Fork 後に GitHub Actions が動かない

Fork した Repository では、セキュリティ上の理由により GitHub Actions がデフォルトで無効 になっています。以下の手順で有効化してください。

有効化手順（GUI）

  1. Fork 先 Repository の Actions タブを開く
  2. 「 I understand my workflows, go ahead and enable them 」ボタンをクリックする

有効化手順（CLI）

gh api repos/<owner>/github-projects-ops-kit/actions/permissions \
  --method PUT \
  --field enabled=true \
  --field allowed_actions="all"

Note: この操作は Repository ごとに1回だけ必要です。有効化後は Workflow を通常通り実行できます。

🔐 権限エラーが発生する

Workflow 実行時に権限関連のエラーが出る場合は、以下を確認してください。

チェックリスト

よくあるエラーメッセージ

エラー 原因 対処
unknown owner type read:org Scope が不足している Classic token に read:org を追加する
Resource not accessible by personal access token PAT の権限が不足している 認証・トークンガイド を参照して権限を見直す
Could not resolve to a ProjectV2 project_number が正しくない、または PAT に Project 権限がない 入力値ガイド で project_number を確認する

🔎 Workflow が見つからない

Actions タブに Workflow が表示されない場合は、以下を確認してください。