github-workflow について
ブランチ作成、コミット、プッシュ、プルリクエスト、Issue、コードレビューなどのGitHub開発作業を進めるスキルです。リポジトリ状態やコミット規約、機密情報、変更の公開に関する手順と注意事項をまとめています。
主な機能
- 01ブランチとコミットの手順
- 02プッシュとプルリクエスト作成
- 03Issueの作成と関連付け
- 04プルリクエストのレビューコマンド
- 05リポジトリとシークレットの保護
活用シーン
- 01機能ブランチを作成して規約に沿ってコミット
- 02Issueに関連付けたプルリクエストを作成
- 03プルリクエストとチェック結果をレビュー
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ transilienceai/ communitytools --skill github-workflowインストール後、Claude Code で/github-workflowを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
reference/branch-strategy.mdcommit-conventions.mdpr-workflow.md詳細
GitHub ワークフロー
ブランチ、コミット、プッシュ、PR、イシュー、コードレビューまで、GitHub での開発ライフサイクル全体を自動化します。
クイックスタート
- ユーザーが git 操作(コミット、PR、ブランチ、プッシュ、イシュー)を依頼します
- リポジトリの状態を確認します:
git status、git branch、git log --oneline -5 - 以下の該当するワークフローを実行します
- 結果をユーザーに確認します
ワークフロー
1. ブランチ作成
# Create feature branch from main
git checkout main && git pull origin main
git checkout -b <type>/<name>
# Types: feature/, bugfix/, docs/, refactor/, test/, chore/
- 常に最新の
mainからブランチを作成します - 慣例に沿った命名を使用します:
feature/add-jwt-testing、bugfix/fix-port-detection
2. コミット
# Stage specific files (never git add -A blindly)
git add <file1> <file2>
# Commit with conventional format
git commit -m "type(scope): description"
- タイプ:
feat、fix、docs、refactor、test、chore - メッセージでは、何をしたかではなく、なぜ行ったかに重点を置きます
.env、認証情報、シークレットは決してコミットしません- reference/commit-conventions.md を参照してください
3. プッシュ
# First push (set upstream)
git push -u origin <branch-name>
# Subsequent pushes
git push
- ユーザーの明示的な承認なしに、
main/masterに強制プッシュしてはいけません - プッシュが拒否された場合は、まず
git pull --rebaseを実行します
4. プルリクエスト
# Create PR linking to issue
gh pr create --title "Short title < 70 chars" --body "$(cat <<'EOF'
## Summary
- What changed and why
## Test plan
- [ ] How to verify
Fixes #<issue-number>
EOF
)"
- タイトルは 70 文字未満にし、詳細は本文に記載します
- 必ずイシューにリンクします:
Fixes #NまたはCloses #N - reference/pr-workflow.md を参照してください
5. イシュー
gh issue create --title "type: description" --body "$(cat <<'EOF'
## Problem
What needs to change
## Proposed solution
How to fix it
## Acceptance criteria
- [ ] Criteria 1
EOF
)"
6. コードレビュー
# Review a PR
gh pr view <number>
gh pr diff <number>
gh pr checks <number>
# Comment or approve
gh pr review <number> --approve
gh pr review <number> --comment --body "feedback"
リファレンス
- commit-conventions.md — コミットメッセージの形式と例
- pr-workflow.md — PR の作成、レビュー、マージのワークフロー
- branch-strategy.md — ブランチモデルと命名規則
重要なルール
- ユーザーの明示的な承認なしに、
main/masterに強制プッシュしてはいけません - シークレット、
.envファイル、認証情報は決してコミットしてはいけません - ステージング済みの内容を確認せずに、
git add -Aを決して使用してはいけません - ユーザーから明示的に求められない限り、コミット前フックを決してスキップしてはいけません(
--no-verify) - 公開済みのコミットを決して修正してはいけません。代わりに新しいコミットを作成します
- 常に慣例に沿ったコミット形式を使用します:
type(scope): description - PR は常にイシューにリンクします
- コミット前に常に
git statusを確認します - 競合を避けるため、プッシュ前に常にプルします
- 常に最新の main からブランチを作成します
コメント
Markdown 対応