create-pr-from-spec

仕様書からプルリクエストを作成

${workspaceFolder}/.github/pull_request_template.md にある pull_request_template.md テンプレートを使用して、仕様書の GitHub プルリクエストを作成します。

概要

このスキルは、仕様書から直接 GitHub プルリクエストを作成する作業を自動化します。構造化されたプロセスに従います。

1. 仕様書テンプレートの要件を分析します
2. 対象ブランチを指定してドラフト PR を作成します
3. 重複する PR がないことを確認します
4. テンプレートに準拠した内容で PR の本文とタイトルを更新します
5. PR をレビュー可能な状態にします
6. 作成者を自動的に割り当てます
7. PR の URL をユーザーに返します

主なメリット：

• ✅ 仕様書から PR を自動作成
• ✅ テンプレートに準拠した PR の本文とタイトル
• ✅ PR の重複を防止
• ✅ 作成者を自動割り当て
• ✅ 仕様書から PR へのワークフローを効率化

使用するタイミング

次の場合にこのスキルを使用します。

1. 仕様書のマージ準備ができている - 最終版の仕様書を PR に変換します
2. PR の作成を自動化したい - PR の手動作成を避けます
3. テンプレートへの準拠が必要 - PR が pull_request_template.md に従うようにします
4. 仕様書から複数の PR を作成する - 仕様書をまとめて PR に変換します
5. チームで共同作業する - 仕様書を PR として共有し、レビューを依頼します

トリガーフレーズ：

• 「仕様書からプルリクエストを作成」
• 「仕様書を PR に変換」
• 「仕様書の PR を作成」
• 「仕様書をプルリクエストとして提出」
• 「PR 作成を自動化」

手順

前提条件

このスキルを使用する前に、以下を確認してください。

• 仕様書ファイルが完成しており、レビューの準備ができている
• 対象ブランチが指定されている（例：main、develop）
• リポジトリに .github/pull_request_template.md が存在する
• PR を作成するための書き込みアクセス権がある

手順

1. 仕様書テンプレートを分析する

• ${workspaceFolder}/.github/pull_request_template.md から要件を抽出します
• 検索ツールを使用して、テンプレートのセクションとプレースホルダーを解析します

2. プルリクエストのドラフトを作成する

• create_pull_request ツールを使用して、対象ブランチ宛てにドラフト PR を作成します
• 重複を防ぐため、まず get_pull_request を使用して既存の PR がないことを確認します
• すでに PR が存在する場合は、処理を停止してユーザーに報告します

3. プルリクエストの変更内容を取得する

• get_pull_request_diff ツールを使用して差分を分析します
• 更新する前にコードの変更が正しいことを確認します

4. プルリクエストを更新する

• update_pull_request ツールを使用して、PR の本文とタイトルを設定します
• 手順 1 のテンプレートのセクションを反映します
• 必須項目がすべて入力されていることを確認します

5. レビュー可能な状態にする

• update_pull_request ツールを使用して、状態をドラフトからレビュー可能に変更します
• PR がドラフト状態ではなくなったことを確認します

6. プルリクエストを割り当てる

• get_me を使用して現在のユーザー情報を取得します
• update_issue ツールを使用して、PR を作成者に割り当てます

7. プルリクエストの URL を返す

• クリック可能な PR の URL をユーザーに提示します
• PR の内容の概要を含めます

例

例 1：基本的な PR の作成

Input: Create PR from spec to main branch
Process:
  1. Analyze pull_request_template.md
  2. Create draft PR to main
  3. Check for existing PRs
  4. Update PR title: "feat: [Feature Name from Spec]"
  5. Update PR body with template sections
  6. Mark as ready for review
  7. Assign to creator
Output: https://github.com/user/repo/pull/123

例 2：テンプレートに準拠した PR

PR Title: feat: Implement user authentication system

PR Body:
## Description
Implements JWT-based authentication with token refresh mechanism

## Related Issue
Closes #456

## Changes
- Added JWT middleware
- Implemented token validation
- Added refresh token endpoint

## Testing
- Unit tests for auth middleware
- Integration tests for token endpoints

## Checklist
- [x] Tests pass
- [x] Documentation updated
- [x] No breaking changes

例 3：重複の防止

Input: Create PR from spec
Check: PR for current branch already exists?
  → Yes: Report error, don't create duplicate
  → No: Proceed with PR creation
Output: "PR already exists at https://github.com/user/repo/pull/789"

要件

• 仕様書全体に対してプルリクエストを 1 件作成する
• 仕様書／機能を明確に示すタイトルと本文
• プルリクエストの本文が pull_request_template.md の構成に従っている
• 重複するプルリクエストがないことを確認する
• PR が作成者に自動的に割り当てられている
• ドラフト PR が残されていない

成功条件

• ✅ PR がエラーなく作成されている
• ✅ PR の本文が pull_request_template.md の構成に従っている
• ✅ PR のタイトルで仕様書／機能が明確に示されている
• ✅ ブランチに重複する PR がない
• ✅ PR が作成者に割り当てられている
• ✅ PR の URL がユーザーに返されている
• ✅ PR がレビュー可能な状態になっている（ドラフトではない）

制約事項と警告

⚠️ 重要：

• PR の作成にはリポジトリへの書き込み権限が必要です
• PR の作成前にターゲットブランチが存在している必要があります
• テンプレートファイルが .github/pull_request_template.md に存在している必要があります
• 有効なブランチターゲットがなければ PR を作成できません
• 重複する PR は検出され、拒否されます
• PR の割り当てには有効な GitHub ユーザーが必要です

🚫 制限事項：

• コードレビューは自動で実行されません
• CI/CD パイプラインは実行されません
• PR は自動でマージされません
• 既存のコードは変更できず、PR のメタデータのみ変更できます

ベストプラクティス

1. 作成前に確認する - 仕様を PR に変換する前に、必ず確認してください
2. 内容が伝わるタイトルを付ける - PR のタイトルには、機能追加または修正の目的を明確に示してください
3. テンプレートを完成させる - 必須のテンプレートセクションがすべて記入されていることを確認してください
4. 関連するイシューをリンクする - PR の本文にイシューへの参照を含めてください
5. まずテストする - PR を作成する前に、すべてのテストが合格することを確認してください
6. チームでレビューする - レビュー可能な状態にする前に、チームの承認を得てください
7. Git 履歴を整理する - コミットが整理され、適切に記録されていることを確認してください

使用するツール

• search - 仕様テンプレートの要件を分析します
• create_pull_request - ドラフトモードで新しい PR を作成します
• get_pull_request - 作成前に既存の PR を確認します
• get_pull_request_diff - PR の変更を分析します
• update_pull_request - PR のタイトル、本文、状態を更新します
• update_issue - PR を作成者に割り当てます
• get_me - 現在のユーザー情報を取得します