name	github-publish
description	GitHub へローカル変更を公開する workflow。ユーザーが commit、branch push、PR 作成、publish を依頼した場合に、通常の git と gh pr create で安全に実行します。

GitHub Publish Skill

ローカル変更を commit し、branch を GitHub に push して、Pull Request を作成するための workflow です。目的は publish 操作を通常の Git/GitHub CLI 手順に揃え、Codex の permission 判定や shell の癖で失敗しにくくすることです。

使う場面

ユーザーが「commit して」「push して」「PR 作成して」「publish して」と依頼した場合。
既に作成済みの PR branch に追加修正を反映する場合。
作業 branch を GitHub に上げ、PR URL まで返す必要がある場合。

原則

commit と branch 作成は local git で行う。
remote 反映は通常の git push で行う。
PR 作成は gh pr create で行う。
publish 目的で gh api を使って commit、tree、ref、PR を作らない。
force push は実行しない。git push --force と git push -f は禁止。
既存のユーザー変更を勝手に stage、revert、削除しない。
worktree に対象外の変更が混在している場合は、stage するファイルを明示的に限定する。

事前確認

GitHub CLI と認証状態を確認する。

gh --version
gh auth status

repository と作業状態を確認する。

git status -sb
git diff
git remote -v
gh repo view --json isPrivate,defaultBranchRef,nameWithOwner

current branch を確認し、既存 PR の有無を確認する。

git branch --show-current
gh pr list --head <branch> --state open

Branch

default branch 上で作業している場合は、<prefix>/<short-description> 形式の新規 branch を作る。
既に作業 branch 上なら、原則その branch を使う。
既存 PR に反映する場合は、その PR の head branch を使う。

git branch --show-current
git switch -c <branch>

Commit

git add -A は、worktree 全体が今回の scope だと確認できた場合だけ使う。
混在 worktree では対象ファイルを明示して stage する。
commit message は project AGENTS.md の規則に従う。

git add <path> ...
git commit -m "<type>: <imperative subject>"

Push

push する branch 名は git branch --show-current で確認し、次のコマンドに明示的に書く。
shell command substitution を使った git push -u origin $(git branch --show-current) は避ける。

git branch --show-current
git push -u origin <branch>

既存 remote branch へ追加 commit を反映する場合:

git push origin <branch>

PR

PR 作成前に repository の公開範囲を確認する。
private repository の PR 本文は日本語、public repository の PR 本文は英語で書く。
PR body は project AGENTS.md の構造に従う。

gh repo view --json isPrivate --jq '.isPrivate'
gh pr create --base <base> --head <branch> --title "<title>" --body "<body>"

本文構造:

## Why

- <background>
- <related issue or N/A>

## What

- <change>

## Reference

- <reference or N/A>

失敗時

git add、git commit、git push が sandbox、filesystem permission、認証、remote 設定の問題で失敗した場合は、gh api で代替せず、失敗したコマンドと原因を具体的に報告する。
現在の checkout の .git に書けないがユーザーが PR 反映の継続を求めている場合は、書き込み可能な一時 clone または worktree を作り、そこで通常の git commit と git push を実行する。
HTTPS remote で認証に失敗し、gh auth status が Git operations protocol を ssh と示す場合は、remote URL を SSH に変更して通常の git push を再試行する。
fork や cross-repository PR で gh pr create が base/head を推測できない場合は、--base <branch> と --head <owner>:<branch> を明示する。

Más de este repositorio

mismo repositorio

systematic-debugging

jedipunkz/dotfiles

Reproduce and debug failures through an evidence-first root-cause workflow. Use when tests fail, a bug is reported, behavior is flaky, an error message needs investigation, or the user asks to debug, diagnose, investigate, or fix a failure.

2026-07-112

test-driven-development

jedipunkz/dotfiles

Apply a focused red-green-refactor workflow for behavior changes and bug fixes. Use when the user asks for TDD, regression tests, test-first implementation, bug fixes with tests, or when a change has clear observable behavior that should be protected by tests.

2026-07-112

verification-before-completion

jedipunkz/dotfiles

Verify completed work before reporting it as done. Use after making code, config, documentation, workflow, or UI changes; when the user asks whether something is fixed; when a dev server is started; or before claiming implementation, debugging, migration, or setup work is complete.

2026-07-112

web-research

jedipunkz/dotfiles

Research current or uncertain information on the web using source-aware evidence. Use when the user asks to research, look up, browse, verify latest information, compare public options, find recommendations, cite sources, or when facts may have changed recently.

2026-07-112

finance-mcp

jedipunkz/dotfiles

株価・為替・暗号資産・財務データを MCP サーバ (alphavantage / twelvedata / edinetdb) 経由で取得・分析します。「株価を調べて」「銘柄の推移を」「為替レート」「企業の財務を」「決算」「ASCII グラフにして」「米国株 / 日本株を調査」などのリクエストがあった場合に使用します。

2026-06-202

codex-review

jedipunkz/dotfiles

ネストした OpenAI Codex CLI でコード、設定ファイル、ドキュメントのレビューを実行します。通常は Codex 組み込みの /review を優先し、ユーザーが明示的に「別 Codex でレビュー」「codex exec でレビュー」と頼んだ場合にだけ使用します。

2026-05-032

name	github-publish
description	GitHub へローカル変更を公開する workflow。ユーザーが commit、branch push、PR 作成、publish を依頼した場合に、通常の git と gh pr create で安全に実行します。

GitHub Publish Skill

使う場面

ユーザーが「commit して」「push して」「PR 作成して」「publish して」と依頼した場合。
既に作成済みの PR branch に追加修正を反映する場合。
作業 branch を GitHub に上げ、PR URL まで返す必要がある場合。

原則

commit と branch 作成は local git で行う。
remote 反映は通常の git push で行う。
PR 作成は gh pr create で行う。
publish 目的で gh api を使って commit、tree、ref、PR を作らない。
force push は実行しない。git push --force と git push -f は禁止。
既存のユーザー変更を勝手に stage、revert、削除しない。
worktree に対象外の変更が混在している場合は、stage するファイルを明示的に限定する。

事前確認

GitHub CLI と認証状態を確認する。

gh --version
gh auth status

repository と作業状態を確認する。

git status -sb
git diff
git remote -v
gh repo view --json isPrivate,defaultBranchRef,nameWithOwner

current branch を確認し、既存 PR の有無を確認する。

git branch --show-current
gh pr list --head <branch> --state open

Branch

default branch 上で作業している場合は、<prefix>/<short-description> 形式の新規 branch を作る。
既に作業 branch 上なら、原則その branch を使う。
既存 PR に反映する場合は、その PR の head branch を使う。

git branch --show-current
git switch -c <branch>

Commit

git add -A は、worktree 全体が今回の scope だと確認できた場合だけ使う。
混在 worktree では対象ファイルを明示して stage する。
commit message は project AGENTS.md の規則に従う。

git add <path> ...
git commit -m "<type>: <imperative subject>"

Push

push する branch 名は git branch --show-current で確認し、次のコマンドに明示的に書く。
shell command substitution を使った git push -u origin $(git branch --show-current) は避ける。

git branch --show-current
git push -u origin <branch>

既存 remote branch へ追加 commit を反映する場合:

git push origin <branch>

PR

PR 作成前に repository の公開範囲を確認する。
private repository の PR 本文は日本語、public repository の PR 本文は英語で書く。
PR body は project AGENTS.md の構造に従う。

gh repo view --json isPrivate --jq '.isPrivate'
gh pr create --base <base> --head <branch> --title "<title>" --body "<body>"

本文構造:

## Why

- <background>
- <related issue or N/A>

## What

- <change>

## Reference

- <reference or N/A>

失敗時

git add、git commit、git push が sandbox、filesystem permission、認証、remote 設定の問題で失敗した場合は、gh api で代替せず、失敗したコマンドと原因を具体的に報告する。
現在の checkout の .git に書けないがユーザーが PR 反映の継続を求めている場合は、書き込み可能な一時 clone または worktree を作り、そこで通常の git commit と git push を実行する。
HTTPS remote で認証に失敗し、gh auth status が Git operations protocol を ssh と示す場合は、remote URL を SSH に変更して通常の git push を再試行する。
fork や cross-repository PR で gh pr create が base/head を推測できない場合は、--base <branch> と --head <owner>:<branch> を明示する。