AgentSkillsCN

pr

PR创建技能。无论是用于规格评审,还是用于实现评审,均可创建相应的Pull Request。该技能可从/spec或spec-workflow中被调用。

SKILL.md
--- frontmatter
name: pr
description: PR作成Skill。仕様レビュー用または実装レビュー用のPRを作成。/spec や spec-workflow から呼び出される。

/pr Skill - プルリクエスト作成

SDDワークフローにおけるPR作成を担当するSkill。 仕様策定・実装それぞれのフェーズで適切なPRを作成します。

発動条件

  • /pr コマンドで明示的に呼び出し
  • /spec Skill から自動呼び出し(仕様策定完了時)
  • spec-workflow Skill から自動呼び出し(実装完了時)

PRタイトル規則

仕様策定用

code
spec: {アクションタイトル}

例: spec: ユーザー認証機能の仕様策定

実装用

code
impl: {アクションタイトル}

例: impl: ユーザー認証機能の実装

ワークフロー

code
┌─────────────────────────────────────────────────┐
│  1. 変更確認                                    │
│     - git status で変更内容を確認               │
│     - git diff で差分を確認                     │
│                                                 │
│  2. コミット確認                                │
│     - 未コミットの変更があればコミット          │
│     - コミットメッセージを生成                  │
│                                                 │
│  3. リモートへプッシュ                          │
│     git push -u origin {branch-name}            │
│                                                 │
│  4. PR内容生成                                  │
│     - タイトル: 規則に従って生成                │
│     - サマリー: 変更内容の要約                  │
│     - テストプラン: 検証項目                    │
│                                                 │
│  5. ユーザー確認                                │
│     「このPRを作成しますか?」                  │
│                                                 │
│  6. PR作成                                      │
│     gh pr create                                │
│                                                 │
│  7. 【サブエージェント発火】quality-gate(必須)│
│     - 全AC充足の最終確認                        │
│     - テスト通過の確認                          │
│     - マージ可否の判定                          │
│                                                 │
│  8. 完了通知                                    │
│     PR URLを表示 + quality-gate結果             │
└─────────────────────────────────────────────────┘

パラメータ

パラメータ必須説明
typeYesPRタイプspec or impl
action-idNoアクションID(ブランチ名から自動取得可)001-01-01
baseNoベースブランチ(デフォルト: main)main

PRテンプレート

仕様策定用

markdown
## Summary

- {アクションID} の仕様を策定
- {生成したファイル一覧}

## 変更内容

- specs/phases/{id}.md: フェーズ定義
- specs/tasks/{id}.md: タスク定義
- specs/actions/{id}.md: アクション定義

## レビュー観点

- [ ] ユーザーストーリーが明確か
- [ ] ACがEARS記法で記述されているか
- [ ] 依存関係が整理されているか
- [ ] スコープが適切か

🤖 Generated with [Claude Code](https://claude.com/claude-code)

実装用

markdown
## Summary

- {アクションID} を実装
- {実装した機能の概要}

## 変更内容

- {変更ファイル一覧}

## Test plan

- [ ] 全ACのテストが通過
- [ ] TDDサイクルを遵守
- [ ] スコープ外の変更なし

## AC確認

- [x] {AC1}
- [x] {AC2}
- [x] {AC3}

🤖 Generated with [Claude Code](https://claude.com/claude-code)

使用例

直接呼び出し

code
ユーザー: /pr

Claude: 現在のブランチ: impl/001-01-01-user-auth

        以下のPRを作成しますか?

        タイトル: impl: ユーザー認証機能の実装
        ベース: main

        ## Summary
        - 001-01-01 を実装
        - ログイン/ログアウト機能

        ## Test plan
        - [ ] 全ACのテストが通過
        ...

ユーザー: OK

Claude: ✅ PRを作成しました
        URL: https://github.com/user/repo/pull/123

/spec からの自動呼び出し

code
[/spec Skill 内部]
→ ファイル生成完了後に /pr を発火
→ type: spec
→ 仕様レビュー用PRを作成

spec-workflow からの自動呼び出し

code
[spec-workflow Skill 内部]
→ 実装完了・AC全チェック後に /pr を発火
→ type: impl
→ 実装レビュー用PRを作成

実行コマンド

bash
# 変更確認
git status
git diff

# コミット(必要な場合)
git add .
git commit -m "..."

# プッシュ
git push -u origin {branch-name}

# PR作成
gh pr create --title "{title}" --body "{body}"

エラーハンドリング

変更がない場合

code
Claude: コミットする変更がありません。

対応案:
1. 作業を続ける
2. 既存のコミットでPRを作成

どれを選択しますか?

リモートに既にPRがある場合

code
Claude: このブランチには既にPRが存在します。
        URL: https://github.com/user/repo/pull/123

対応案:
1. 既存のPRを更新(追加コミットをプッシュ)
2. 既存のPRを閉じて新規作成

どれを選択しますか?

gh CLI が未認証の場合

code
Claude: GitHub CLIが認証されていません。

以下のコマンドで認証してください:
gh auth login

サブエージェント発火(自動)

本Skillは以下のサブエージェントを自動発火します。

quality-gate(必須発火)

発火タイミング: PR作成後、マージ前

発火条件: 全PR必須(スキップ不可)

実行内容:

code
Claude: PRを作成しました。品質ゲートチェックを実行します。

[quality-gate サブエージェント発火]
- 全AC充足の最終確認
- テスト通過の確認
- レビュー完了の確認
- マージ可否の判定

結果:
## 品質ゲート結果

| チェック項目 | 結果 | 詳細 |
|-------------|------|------|
| AC充足 | ✅/❌ | [詳細] |
| テスト | ✅/❌ | [詳細] |
| レビュー | ✅/❌ | [詳細] |

**判定**: マージ可能 / マージ不可

判定基準:

項目必須条件
AC充足全ACにチェックが入っていること
テスト全テストがパスしていること
レビューspec-reviewer または code-reviewer が完了していること
セキュリティ重大な脆弱性がないこと

マージ不可の場合:

code
Claude: 品質ゲートチェックで問題が検出されました。

❌ 未達成項目:
- [項目1]: [理由]
- [項目2]: [理由]

対応後、再度 quality-gate を実行してください。

禁止事項

  • ユーザー確認なしのPR作成
  • テスト未通過でのPR作成(impl時)
  • 空のPR作成
  • ベースブランチへの直接プッシュ
  • quality-gateをスキップしてのマージ推奨