Agent-Skills.md

Agent Skills: Create Epic Pull Request

Create an aggregated Epic PR from a `cc-epic-<Issue number>` branch to the default branch. Takes the Epic Issue number as argument, assumes sub-PRs have already been merged into the epic branch, and automatically generates the PR title and description from the commit log against the base branch (including sub-PR / sub-Issue references). The PR is posted via `gh pr create` with no label and `Closes #<Epic Issue>`.

UncategorizedID: getty104/claude-code-marketplace/create-epic-pr
11

Install this agent skill to your local

pnpm dlx add-skill https://github.com/getty104/claude-code-marketplace/tree/HEAD/base-tools/skills/create-epic-pr

Skill Files

Browse the full folder contents for create-epic-pr.

Download Skill

Loading file tree…

base-tools/skills/create-epic-pr/SKILL.md

Skill Metadata

Name
create-epic-pr
Description
"Create an aggregated Epic PR from a `cc-epic-<Issue number>` branch to the default branch. Takes the Epic Issue number as argument, assumes sub-PRs have already been merged into the epic branch, and automatically generates the PR title and description from the commit log against the base branch (including sub-PR / sub-Issue references). The PR is posted via `gh pr create` with no label and `Closes #<Epic Issue>`."

Create Epic Pull Request

引数の Epic Issue 番号 $0 に対応する cc-epic-$0 ブランチから、デフォルトブランチへの集約PR（Epic PR）を作成するスキル。epic ブランチは複数サブIssueの実装PRをまとめてマージする集約用ブランチで、本スキル呼び出し時点でサブPRはすべて epic ブランチへマージ済みが前提（本スキルは epic ブランチも個別コミットも作らない）。ベースブランチとの差分コミットログからPR descriptionを自動生成し、gh pr create で投稿する。

ユーザーへの確認は行わず、判断はすべて本スキル内のルールで自動決定する。中断条件に該当した場合のみ、理由を出力して終了する。

Instructions

実行モードの制約: サブエージェント・サブスキル・Bashをバックグラウンド実行しないこと

本スキルは claude-task-worker の epic-issue ワーカー（cc-epic-issue ラベル）から自動起動される想定。ワーカーはスキルプロセスの同期完了を根拠にラベル遷移や後続処理を進めるため、バックグラウンド化すると PR URL 未取得のまま報告されたり、Epic PR 未作成のまま cc-epic-issue が外れる状態壊れが起きる。内部処理はすべて同期実行で完結させること。

  • Agent ツールは既定が run_in_background: true（バックグラウンド）。呼び出しごとに 必ず run_in_background: false を明示指定 し、フォアグラウンドで同期的に結果を受け取ってから次の処理に進む。指定を省略した場合はバックグラウンドで走り、本スキルが未完のまま終了する
  • Skill / Bash ツール呼び出し時に run_in_background: true を指定しない（既定は同期）。特に gh pr create は同期実行し、標準出力で返るPR URLを取得してから完了報告する
  • シェルコマンド末尾に & を付けない。nohup / disown / setsid でのデタッチ、ScheduleWakeup 等での後回しも禁止
  • 同一メッセージ内で複数の Agent / Skill を並列に投げるのは「並列実行」であって「バックグラウンド実行」ではないため許容される（各完了はその場で同期的に待つ）

フェーズ0: 引数判定と事前チェック

0-1. 引数の妥当性確認

$0 が数値のみのIssue番号であること（例: 123）を確認する。引数が空、または数値以外を含む場合は中断する。以降、$0 をそのままIssue番号として扱う。

0-2. Epic Issueの存在確認

gh issue view $0 --json number,title,state,url

Issueが存在しない、または state が CLOSED の場合は中断する。title は後続のPRタイトル生成、url は最終報告で使うため保持する。

0-3. 作業ディレクトリと未コミット変更の確認

pwd でカレントを確認する。git status --short で未コミット変更があれば中断する。本スキルはコードを編集しないため、未コミット変更はユーザーの作業中ファイルの可能性が高く、退避操作も行わない。

0-4. デフォルトブランチ名の取得

gh repo view --json defaultBranchRef -q .defaultBranchRef.name

失敗した場合は中断する。取得した値を <BASE> と呼ぶ。

完了条件: $0 / Epic Issueタイトル / <BASE> が確定し、未コミット変更が無いこと。

フェーズ1: epicブランチへのチェックアウト

1-1. リモートからの最新取得

git fetch origin --prune

1-2. ブランチの特定とチェックアウト

対象ブランチ名は cc-epic-$0。以下の優先順で処理する:

  1. リモートに存在する場合（git rev-parse --verify origin/cc-epic-$0 が成功）: git checkout cc-epic-$0（ローカルに無ければ自動で tracking branch が作られる）→ git pull --ff-only origin cc-epic-$0 で最新化。ff-only 失敗時は中断
  2. ローカルのみに存在する場合（リモートに無く、git rev-parse --verify cc-epic-$0 が成功）: git checkout cc-epic-$0
  3. どちらにも存在しない場合は中断する。サブPRマージ前の早すぎる呼び出しを防ぐため、自動作成せず止める

完了条件: git rev-parse --abbrev-ref HEAD が cc-epic-$0 を返すこと。

git pull は ff-only でのみ実行する。マージコンフリクトが発生した場合は手動解決を促す。

フェーズ2: ベースブランチとの差分ログ取得

2-1. merge-base から HEAD までのコミット一覧

BASE_REF=$(git merge-base origin/<BASE> HEAD)
git log ${BASE_REF}..HEAD --pretty=format:'%h%x09%s'

差分コミットが0件の場合は中断する（PR にする変更がない）。

2-2. サブPR / サブIssue 番号の抽出

各コミットメッセージから以下のパターンで PR / Issue 番号を抽出する:

  • Merge pull request #<番号> パターン → サブPR
  • (#<番号>) パターン（squash merge の慣習）→ サブPR
  • Closes #<番号> / closes #<番号> / Closed #<番号> / Fixes #<番号> / fixes #<番号> / Resolves #<番号> パターン → サブIssue

$0 自身は除外し、重複も除去する。順序はコミットログ順を維持する。

完了条件: 差分コミット一覧と、サブPR / サブIssue 番号の抽出結果が得られていること。

フェーズ3: PR 本文の生成

3-1. PR タイトル

Epic: <Epic Issueタイトル> 形式とする。

3-2. PR 本文の組み立て

以下のフォーマットで組み立てる。サブPR / サブIssue が無いセクションは省略せず「なし」と1行書く（後続レビューが「未記入」と「該当なし」を区別できるようにするため）。

## 概要
Epic Issue #$0「<Epic Issueタイトル>」に紐づくサブタスクをまとめた集約PRです。

## 含まれる変更
- `<short hash>` <subject>
- `<short hash>` <subject>
...

## 含まれるサブPR
- #<番号>
- #<番号>
（なければ "なし"）

## 含まれるサブIssue
- #<番号>
- #<番号>
（なければ "なし"）

Closes #$0

Closes #$0 を必ず含める（Epic PR マージ時に Epic Issue を自動 close させるため）。

フェーズ4: PR の作成（gh pr create 実行）

4-1. assignee の取得

ME=$(gh api user --jq '.login')

4-2. gh pr create の実行

本文渡しは --body-file - + heredoc（<<'EOF' クォート版）を使う。--body "..." 形式は本文中のバッククォート・$・改行でエスケープが壊れやすいため使わない。heredoc は <<'EOF' でシェル展開を抑止するため、本文中の $0 などのプレースホルダは heredoc に渡す前に実値へ置換しておくこと。

gh pr create \
  --title "Epic: <Epic Issueタイトル>" \
  --base "<BASE>" \
  --assignee "${ME}" \
  --body-file - <<'EOF'
## 概要
Epic Issue #$0「<Epic Issueタイトル>」に紐づくサブタスクをまとめた集約PRです。

## 含まれる変更
- `<short hash>` <subject>
...

## 含まれるサブPR
- #<番号>
...

## 含まれるサブIssue
- #<番号>
...

Closes #$0
EOF

ラベルは付与しない（--label フラグを使わない）。

gh pr create が失敗した場合は失敗ログを最終報告に含めて終了する。再試行は1回まで。

フェーズ5: 最終報告

gh pr create が返した PR URL と、以下を1-3行で報告して終了する:

  • ブランチ名（cc-epic-$0）
  • 差分コミット数
  • 含まれたサブPR / サブIssue の件数

中断条件

以下のいずれかに該当する場合のみ、理由を1-2行で出力して即中断する。

  • 引数が空、または Issue 番号として解釈できない
  • gh issue view で Issue が見つからない、または CLOSED
  • 未コミット変更が存在する
  • デフォルトブランチ名の取得失敗
  • cc-epic-$0 ブランチがローカル / リモートのいずれにも存在しない
  • git pull --ff-only が ff-only で失敗（ローカルとリモートの乖離）
  • ベースブランチとの差分コミットが0件
  • gh pr create が失敗し、再試行しても解消しない