create-pr について
create-pr は、ブランチ間の変更を分析し、Conventional Commits 形式のタイトルと構造化された説明を作成して、Gitee に Pull Request を登録するスキルです。設定済みの Gitee MCP サーバーを使うコントリビューター向けで、リポジトリとブランチ情報が必要です。
主な機能
- 01比較元と比較先のブランチを比較
- 02変更ファイルと互換性のない変更を分析
- 03構造化された PR 説明を作成
- 04Gitee に Pull Request を登録
- 05Issue の任意リンク
活用シーン
- 01機能ブランチから PR を準備
- 02リリースブランチ間の変更を要約
- 03新しい PR に Gitee Issue を関連付け
MCP 対応
このスキルは、ブランチ比較や Pull Request 作成のツールを含む、設定済みの Gitee MCP サーバーを利用します。関連ツールが利用可能である必要があります。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ oschina/ gitee-agent-skills --skill create-prインストール後、Claude Code で/create-prを入力して読み込まれたか確認します。
詳細
注:ローカルに
mcporterがインストールされている場合は、MCP ツールを直接呼び出すのではなく、mcporterを使って呼び出してください。mcporterCLI を使うと、より便利なインターフェースと優れたエラー処理を利用できます。
Gitee MCP で PR を作成する
現在の変更に基づいて、適切に構成されたプルリクエストの説明を生成し、Gitee に送信します。
前提条件
- Gitee MCP Server が設定されていること(ツール:
create_pull、get_file_content、list_repo_issues、compare_branches_tags) - ユーザーがリポジトリのオーナー、リポジトリ名、ソースブランチ、ターゲットブランチ(通常は main/master)を指定すること
- Issue 番号は任意です
手順
Step 1: 情報を収集する
ユーザーに確認するか、コンテキストから推測します。
- ソースブランチ(head ブランチ)
- ターゲットブランチ(base ブランチ、デフォルト:master または main)
- この PR の主な目的(指定されていない場合は、コミットメッセージまたはファイルの変更から推測)
- Issue を関連付けるかどうか(任意)
Step 2: 変更を分析する
compare_branches_tags を使用して、ソースブランチとターゲットブランチ間の差分を取得します。
base:ターゲットブランチ(例:mainまたはmaster)head:ソースブランチ
返された差分を分析し、次の点を確認します。
- 変更された主なファイル
- 追加または変更された機能
- 破壊的変更の有無
Step 3: PR タイトルを生成する
Conventional Commits の形式に従います。
<type>(<scope>): <subject>
使用できるタイプ:
feat:新機能fix:バグ修正refactor:コードのリファクタリングdocs:ドキュメントの更新test:テスト関連の変更chore:ビルド/依存関係/ツールチェーンの変更
例:feat(auth): add OAuth2 login support
Step 4: PR の説明を生成する
次のテンプレートを使用して、構成された説明を作成します。
## Summary
[Clear description of the purpose of this PR and the problem it solves]
## Changes
- [Change 1]
- [Change 2]
- [Change 3]
## Testing
- [ ] Unit tests pass
- [ ] Functional tests pass
- [x] [Completed test item]
## Related Issue
closes #[issue number] (if applicable)
## Notes
[Breaking changes, dependency upgrades, deployment considerations, etc. (if any)]
Step 5: PR を作成する
create_pull を使用し、次のパラメーターで PR を作成します。
title:Step 3 で生成したタイトルbody:Step 4 で生成した説明head:ソースブランチbase:ターゲットブランチ
作成に成功したら、ユーザーに PR のリンクを出力します。
注意事項
- ユーザーが関連付ける Issue を指定した場合は、説明に
closes #Nを追加して、PR のマージ時に Issue が自動的にクローズされるようにします - PR のタイトルは簡潔に(50 文字未満)し、詳細は説明に記載します
- ユーザーから十分な情報が提供されていない場合は、説明が空の PR を作成しないよう、作成前に確認します