GitHub Actionsを活用し、READMEのヒーロー画像を自動でローテーションさせるレシピ
本記事は、GitHubリポジトリのREADME.mdに配置されたヒーロー画像を、GitHub Actionsを利用して自動的に切り替える具体的な方法を解説しています。多くのユーザーがREADMEにプログラム概要などを記載する一方、筆者はリポジトリの視認性を高めるため、ロゴなどのヒーロー画像をトップに配置しているとのことです。このヒーロー画像が常に同じだと飽きがくるため、自動ローテーションシステムを構築しました。
システムは、GitHub Actionsのcron機能を利用し、指定された時間（デフォルトはJST 07:00頃）に自動で動作します。仕組みとして、リポジトリ内の`assets/heroes/`ディレクトリに複数の画像（.png, .jpg, .webpなど）をプールし、ワークフローが実行されるたびに、現在表示されている画像以外の候補からランダムに1枚を選択します。その後、README.md内の特定のマーカーブロック（``から``）内の``タグの`src`属性のみを新しい画像パスに差し替えます。この変更を`github-actions[bot]`アカウントでコミット＆プッシュすることで、READMEのトップが自動的に更新されます。
実装はPythonスクリプトとYAMLファイル（`rotate-hero.yml`）を用いて行われ、ロジックはシンプルかつ堅牢です。また、GitHub Actionsの権限設定（`Read and write permissions`の有効化）や、混雑を避けるための最適なcronスロット選定（例：UTC 22:00）など、実運用上の詳細な注意点も網羅されています。この仕組みにより、ユーザーは手動での作業なしに、リポジトリの魅力を常に更新し続けることが可能になります。
背景
GitHub Actionsは、GitHub上で自動化されたワークフローを実行できる機能です。本記事の背景には、リポジトリのREADMEが静的な情報になりがちであるという課題があり、これを解決するために、定期的な自動更新（ローテーション）の仕組みが求められました。特に、GitHubのWeb UIがJavaScriptの動的な画像変更を許さないため、GitHub Actionsというバックエンドの自動化機能を利用することが必須でした。
重要用語解説
- GitHub Actions: GitHubが提供するCI/CD（継続的インテグレーション/継続的デリバリー）ツール。ワークフローを自動実行し、リポジトリの変更や定期的なタスク処理を可能にする機能。
- README.md: リポジトリのルートディレクトリに置かれるMarkdown形式のファイル。プロジェクトの概要や説明を記述する、最も目立つページコンテンツ。
- cron: 特定の時間間隔（例：毎日午前7時）で自動的にタスクを実行するためのスケジューリング機能。GitHub Actionsでは、このcron式を用いて定期実行を設定する。
今後の影響
この仕組みは、開発者が手動で作業する手間を省き、リポジトリの魅力を自動的に維持することを可能にします。これにより、プロジェクトの「生きている感」や注目度が高まり、新規ユーザーの関心を引きつける効果が期待できます。ただし、コミットログが自動生成されるため、履歴管理の注意が必要です。