draft-pr
Skill1 starsChanged 4 months agoApache-2.0View on GitHub
ブランチ作成、コミット、ドラフトPR作成を自動化
- Reads credentials
- Commits and pushes
15 other projects use a version of this.
Adopted by
Most recently taken up by
- SamuelBostic29/claude-skillstheir own version, first seen Nov 16, 2026
- flavio-portela/skillstheir own version, first seen Nov 1, 2026
- matheusPavaneli/workbenchtheir own version, first seen Oct 20, 2026
- gigio1023/agent-skillstheir own version, first seen Oct 13, 2026
- gigio1023/gigio-skillstheir own version, first seen Oct 13, 2026
- arklexai/arksimtheir own version, first seen Oct 8, 2026
Used with
Projects with it also use skill-builder, interview and 1 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
BlockSkillskill-builder
Create, edit, or inspect Berd skills stored as skill folders with SKILL.md files. Use when the user wants to build a new skill, update an existing skill, convert a workflow into a reusable skill, or decide whether instructions, scripts, references, or assets belong in a skill.
Also in 3 projects that use this
dazuckSkillinterview
Interview me about a plan to flesh out requirements before implementation. Asks non-obvious questions one at a time until all ambiguities are resolved.
Also in 3 projects that use this
BlockSkillfrontend-design
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
Also in 3 projects that use this
Other versions15 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 15
- wordpress-mobile/WordPress-Android★ 3.2ksame name
- ComplianceAsCode/content★ 2.8ksame name
- multigres/multigres★ 2.7ksame name
- microsoft/roosterjs★ 1.3ksame name
- arklexai/arksim★ 236same name
- g2i-ai/agents★ 52same name
- gigio1023/agent-skills★ 2same name
- gigio1023/gigio-skills★ 2same name
- zahardev/aicontext★ 2same name
- matheusPavaneli/workbench★ 1same name
5 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository9 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- ai-updatesSkill
- brew-upgradeSkill
- claude-code-updatesSkill
- go-updatesSkill
- read-google-sheetSkill
- summarize-blogSkill
- summarize-go-issueSkill
- watch-ciSkill
The file
Files
draft-pr
現在の作業ツリーから、ブランチを切ってコミットしてドラフトPRを作るスキル。
PR本文(body)の方針 — 最優先ルール
PR テンプレ(.github/pull_request_template.md 等)があればテンプレ全文をベースに body を組み立てる。自動入力するのは次の 3 種の節だけで、他の節(Before/After スクショ欄 / Debug List / Test plan / Todo など、人が画像や文脈を入れる節)はテンプレの placeholder のまま一字も変えずに残す(PR 作成後も同じ。これらの節のチェックボックス - [ ] を - [x] に変えたり項目を書き足したりしない。スキルは実機確認やテスト実行そのものを行わないので、その完了を勝手に記録しない — チェックは実際に確認した人が手で付ける)。
| 節 | 埋める条件 | 入れる内容 |
| Overview(概要) | 見出しがあれば必ず | 箇条書き 1-2 項目の短い要約 |
| Reference | 見出しがあり、かつ Linear ID が取れたら | Linear / Slack / Figma の URL |
| レビュー期限 | 見出しがあれば必ず | JST で計算した期限 |
なぜこの線引きか:
- 概要節が空のドラフト PR はレビュアーが何のための変更か判断できない。コミットメッセージと diff から機械的に書ける範囲は埋めておく
- Reference は Linear ID から機械的に辿れる。人が毎回コピペするのは無駄
- レビュー期限は、テンプレのコメントに「任意項目」とあっても省略しない。期限のない PR はレビューが放置されがちで、この運用では期限を必ず設定する
- Before/After スクショ欄などはスキルが埋めても意味がない。人が後から書く
各節の埋め方
Overview(概要)
見出しに Overview / 概要 / Summary / 変更内容 / What / Description のいずれかを含む節。
- ソース: コミットメッセージ +
git diff --cached --stat -の箇条書きで 1-2 項目。 1 項目目 = 何を変えたか。なぜ/併せて何をしたかが自明でないときだけ 2 項目目で補う。軽微な変更は 1 項目で終える- 各項目は短い言い切り 1 文(「〜を追加」「〜を修正」「〜へ差し替え」「〜を撤去」)。ですます調にしない
- 実装手順・詳細な背景の説明は書かない — それは diff とコミットログを見れば分かる。長い Overview はかえって読まれない
- タイトルの丸写しにせず、タイトルに無い補足を入れる
- 節内に placeholder の HTML コメント(
<!-- ... -->)があれば要約で丸ごと置き換える(残骸を残さない)
例:
# コミット: chore: .claude/worktrees/ を gitignore に追加
→
- Claude Code の worktree ディレクトリが誤って track されるのを防止。
# コミット: refactor(option): 旧サムネイル参照を撤去し新画像へ差し替え
→
- featureLinks の画像参照を /image/features/old_*_mx.webp から /image/option-thumbnails/new_*.webp へ差し替え。
- 未使用の legacyThumbnailUrl 定数と一時コメントを撤去。Reference
見出しに Reference / 参照 / 参考 のいずれかを含む節。自動取得の対象は Linear / Slack / Figma の 3 種のみ。Notion: などそれ以外のキーは、会話や issue に URL がありそうでも埋めずに placeholder のまま残す(人が後から書く前提)。
手順:
- Linear ID を抽出:
echo "$BRANCH $MESSAGE" | grep -oE '[A-Z]{2,}-[0-9]+' | head -1。抽出できなければ Reference 節は丸ごと触らない - issue を取得:
mcp__linear-server__get_issueに Linear ID を渡す - URL の出どころは「issue そのもの」だけ:
- Linear ← issue の
url - Figma ← issue 本文・全コメント中の
figma.comURL(複数あれば改行区切り) - Slack ← issue 本文・全コメント中の
*.slack.com/archives/URL - issue に無い URL を会話の文脈やチャンネル ID から組み立てて補完してはいけない(過去に誤った archives URL を生成した実績あり)。見つからない行は placeholder のまま残す
- Linear ← issue の
- 書き換えは行単位: 空のキー行だけに値を入れ、既に値がある行・節内の説明文・コメントは触らない。「空」= コロン(またはネストの子行)の後ろに非空白文字が無い行
テンプレの Reference 節は repo ごとに形が違う。確認済みの 3 形状と埋め方:
# A. フラットなキー行 → 同じ行に埋める: `Linear: <url>`
Linear:
Slack:
Figma:
# B. 語尾付き単キー + コメント → ラベルに Linear を含むので Linear 行として扱う: `Linear Project: <url>`
<!-- Linear Project のリンクを添付 -->
Linear Project:
# C. ネスト箇条書き → 子の placeholder 行(`- URL`)だけを解決した URL で置換。Notion の子行は触らない
- Slack
- URL
- Notion
- URLキー名はテンプレに合わせて柔軟に読む: コロン前(または親の箇条書き)のラベルに Linear / Slack / Figma を含む行が対象。
レビュー期限
見出しに レビュー期限 / 期限 / Review by / Review deadline のいずれかを含む節。見出しがある限り必ず埋める。 テンプレの HTML コメントに「[任意項目]」等とあっても省略せず、コメントごと期限の 1 行で置き換える。
計算(JST 基準):
- 作成時刻が 12:00 JST 未満 → 同日 18:00 (JST)
- 12:00 JST 以降 → 翌日 12:00 (JST)
- フォーマット:
YYYY/MM/DD HH:00 (JST)
JST_HOUR=$(TZ=Asia/Tokyo date +%H)
if [ "$JST_HOUR" -lt 12 ]; then
REVIEW_BY="$(TZ=Asia/Tokyo date '+%Y/%m/%d') 18:00 (JST)"
else
NEXT_DAY=$(TZ=Asia/Tokyo date -v+1d '+%Y/%m/%d' 2>/dev/null \
|| TZ=Asia/Tokyo date -d '+1 day' '+%Y/%m/%d')
REVIEW_BY="${NEXT_DAY} 12:00 (JST)"
fi
echo "$REVIEW_BY"レビュー期限は PR メタ情報なので、コミットメッセージや PR タイトルには含めない(squash merge 後の main の履歴を汚染しないため)。
実行フロー
1. 状態確認
並列で:
git status --short
git diff --stat
git log --oneline -5変更がなければエラー終了。
この状態確認は初回だけでなく、同じ変更に追加コミットを積むたびに毎回行う。PR 作成後にユーザーから追加修正を頼まれたときも、git status / git branch --show-current で「いま対象 PR のブランチ上にいるか」を必ず確かめてからコミットする。PR がマージされるとローカルは自動でデフォルトブランチに戻っていることがあり、そのまま git commit するとデフォルトブランチにコミットが乗って push がブランチ保護で拒否される(GH013 ... Changes must be made through a pull request.)。
また、カレントがデフォルトブランチ以外のブランチのときは、そのブランチをそのまま再利用してよいと決める前に gh pr list --head "$(git branch --show-current)" --state all で紐づく PR の状態を確認する。既に MERGED / CLOSED の PR があるブランチにはもう積めないので、手順 3 のエッジケースに従い新しいブランチを切って別 PR にする。「既に作業用ブランチ上にいるからスキップ」と即断するより、このマージ済み PR の確認を優先する。
2. ブランチ名とコミットメッセージを決める
- ブランチ名: 引数があり、かつブランチ名として妥当な形式(
a-z0-9/_-中心で日本語・スペース・括弧を含まない)ならそれを使用。引数が「修正内容の説明文」(日本語・スペース・括弧を含む等)のときはブランチ名にせず、コミットメッセージ/PR タイトルの素材として使い、ブランチ名は自動生成側へフォールバックする。無ければfeature/$(date +%Y%m%d%H%M)-<kebab-summary>(summary は 20 文字以内、a-z0-9-のみ) - コミットメッセージ:
git log --oneline -10で直近のスタイルに合わせる。Conventional Commits/日本語混じり/プレフィックス無しなど、その repo の慣習に従う
3. デフォルトブランチから新ブランチを切る
HAS_STASH=0
if [ -n "$(git status --porcelain)" ]; then
git stash push --include-untracked -m "draft-pr-auto-stash"
HAS_STASH=1
fi
DEFAULT_BRANCH=$(gh repo view --json defaultBranchRef --jq .defaultBranchRef.name)
git checkout "$DEFAULT_BRANCH" && git pull origin "$DEFAULT_BRANCH"
git checkout -b "$BRANCH"
[ "$HAS_STASH" = "1" ] && git stash popエッジケース:
- 既に作業用ブランチ上にいる(カレントがデフォルトブランチ以外で、そのブランチをそのまま PR にする)場合: この手順を丸ごとスキップして手順 4 へ。renovate / dependabot などの bot が作ったブランチ(既にコミットが乗っており、その上に修正を足すだけ)もこのケースに含める — デフォルトブランチを checkout し直すと bot のコミットが新ブランチから抜け落ちて不完全な PR になるので、そのブランチ上でそのまま追加コミットする
- worktree 内 / detached HEAD でデフォルトブランチを
checkoutできない場合(デフォルトブランチが別 worktree で使用中だとfatal: '<branch>' is already used by worktree at ...になる):checkout/pullは行わず、現在の HEAD からそのままブランチを切り(git checkout -b "$BRANCH")、コミット後にgit fetch origin && git rebase "origin/$DEFAULT_BRANCH"で最新化する - stacked PR(親ブランチの上に積む)場合:
git log --oneline "$DEFAULT_BRANCH"..HEADに親ブランチのコミットが含まれるなら、新ブランチは切らず PR 作成時に--base <親ブランチ>を指定する - 既にマージ済みの PR へ追加修正を頼まれた場合: マージ済み PR にはもう積めないので、この手順どおり新しいブランチを切って別 PR にする。まだ open な PR への追記なら、その PR のブランチに
git checkoutしてから追加コミットする(対象ブランチ上にいるか手順 1 で確認する)
4. ステージング・コミット・push
# 修正/削除はまとめて(既定)
# ただし PR 対象外の modified ファイル(.tool-versions など)が混ざる場合や、
# コミット対象が明確な場合は `git add -u` ではなく `git add <対象ファイル>` で個別指定する。
# いま取り組んでいるタスクと無関係な未追跡ファイル(別スキルの SKILL.md など)が
# 混ざっていたら、同じ PR に巻き込まず追加対象から除外する(下の新規ファイル追加ループでも同様に skip する)。
git add -u
# 新規ファイルはシークレット候補だけ除外して追加
for f in $(git status --porcelain | awk '/^\?\?/ {print $2}'); do
if echo "$f" | grep -Eq '\.env($|\.)|\.key$|\.pem$|^id_rsa|credentials|\.p12$|secrets?($|\.)'; then
echo "skip secret-like: $f"; continue
fi
git add "$f"
done
git diff --cached --stat
git commit -m "$MESSAGE"
git push -u origin HEADgit push は tail 等にパイプしない(パイプ後の PIPESTATUS 頼みでは push の失敗を検出できない)。そのまま実行して終了コードで判定する。
PR を作成した後にユーザーから追加修正を頼まれたときは、git commit --amend + push --force-with-lease で履歴を書き換えず、新しいコミットを積んで通常の git push をする。amend / force-push はレビュアーが既に見た履歴を書き換えてしまうため、レビュー可能になった後は避ける(PR 作成前の amend は問題ない)。
5. body の構築 — Read → 解決 → Write の 3 ステップ
awk / sed の行置換スクリプトで body を作らない。 テンプレは repo ごとに形が違い、置換パターンの取りこぼしで節が埋まらない事故が繰り返し起きている。また body 生成と gh pr create を 1 つの複合 Bash にまとめると権限フックに deny される。必ず次の 3 ステップに分ける:
5-1. テンプレ検出(Bash)
TEMPLATE=""
for p in .github/pull_request_template.md .github/PULL_REQUEST_TEMPLATE.md docs/pull_request_template.md PULL_REQUEST_TEMPLATE.md; do
if [ -f "$p" ]; then TEMPLATE="$p"; break; fi
done
if [ -z "$TEMPLATE" ] && [ -d .github/PULL_REQUEST_TEMPLATE ]; then
TEMPLATE=$(find .github/PULL_REQUEST_TEMPLATE -maxdepth 1 -iname '*.md' | sort | head -1)
fi
echo "TEMPLATE=${TEMPLATE:-none}"- glob(
*.md)をforのリストに直接書かない。zsh はマッチ無しのときno matches foundで exit 1 する。ディレクトリ形式はfindで探す - macOS の case-insensitive FS では小文字/大文字パスが同一ファイルを指すことがあるが、最初の一致が GitHub の採用するテンプレと同じ実体なので気にしなくてよい
5-2. 材料の解決
- Read ツールでテンプレ全文を読み、Overview / Reference / レビュー期限 のどの節があるか特定する(見出しキーワードは「各節の埋め方」参照)
- Overview があれば箇条書き 1-2 項目の要約を作る
- レビュー期限があれば上のスクリプトで計算する
- Reference があれば Linear ID →
mcp__linear-server__get_issue→ URL 抽出
5-3. Write ツールで body ファイルを書き出す
テンプレ全文をベースに、対象の節だけを埋めた完成形を、リポジトリ外の一時パスに Write する。ファイル名にはブランチ名を含めて一意にする(例: /tmp/draft-pr-body-<branch>.md。ブランチ名に / が含まれる場合は - に置換してパス階層を作らない)— 並行して別の draft-pr / エージェントが走っていても衝突しないように。
書き出す前のセルフチェック:
- 対象外の節(Before/After / Debug List / Todo 等)はテンプレと一字一句同じか
- Overview は
-箇条書き 1-2 項目か(3 項目以上になっていたら削る) - レビュー期限の節があるのに空のままになっていないか
- Reference は「issue から取れた URL」だけか(推測で組み立てた URL が無いか)
- テンプレ冒頭などの節に属さないコメント(bot への指示等)を消していないか
初回作成後に追加コミットを積んだときは、PR タイトル・本文は原則そのままにする(コミットごとに gh pr edit で追随しない — 追記のたびに本文を書き換えると差分が追えず、途中状態で放置されやすい)。ただし追加コミットで変更の主旨が初回から大きく変わったときだけ、Overview 節を最新の内容に合わせて 1 度だけ更新する。
コミットを伴わなくても、Overview の記述に事実誤りがあると分かった(レビュー指摘・手動検証の結果など)ときは、その節だけを正しい内容へ gh pr edit で訂正してよい。本文の正確さはレビューの前提なので、事実誤りは残さない。ただし訂正は事実誤りの箇所に限り、対象外の節(Debug List 等)は触らない。
6. ドラフト PR 作成(別の Bash 呼び出し)
gh pr create --draft --title "$MESSAGE" --base "$DEFAULT_BRANCH" --body-file <5-3 で書いたファイル>body のフォールバック(非対話シェルでは gh のテンプレ自動採用プロンプトは機能せず、--body 系を省くとエラーになる):
| 状況 | body |
| テンプレあり・対象節あり | 5-3 で書いたファイル |
| テンプレあり・対象節なし | --body-file "$TEMPLATE"(テンプレをそのまま渡す) |
| テンプレなし | Overview 相当の 1-2 文だけを書いたファイルを Write して渡す |
エラーハンドリング
| エラー | 対策 |
| 変更なし | エラーメッセージを表示して終了 |
| ブランチ名重複 | タイムスタンプを秒単位まで追加 |
| PR作成失敗 | gh のエラーログをそのまま表示 |
| シークレット候補検出 | 警告表示してスキップ(必要なら人が手動で追加) |
| Linear issue 取得失敗 | Reference 節は placeholder のまま進める(PR 作成は止めない) |
| rebase コンフリクト(worktree 経路) | 自動解決しない。コンフリクト内容を提示して人の判断に委ねる |
使用例
/draft-pr # ブランチ名自動生成
/draft-pr feature/add-new-endpoint # ブランチ名指定
/draft-pr fix/login-bug # 同上(コミットメッセージは別途自動生成)出力例
✅ ドラフトPR作成完了
ブランチ: feature/PROJ-123-add-workflow-rpc
コミット: feat(api,admin): add duplicate-check RPC
概要: 一覧で重複を保存前に確認できるよう RPC を追加 ← Overview 節があったときだけ
Reference:
Linear: https://linear.app/<workspace>/issue/PROJ-123/... ← Reference 節 + Linear ID 抽出時のみ
Figma: https://www.figma.com/file/abcd/... ← issue から見つかったときのみ
Slack: https://<workspace>.slack.com/archives/<channel-id>/p1234567890 ← 同上
レビュー期限: 2026/02/12 18:00 (JST) ← レビュー期限節があったときだけ
PR URL: https://github.com/<owner>/<repo>/pull/<number>
次のステップ:
- /watch-ci <number> でCI監視を開始Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

