tagpr

tagpr は、リリースブランチへの push のたびに「次のバージョンと CHANGELOG を含むリリース PR」を作って追従させ、その PR をマージするとタグと GitHub Release を作るツール。このスキルでは GitHub App のインストールトークンで動かす構成に統一する。

原則:

• トークンは GitHub App。actions/create-github-app-token で都度発行し、GITHUB_TOKEN は使わない。GITHUB_TOKEN で作ったタグは別ワークフロー（on.push.tags）を起動できず、リリース PR 上の pull_request ワークフローも手動承認待ちになるため
• リポジトリ設定も Actions から PR を作れる状態にする（Settings > Actions > General > Workflow permissions の「Allow GitHub Actions to create and approve pull requests」）。App トークンなら本来不要だが、gh api で必ず入れておき、GITHUB_TOKEN にフォールバックしても動く状態にする
• 公開（publish / deploy）はタグ push で起動する別ワークフローに置き、workflow_dispatch で明示タグを渡して再実行できるようにする
• uses: は pinact で SHA に pinし、actions/checkout は persist-credentials: false
• 既存の公開済みタグは動かさない。ベースラインがずれていたら .tagpr 側を直す

雛形と詳細は reference に分ける。必要なものだけ読む:

• references/github-app.md: GitHub App の作成・権限・インストール、vars / secrets の登録、リポジトリ設定の gh api
• references/workflows.md: tagpr.yml、タグ起動の release.yml、同一ワークフロー内で公開する変種
• references/config.md: .tagpr の全設定と action の inputs / outputs、トラブルシュート

手順