К основному содержанию
команда CX Codex

devkit.github.create-pr — команда для Claude Code: создание PR

Команда devkit.github.create-pr для Claude Code создаёт ветку, коммиты по Conventional Commits и pull request на GitHub по заголовку PR, целевой ветке и языку описания.

MIT ★ 372 обновлён 2026-09-10

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add giuseppe-trisciuoglio/developer-kit
/plugin install developer-kit@developer-kit
Открыть на GitHub

Что делает devkit.github.create-pr

Команда работает в Claude Code и использует только git и gh — GitHub CLI должен быть авторизован через gh auth login, иначе выполнение прервётся на первой же проверке.

Процесс разбит на фазы. Сначала команда проверяет, что репозиторий существует, есть незакоммиченные изменения и настроен remote. Затем анализирует изменённые файлы и решает, делать один коммит или несколько: если изменения затрагивают разные компоненты — фичу и тесты, код и конфиги — они разбиваются на отдельные коммиты. Имя ветки генерируется из заголовка PR или из пути первого изменённого файла. После пуша создаётся PR с шаблоном описания на выбранном языке: секции описания, списка изменений, тестирования и чеклиста.

Если заголовок PR не передан, команда сгенерирует его сама из контекста изменений. Целевая ветка по умолчанию берётся из HEAD branch remote, а не жёстко задана как main.

Какие задачи решает

  • создать ветку и открыть PR одной командой без ручного набора git и gh
  • сгенерировать коммиты в формате Conventional Commits по изменённым файлам
  • разбить смешанные изменения на несколько логических коммитов
  • оформить описание PR на нужном языке — английском, итальянском, испанском, французском или немецком
  • проверить аутентификацию GitHub CLI перед отправкой изменений

Примеры запросов агенту

  • Открой PR с заголовком «Add OAuth support» в ветку develop: /devkit.github.create-pr "Add OAuth support" develop
  • Создай PR с описанием на итальянском: /devkit.github.create-pr "Correzione bug" main it
  • Запусти команду без аргументов — заголовок и целевая ветка определятся автоматически: /devkit.github.create-pr

Как установить devkit.github.create-pr

1Через маркетплейс плагинов

/plugin marketplace add giuseppe-trisciuoglio/developer-kit
/plugin install developer-kit@developer-kit

2Вручную: положить файлы

.claude/commands/devkit.github.create-pr.md

Вызов — /devkit.github.create-pr. Для всех проектов — ~/.claude/commands/

Вопросы о devkit.github.create-pr

Как установить devkit.github.create-pr в Claude Code?

Выполните две команды: сначала /plugin marketplace add giuseppe-trisciuoglio/developer-kit, затем /plugin install developer-kit@developer-kit. После этого файл команды появится по пути .claude/commands/devkit.github.create-pr.md.

Что делает команда devkit.github.create-pr?

Создаёт новую ветку, формирует один или несколько коммитов по Conventional Commits, пушит ветку на remote и открывает GitHub pull request с шаблоном описания. Заголовок PR и целевая ветка передаются аргументами или генерируются автоматически.

Нужен ли GitHub CLI для работы команды?

Да. Команда использует gh для создания PR, поэтому до запуска нужно выполнить gh auth login. Без авторизованного GitHub CLI выполнение остановится на этапе pre-flight проверки.

Исходный текст

devkit.github.create-pr.md · MIT
---
description: Creates a GitHub pull request with branch creation, commits, and detailed description. Use when you need to submit changes for review.
allowed-tools: Bash(git *), Bash(gh *)
argument-hint: "[pr-title] [target-branch] [language]"
---

# Create GitHub Pull Request

## Overview

Creates a GitHub pull request with branch creation, commits, and detailed description. Use when you need to submit
changes for review.

## Usage

```
/devkit.github.create-pr $ARGUMENTS
```

## Arguments

| Argument     | Description                              |
|--------------|------------------------------------------|
| `$ARGUMENTS` | Combined arguments passed to the command |

## Current Context

- **Current Branch**: !`git branch --show-current`
- **Git Status**: !`git status --porcelain`
- **Remote Repository**: !`git config --get remote.origin.url`
- **Modified Files**: !`git diff --name-only`

## Execution Instructions

**Agent Selection**: To execute this GitHub task, use the following approach:

- Primary: Use `general-purpose` agent with GitHub CLI expertise and code analysis capabilities

## Configuration

**Arguments received**: `$ARGUMENTS`

**$1**: PR title (optional - will be generated if not provided)
**$2**: Target branch (optional - defaults to `main` or `master`)
**$3**: Language for PR description (optional - defaults to `en`)

**Supported languages**: `en`, `it`, `es`, `fr`, `de`

## Phase 1: Pre-Flight Validation

### 1.1 Check Working Directory

Verify git repository and working directory status:

```bash
# Verify git repository
if ! git rev-parse --git-dir > /dev/null 2>&1; then
    echo "Error: Not a git repository"
    exit 1
fi

# Check for uncommitted changes
if [ -z "$(git status --porcelain)" ]; then
    echo "Error: No changes to commit"
    exit 1
fi

# Verify remote repository exists
if ! git config --get remote.origin.url > /dev/null 2>&1; then
    echo "Error: No remote repository configured"
    exit 1
fi

# Check GitHub CLI authentication
if ! gh auth status > /dev/null 2>&1; then
    echo "Error: GitHub CLI not authenticated. Run: gh auth login"
    exit 1
fi
```

### 1.2 Determine Target Branch

```bash
# Detect default branch
TARGET_BRANCH="${2:-$(git remote show origin | grep 'HEAD branch' | cut -d' ' -f5)}"
if [ -z "$TARGET_BRANCH" ]; then
    TARGET_BRANCH="main"
fi

echo "Target branch: $TARGET_BRANCH"
```

## Phase 2: Change Analysis

### 2.1 Analyze Modified Files

```bash
# Get list of modified files
MODIFIED_FILES=$(git diff --name-only)
STAGED_FILES=$(git diff --cached --name-only)
UNTRACKED_FILES=$(git ls-files --others --exclude-standard)

echo "Modified files:"
echo "$MODIFIED_FILES"
echo ""
echo "Staged files:"
echo "$STAGED_FILES"
echo ""
echo "Untracked files:"
echo "$UNTRACKED_FILES"
```

### 2.2 Categorize Changes

Analyze changes by type:

- **Feature additions**: New files, new functionality
- **Bug fixes**: Corrections to existing code
- **Refactoring**: Code improvements without behavior changes
- **Documentation**: README, comments, docs
- **Configuration**: Build files, properties, YAML configs
- **Tests**: Test files and test data

## Phase 3: Branch Creation

### 3.1 Generate Branch Name

```bash
# Generate branch name from PR title or changes
if [ -n "$1" ]; then
    BRANCH_NAME=$(echo "$1" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/--*/-/g' | sed 's/^-//;s/-$//')
else
    # Generate from changed files
    MAIN_CHANGE=$(echo "$MODIFIED_FILES" | head -1 | xargs dirname | sed 's/\//-/g')
    BRANCH_NAME="feature/${MAIN_CHANGE}-$(date +%s)"
fi

# Ensure unique branch name
COUNTER=1
ORIGINAL_BRANCH=$BRANCH_NAME
while git show-ref --verify --quiet refs/heads/$BRANCH_NAME; do
    BRANCH_NAME="${ORIGINAL_BRANCH}-${COUNTER}"
    ((COUNTER++))
done

echo "Branch name: $BRANCH_NAME"
```

### 3.2 Create and Switch Branch

```bash
# Create new branch
git checkout -b "$BRANCH_NAME"

echo "Created and switched to branch: $BRANCH_NAME"
```

## Phase 4: Commit Strategy

### 4.1 Analyze Commit Splitting

Determine if changes should be split into multiple commits:

**Single commit when**:

- Single file modified
- Related changes in same component
- Small focused change

**Multiple commits when**:

- Changes span multiple features
- Mix of feature and tests
- Configuration and code changes
- Documentation and implementation

### 4.2 Create Commits

```bash
# Stage all changes
git add -A

# Get diff statistics
TOTAL_ADDITIONS=$(git diff --cached --numstat | awk '{s+=$1} END {print s}')
TOTAL_DELETIONS=$(git diff --cached --numstat | awk '{s+=$2} END {print s}')
FILES_CHANGED=$(git diff --cached --name-only | wc -l)

echo "Changes: +$TOTAL_ADDITIONS -$TOTAL_DELETIONS across $FILES_CHANGED files"
```

### 4.3 Generate Commit Messages

Follow Conventional Commits specification:

```
<type>(<scope>): <description>

<body>

<footer>
```

**Types**:

- `feat`: New feature
- `fix`: Bug fix
- `docs`: Documentation changes
- `style`: Code style/formatting
- `refactor`: Code refactoring
- `test`: Test additions/modifications
- `chore`: Build, dependencies, tooling
- `perf`: Performance improvements
- `ci`: CI/CD changes
- `security`: Security improvements

**Example commits**:

```bash
# Feature commit
git commit -m "feat(user-service): add email verification functionality

- Implement email verification service
- Add verification token generation
- Create email template
- Add integration tests

Closes #123"

# Bug fix commit
git commit -m "fix(auth): resolve JWT token expiration issue

JWT tokens were expiring prematurely due to timezone
miscalculation. Updated to use UTC consistently.

Fixes #456"

# Refactoring commit
git commit -m "refactor(repository): simplify user query methods

- Remove duplicate code
- Extract common query logic
- Improve method naming
- Add Javadoc comments"
```

## Phase 5: Push and PR Creation

### 5.1 Push Branch

```bash
# Push to remote
git push -u origin "$BRANCH_NAME"

echo "Pushed branch to remote: $BRANCH_NAME"
```

### 5.2 Generate PR Description

Create PR description based on language preference:

**English Template**:

```markdown
## Description

Brief description of changes and motivation.

## Changes

- Change 1
- Change 2
- Change 3

## Testing

Description of testing performed:

- Unit tests added/updated
- Integration tests verified
- Manual testing completed

## Checklist

- [ ] Code follows project style guidelines
- [ ] Tests added/updated and passing
- [ ] Documentation updated
- [ ] No breaking changes
- [ ] Backward compatible
```

**Italian Template**:

```markdown
## Descrizione

Breve descrizione delle modifiche e motivazione.

## Modifiche

- Modifica 1
- Modifica 2
- Modifica 3

## Test

Descrizione dei test eseguiti:

- Test unitari aggiunti/aggiornati
- Test di integrazione verificati
- Test manuali completati

## Checklist

- [ ] Il codice segue le linee guida del progetto
- [ ] Test aggiunti/aggiornati e funzionanti
- [ ] Documentazione aggiornata
- [ ] Nessuna breaking change
- [ ] Retrocompatibile
```

### 5.3 Create Pull Request

```bash
# Detect language
LANG="${3:-en}"

# Generate PR description
case "$LANG" in
    it)
        DESCRIPTION="## Descrizione\n\n[Descrivi le modifiche]\n\n## Modifiche\n\n- [Modifica 1]\n\n## Test\n\n- Test unitari aggiornati\n- Test di integrazione verificati"
        ;;
    es)
        DESCRIPTION="## Descripción\n\n[Describe los cambios]\n\n## Cambios\n\n- [Cambio 1]\n\n## Pruebas\n\n- Tests unitarios actualizados\n- Tests de integración verificados"
        ;;
    fr)
        DESCRIPTION="## Description\n\n[Décrivez les modifications]\n\n## Modifications\n\n- [Modification 1]\n\n## Tests\n\n- Tests unitaires mis à jour\n- Tests d'intégration vérifiés"
        ;;
    de)
        DESCRIPTION="## Beschreibung\n\n[Beschreiben Sie die Änderungen]\n\n## Änderungen\n\n- [Änderung 1]\n\n## Tests\n\n- Unit-Tests aktualisiert\n- Integrationstests überprüft"
        ;;
    *)
        DESCRIPTION="## Description\n\n[Describe the changes]\n\n## Changes\n\n- [Change 1]\n\n## Testing\n\n- Unit tests updated\n- Integration tests verified"
        ;;
esac

# Create PR
gh pr create \
    --base "$TARGET_BRANCH" \
    --head "$BRANCH_NAME" \
    --title "${1:-Automated PR from $BRANCH_NAME}" \
    --body "$(echo -e "$DESCRIPTION")" \
    --web

echo "Pull request created successfully"
```

## Phase 6: Post-Creation

### 6.1 PR Information

```bash
# Get PR number and URL
PR_NUMBER=$(gh pr view --json number -q .number)
PR_URL=$(gh pr view --json url -q .url)

echo ""
echo "Pull Request Details:"
echo "Number: #$PR_NUMBER"
echo "URL: $PR_URL"
echo "Branch: $BRANCH_NAME -> $TARGET_BRANCH"
echo ""
```

### 6.2 Optional Actions

Available post-creation actions:

```bash
# Add labels
gh pr edit $PR_NUMBER --add-label "enhancement"
gh pr edit $PR_NUMBER --add-label "ready-for-review"

# Add reviewers
gh pr edit $PR_NUMBER --add-reviewer "username1,username2"

# Add assignees
gh pr edit $PR_NUMBER --add-assignee "@me"

# Request reviews
gh pr review $PR_NUMBER --comment -b "Please review when ready"

# Enable auto-merge (if repository allows)
gh pr merge $PR_NUMBER --auto --squash
```

## Best Practices

### Commit Message Guidelines

**Good commit messages**:

```
feat(api): add user authentication endpoint
fix(validation): correct email format validation
docs(readme): update installation instructions
test(user-service): add integration tests for user creation
refactor(utils): simplify date formatting utility
```

**Bad commit messages**:

```
update files
fix bug
changes
wip
asdf
```

### PR Title Guidelines

**Good PR titles**:

- "Add JWT authentication to user service"
- "Fix memory leak in background job processor"
- "Refactor user repository to use Spring Data JPA"
- "Update Spring Boot to version 3.2.0"

**Bad PR titles**:

- "Update"
- "Changes"
- "Fix"
- "WIP"

### PR Description Best Practices

1. **Clear summary**: Explain what and why
2. **Bullet points**: List specific changes
3. **Testing details**: How was it tested
4. **Screenshots**: For UI changes
5. **Breaking changes**: Clearly marked
6. **Related issues**: Link to issues
7. **Dependencies**: Mention related PRs
8. **Deployment notes**: Special deployment steps

## Error Handling

### Common Issues

**Authentication Error**:

```bash
# Authenticate with GitHub CLI
gh auth login
```

**Branch Already Exists**:

```bash
# Switch to existing branch
git checkout existing-branch
# Or delete and recreate
git branch -D existing-branch
git checkout -b existing-branch
```

**Merge Conflicts**:

```bash
# Update from target branch
git fetch origin
git merge origin/$TARGET_BRANCH
# Resolve conflicts manually
git add .
git commit -m "Resolve merge conflicts"
```

**No Changes to Commit**:

```bash
# Check status
git status
# Verify files are modified
git diff
```

## Integration with CI/CD

The PR will automatically trigger:

- **CI Pipeline**: Build and test execution
- **Code Quality**: SonarQube analysis
- **Security Scan**: Dependency vulnerability check
- **Linting**: Code style validation
- **Coverage**: Test coverage report

## Your Task

Based on the provided arguments:

1. Analyze current changes in the working directory
2. Create an appropriate branch name
3. Categorize and commit changes logically
4. Generate clear commit messages following Conventional Commits
5. Push branch to remote repository
6. Create pull request with description in the specified language
7. Provide PR details and next steps

**Remember**: Keep PR descriptions concise and professional without emojis. Focus on technical content and clarity.

## Examples

### Example 1: Simple Feature PR

```bash
# Create PR with title and default settings
/developer-kit:devkit.github.create-pr "Add user profile API"
```

### Example 2: Bug Fix PR with Custom Target

```bash
# Create PR targeting specific branch
/developer-kit:devkit.github.create-pr "Fix authentication timeout" develop
```

### Example 3: PR with Italian Description

```bash
# Create PR with Italian description
/developer-kit:devkit.github.create-pr "Aggiungere validazione email" main it
```

### Example 4: Auto-Generated PR

```bash
# Let the command generate title from changes
/developer-kit:devkit.github.create-pr
```

© Giuseppe Trisciuoglio · MIT · giuseppe-trisciuoglio/developer-kit

Похожие слэш-команды

Все слэш-команды по теме «Git и GitHub» →
github-pr gentleman-programming Скилл github-pr задаёт правила оформления пулл-реквестов по стандарту Conventional Commits и готовит вызовы gh pr create без рутины. CX Codex +1 205установок create-pr marcelorodrigo Скилл create-pr оформляет и публикует пулл-реквесты в GitHub по инженерным стандартам через GitHub CLI. CX Codex +1 312установок create-pull-request davila7 Слэш-команда create-pull-request для Claude Code создаёт pull request через GitHub CLI по шаблону проекта. Запускается, когда ветка готова к ревью и нужно оформить PR в черновик с заполненным описанием. CX Codex +1 411установок github swarmclawai Управляет задачами, пулл-реквестами и CI-пайплайнами на GitHub через утилиту gh. Разбирает упавшие тесты и проверяет статус PR прямо в чате. CX Codex +1 ★ 710звёзд репо github-fix-issue feiskyer Скилл github-fix-issue для Claude Code ведёт от чтения задачи GitHub до проверки изменений и отправки pull request через CLI. CX Codex +1 205установок jackin-create-pr jackin-project Скилл jackin-create-pr открывает pull request для небольшой правки в репозитории jackin❯: типо, обновление зависимости, строчный багфикс. Тело PR собирается по шаблону с готовыми блоками verify-locally. CX Codex +1 469установок

Из того же набора191

Весь набор →
general-refactor-expert Субагент general-refactor-expert для планомерного рефакторинга кодовой базы без потери функциональности. Находит запахи кода, дробит длинные функции и перестраивает архитектуру по SOLID. CX Codex ★ 372звёзд репо aws-cloudformation-rds Скилл aws-cloudformation-rds для Claude Code помогает создавать CloudFormation-шаблоны Amazon RDS для инстансов, Aurora-кластеров, multi-AZ и сетевых компонентов. Описывает инфраструктуру баз данных. CX Codex +1 ★ 372звёзд репо server-feature-conventions Правило server-feature-conventions задаёт структуру серверных фич-библиотек с NestJS модулями, DynamoDB репозиториями и сервисами. Помогает держать консистентность кода в libs/server/ и генерировать скелет новой фичи по шаблону. CX Codex +1 ★ 372звёзд репо aws-cloudformation-lambda Скилл aws-cloudformation-lambda для Claude Code содержит шаблоны CloudFormation для функций AWS Lambda: триггеры S3 и SQS, HTTP API Gateway, роли IAM и мониторинг CloudWatch. CX Codex +1 ★ 372звёзд репо aws-drawio-architecture-diagrams Скилл aws-drawio-architecture-diagrams для Claude Code генерирует AWS-архитектуры в формате .drawio с официальными иконками aws4 по описанию инфраструктуры. CX Codex +1 ★ 372звёзд репо devkit.java.code-review Команда devkit.java.code-review проводит ревью Java-кода на Spring Boot: ищет уязвимости по OWASP, проверяет архитектуру, чинит проблемы производительности и инъекцию зависимостей перед мерджем. CX Codex +1 ★ 372звёзд репо devkit.java.write-integration-tests Команда devkit.java.write-integration-tests для Claude Code генерирует интеграционные тесты для классов Spring Boot. Запускайте её для сервисов и репозиториев, передав путь к классу. CX Codex +1 ★ 372звёзд репо devkit.ts.security-review Слэш-команда devkit.ts.security-review прогоняет безопасность TypeScript/Node.js приложения: npm audit, Semgrep, Snyk, потом ручная проверка по OWASP Top 10 и отчёт с приоритетами. CX Codex +1 ★ 372звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой