workflows

Reusable GitHub Actions workflows

ワークフロー一覧

copytuner_deploy - Copytuner翻訳管理ツールへのデプロイ
gem_changelog - Gemfile.lockの変更検出とchangelog投稿
new_gems - 新規追加gemの検出とコメント投稿
new_npm - 新規追加npmパッケージの検出とコメント投稿
npm_changelog - npm/yarnロックファイルの変更検出とchangelog投稿
staging_deploy - staging環境への自動デプロイPR作成
claude-review - Claude Codeによる自動コードレビュー
heroku_deploy_notify - Herokuデプロイ完了/失敗をPRに通知
claude-dependabot-review - Dependabot更新PRをCI緑でも危うい観点でClaudeレビュー

利用可能なワークフロー

1. copytuner_deploy

Copytune翻訳管理ツールへの翻訳情報をデプロイするワークフローです。

使用方法:

uses: SonicGarden/workflows/.github/workflows/copytuner_deploy.yml@main
secrets:
  apiKey: ${{ secrets.COPYTUNER_API_KEY }}

必要なシークレット:

apiKey: CopytunerのAPIキー

2. gem_changelog

Gemfile.lockの変更を検出し、更新されたgemのchangelogをPRコメントに投稿するワークフローです。

使用方法:

uses: SonicGarden/workflows/.github/workflows/gem_changelog.yml@main
secrets:
  rubygemsToken: ${{ secrets.RUBYGEMS_TOKEN }} # オプション

オプションのシークレット:

rubygemsToken: RubyGems.orgのAPIトークン（スコープ: Index rubygems）

3. new_gems

Gemfileの変更を検出し、新しく追加されたgemをPRコメントに投稿するワークフローです。

使用方法:

uses: SonicGarden/workflows/.github/workflows/new_gems.yml@main

4. new_npm

package.jsonの変更を検出し、新しく追加されたnpmパッケージをPRコメントに投稿するワークフローです。

使用方法:

uses: SonicGarden/workflows/.github/workflows/new_npm.yml@main
with:
  runs_on: "ubuntu-slim" # オプション、デフォルトは "ubuntu-slim"

パラメータ:

runs_on: GitHub Actions runner の指定（デフォルト: ubuntu-slim）

5. npm_changelog

npm/yarnのロックファイルの変更を検出し、更新されたパッケージのchangelogをPRコメントに投稿するワークフローです。

使用方法:

uses: SonicGarden/workflows/.github/workflows/npm_changelog.yml@main
with:
  lockPath: "yarn.lock" # オプション、デフォルトは "yarn.lock"
  runs_on: "ubuntu-slim" # オプション、デフォルトは "ubuntu-slim"

パラメータ:

lockPath: ロックファイルのパス（デフォルト: yarn.lock）
runs_on: GitHub Actions runner の指定（デフォルト: ubuntu-slim）

6. staging_deploy

指定されたブランチから staging ブランチへの自動デプロイPRを作成・管理するワークフローです。

使用方法:

uses: SonicGarden/workflows/.github/workflows/staging_deploy.yml@main
with:
  source_branch: "release-candidate" # オプション、デフォルトは "release-candidate"
  target_branch: "staging" # オプション、デフォルトは "staging"
  runs_on: "ubuntu-slim" # オプション、デフォルトは "ubuntu-slim"
  enable_auto_merge: true # オプション、デフォルトは true

パラメータ:

source_branch: デプロイ元のブランチ名（デフォルト: release-candidate）
target_branch: デプロイ先のブランチ名（デフォルト: staging）
runs_on: GitHub Actions runner の指定（デフォルト: ubuntu-slim）
enable_auto_merge: CI通過後にPRを自動マージするか（デフォルト: true）。false にするとPRの作成・更新のみ行い、自動マージは設定しない

機能:

既存のPRがあるかをチェック
新しいPRの作成または既存PRの更新
自動マージの設定（enable_auto_merge: true の場合のみ）
[skip deploy] がコミットメッセージに含まれている場合はスキップ

GitHub上での設定（CIが通ってから自動マージするため）:

Note: 以下の設定は enable_auto_merge: true（デフォルト）で自動マージを利用する場合に必要です。false の場合は不要です。

このワークフローでPRが自動的にマージされるようにするには、リポジトリで以下の設定が必要です：

ブランチ保護ルールの設定:
- リポジトリの Settings > Branches に移動
- staging ブランチのブランチ保護ルールを追加
- 「Require status checks to pass before merging」をチェック
- 必要なCIチェック（例：テスト、linter など）を選択
自動マージ機能の有効化:
- リポジトリの Settings > General に移動
- 「Allow auto-merge」をチェック

これらの設定により、CIが全て通過した後に自動的にPRがマージされます。

7. claude-review

Claude Code を使用してPRの自動コードレビューを実行するワークフローです。

使用方法:

uses: SonicGarden/workflows/.github/workflows/claude-review.yml@main
with:
  guideline_files: |
    doc/agent/code-review.md
    doc/agent/code-review-rails.md
  minimum_changed_lines: 10
secrets:
  # 以下どちらかが必須
  claude_oauth_token: ${{ secrets.CLAUDE_OAUTH_TOKEN }}
  anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

パラメータ:

guideline_files: コードレビューのガイドラインファイルのパス一覧（改行区切り）
model: 使用するClaudeモデル（オプション、デフォルトは sonnet。空文字を明示指定するとアクション側のデフォルトになる）
minimum_changed_lines: 前回レビューからの最小変更行数（デフォルト: 0、0の場合は常に実行）
runs_on: GitHub Actions runner の指定（デフォルト: ubuntu-24.04-arm）

必要なシークレット:

claude_oauth_token: Claude OAuth トークン（推奨）
anthropic_api_key: Anthropic API キー（claude_oauth_tokenがない場合のフォールバック）

機能:

PRの変更内容を日本語で自動レビュー
インラインコメントによる具体的な改善提案
コード品質、セキュリティ、パフォーマンスなど多角的な観点からのレビュー
既存のClaude botコメントを自動削除して重複を防止
[skip review] がコミットメッセージに含まれている場合はレビューをスキップ

8. heroku_deploy_notify

Heroku-GitHub 自動デプロイ対象ブランチへの push を契機に、Heroku Platform API をポーリングしてリリースの完了/失敗を検知し、そのマージコミットに紐づく PR にデプロイ結果をコメントするワークフローです。デプロイ本体には介入しない外形監視です。

使用方法:

呼び出し側でブランチごとに job を分け、heroku_app_name / env_name を渡します。push トリガーと concurrency は呼び出し側で定義します。

name: Deploy Notify
on:
  push:
    branches: [staging, main]
concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true
jobs:
  notify-production:
    if: github.ref == 'refs/heads/main'
    uses: SonicGarden/workflows/.github/workflows/heroku_deploy_notify.yml@main
    with:
      heroku_app_name: my-app
      env_name: production
    secrets:
      heroku_api_key: ${{ secrets.HEROKU_API_KEY }}
  notify-staging:
    if: github.ref == 'refs/heads/staging'
    uses: SonicGarden/workflows/.github/workflows/heroku_deploy_notify.yml@main
    with:
      heroku_app_name: my-app-staging
      env_name: staging
    secrets:
      heroku_api_key: ${{ secrets.HEROKU_API_KEY }}

パラメータ:

heroku_app_name: Heroku アプリ名（必須）
env_name: PR コメントに表示する環境名（必須、例: production / staging）
poll_interval_seconds: ポーリング間隔（秒）（デフォルト: 15）
poll_max_attempts: 最大試行回数（デフォルト: 48。poll_interval_seconds × この値が監視時間。ランナーの15分上限内に収めること）
release_fetch_count: 取得する最新 release 件数（デフォルト: 20）
notify_on_success: 成功通知の ON/OFF（デフォルト: true）
notify_on_failure: 失敗通知の ON/OFF（デフォルト: true）
notify_on_timeout: release を検知できずタイムアウトした場合の通知 ON/OFF（デフォルト: true）
include_release_log: PR コメントに Heroku release phase ログ（折りたたみ）を添付する ON/OFF（デフォルト: true）

必要なシークレット:

heroku_api_key: read-protected スコープの Heroku API トークン（read スコープだと releases の取得が 403 になります）

前提:

対象リポジトリで Heroku-GitHub の自動デプロイが有効であること
Heroku release の description が Deploy <短縮SHA> 形式であること（コミット SHA 先頭7文字で照合します）

機能:

Heroku release を最大 poll_max_attempts 回ポーリングして完了/失敗を検知
マージコミットに紐づく PR にデプロイ結果（成功/失敗/タイムアウト）をコメント
PR コメントは push イベント時のみ（手動実行などでは誤爆防止でスキップ）

9. claude-dependabot-review

Dependabot の依存更新 PR について、CI（テスト）が緑でも見逃しがちな「ランタイム挙動の変化・deprecation」を CHANGELOG ベースで Claude に評価させ、PR へ要約コメントを 1 本残すワークフローです。検出/分類は Dependabot に、「壊れたか」は CI に任せ、本WFは「緑でも危ういもの」を拾う役に徹します。言語・フレームワークには依存しません。

使用方法:

再利用可能ワークフローでは workflow_run トリガーを定義できないため、トリガー（on: workflow_run）と発火条件（CI 成功 & Dependabot 起点）は呼び出し側で定義し、head_sha を渡します。

name: Claude Dependabot Review
on:
  workflow_run:
    workflows: ["Test"]   # CI(テスト本体)のワークフロー名に合わせる
    types: [completed]
concurrency:
  # 同一 head_branch の再実行で多重コメントを防ぐ
  group: ${{ github.workflow }}-${{ github.event.workflow_run.head_branch }}
  cancel-in-progress: true
jobs:
  dependabot-review:
    # Dependabot 起点の PR、かつ CI が成功した場合のみ
    if: >
      github.event.workflow_run.event == 'pull_request' &&
      github.event.workflow_run.conclusion == 'success' &&
      github.event.workflow_run.actor.login == 'dependabot[bot]'
    uses: SonicGarden/workflows/.github/workflows/claude-dependabot-review.yml@main
    with:
      head_sha: ${{ github.event.workflow_run.head_sha }}
    secrets:
      # 以下どちらかが必須
      claude_oauth_token: ${{ secrets.CLAUDE_OAUTH_TOKEN }}
      anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

パラメータ:

head_sha: レビュー対象 PR の HEAD コミット SHA（必須。呼び出し側で github.event.workflow_run.head_sha を渡す）
model: 使用する Claude モデル（オプション、デフォルト: sonnet。空文字を明示指定するとアクション側のデフォルトになる）
runs_on: GitHub Actions runner の指定（デフォルト: ubuntu-24.04-arm）

必要なシークレット:

claude_oauth_token: Claude OAuth トークン（推奨）
anthropic_api_key: Anthropic API キー（claude_oauth_tokenがない場合のフォールバック）

前提:

呼び出し側の workflows: ["Test"] を、待ち受けたい CI ワークフローの name に合わせること
Dependabot が PR 本文に Release notes / Changelog を展開していること（一次ソースとして読む）

機能:

CI（テスト）が緑でも見逃す「ランタイム挙動の変化・deprecation」を CHANGELOG ベースで評価
ベースブランチ（更新適用前の現状コード）のみを checkout し、信頼コンテキストに untrusted な PR HEAD を置かない
PR へのコメントは 1 本に集約（既存の Claude コメントを自動削除して重複を防止）
head_sha に紐づく open PR が見つからない場合はスキップ

使用例

他のリポジトリからこれらのワークフローを使用する場合は、.github/workflows/ ディレクトリに以下のようなファイルを作成してください：

name: Example Workflow
on:
  pull_request:
    paths:
      - 'Gemfile.lock'

jobs:
  gem-changelog:
    uses: SonicGarden/workflows/.github/workflows/gem_changelog.yml@main
    secrets:
      rubygemsToken: ${{ secrets.RUBYGEMS_TOKEN }}

Name		Name	Last commit message	Last commit date
Latest commit History 101 Commits
.github		.github
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Repository files navigation

workflows

ワークフロー一覧

利用可能なワークフロー

1. copytuner_deploy

2. gem_changelog

3. new_gems

4. new_npm

5. npm_changelog

6. staging_deploy

7. claude-review

8. heroku_deploy_notify

9. claude-dependabot-review

使用例

About

Uh oh!

Releases

Packages

Uh oh!

Uh oh!

Contributors

Uh oh!

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

workflows

ワークフロー一覧

利用可能なワークフロー

1. copytuner_deploy

2. gem_changelog

3. new_gems

4. new_npm

5. npm_changelog

6. staging_deploy

7. claude-review

8. heroku_deploy_notify

9. claude-dependabot-review

使用例

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Packages