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

ship-error-handling — команда для Claude Code: ошибки /ship

Команда ship-error-handling помогает восстановить работу /ship после сбоев CI, конфликтов слияния, проблем деплоя и других ошибок публикации.

MIT ★ 2 003 обновлён 2026-07-26

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add composio-community/awesome-claude-plugins
/plugin install ship@awesome-claude-plugins
Открыть на GitHub

Что делает ship-error-handling

Команда описывает, что делать, если gh не найден, CI не проходит, не удаётся отправить изменения или создать PR. Для ошибок CI она предлагает повторить отправку и запустить /ship снова; также описывает передачу сбоя субагенту next-task:ci-fixer.

Для конфликтов есть шаги с git fetch, слиянием основной ветки и повторным запуском публикации. При проблемах деплоя команда подсказывает, где смотреть логи railway, vercel или netlify; для неудачной проверки production описан откат. При принудительной отправке используется --force-with-lease, который не перезаписывает неожиданные изменения на удалённой ветке.

Справочник также охватывает незакрытые комментарии ревью и очистку worktree. Для отладки можно включить SHIP_DEBUG=1. Перед запуском проверьте, что установлен GitHub CLI и выполнена авторизация через gh auth login: без этого часть процедур с GitHub не сработает.

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

  • возобновить публикацию после исправления CI
  • разобраться с конфликтом слияния перед повторным запуском /ship
  • проверить логи после сбоя деплоя
  • откатить production после неудачной проверки
  • удалить worktree после ошибки очистки

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

  • Разбери сбой CI для PR и подскажи, как продолжить через /ship.
  • Помоги разрешить конфликт с основной веткой и возобновить /ship.
  • Проверь порядок действий при сбое деплоя и включи подробный журнал для /ship.

Как установить ship-error-handling

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

/plugin marketplace add composio-community/awesome-claude-plugins
/plugin install ship@awesome-claude-plugins

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

.claude/commands/ship-error-handling.md

Вызов — /ship-error-handling. Для всех проектов — ~/.claude/commands/

Вопросы о ship-error-handling

Как установить ship-error-handling в Claude Code?

Выполните /plugin marketplace add composio-community/awesome-claude-plugins, затем /plugin install ship@awesome-claude-plugins. Файл команды находится по пути .claude/commands/ship-error-handling.md.

Что делает ship-error-handling?

Подсказывает, как восстановить работу /ship после сбоев CI, проблем с PR, конфликтов, ошибок деплоя и отката. Включает команды для диагностики и повторного запуска.

Нужен ли GitHub CLI для ship-error-handling?

Для процедур с GitHub нужен gh и авторизация через gh auth login. При сбое CI справочник также предлагает передать задачу субагенту next-task:ci-fixer.

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

ship-error-handling.md · MIT
# Error Handling & Recovery - Reference

This file contains error handling procedures for `/ship`.

**Parent document**: `ship.md`

## GitHub CLI Not Available

```markdown
ERROR: GitHub CLI (gh) not found

Install: https://cli.github.com

Or use package manager:
  macOS: brew install gh
  Windows: winget install GitHub.cli
  Linux: See https://github.com/cli/cli/blob/trunk/docs/install_linux.md

Then authenticate:
  gh auth login
```

## CI Failure

```markdown
[ERROR] CI checks failed for PR #${PR_NUMBER}

View details:
  ${CI_URL}

Fix the failing tests/checks and push again.
The /ship command will resume from Phase 4 (CI monitoring).

To retry:
  git push
  /ship
```

### CI Fix with ci-fixer Agent

When CI fails, use the ci-fixer agent:

```javascript
Task({
  subagent_type: "next-task:ci-fixer",
  prompt: `Fix CI failure for PR #${PR_NUMBER}

CI Output:
${CI_OUTPUT}

Failed checks:
${FAILED_CHECKS}

Requirements:
1. Analyze the failure reason
2. Make minimal fix to pass CI
3. Do not introduce unrelated changes
4. Ensure all tests pass after fix`
});
```

## Merge Conflicts

```markdown
[ERROR] Cannot merge PR #${PR_NUMBER}: conflicts with ${MAIN_BRANCH}

Resolve conflicts:
  git fetch origin
  git merge origin/${MAIN_BRANCH}
  # Resolve conflicts in your editor
  git add .
  git commit
  git push

Then retry:
  /ship
```

## Deployment Failure

```markdown
[ERROR] Deployment failed

${WORKFLOW === 'dev-prod' ? 'Development' : 'Production'} deployment did not succeed.

Check deployment logs:
  ${DEPLOYMENT === 'railway' ? 'railway logs' : ''}
  ${DEPLOYMENT === 'vercel' ? 'vercel logs' : ''}
  ${DEPLOYMENT === 'netlify' ? 'netlify logs' : ''}

Once fixed, deployment will retry automatically.
```

## Production Validation Failure with Rollback

```markdown
[ERROR] Production validation failed

ROLLBACK INITIATED

Production has been rolled back to previous version.
Previous deployment: ${PREVIOUS_SHA}

Issues detected:
  ${VALIDATION_ISSUES}

Fix the issues and try shipping again:
  /ship
```

## Push Failure

```markdown
[ERROR] Push to remote failed

Possible causes:
1. Authentication issue: gh auth status
2. Remote branch protected: check branch protection rules
3. Out of date: git pull --rebase origin ${CURRENT_BRANCH}

Resolve and retry:
  /ship
```

## PR Creation Failure

```markdown
[ERROR] Failed to create PR

Possible causes:
1. Already exists: gh pr list --head ${CURRENT_BRANCH}
2. No commits: git log ${MAIN_BRANCH}..HEAD
3. Same branch: ensure not on ${MAIN_BRANCH}

Check existing PRs:
  gh pr list --state all --head ${CURRENT_BRANCH}
```

## Max Review Iterations Reached

```markdown
[ERROR] Max iterations (${MAX_ITERATIONS}) reached

Unable to resolve all review comments automatically.
Manual intervention required.

Remaining unresolved threads: ${UNRESOLVED_COUNT}

View PR: ${PR_URL}

Options:
1. Manually address remaining comments
2. Request reviewer to close non-blocking items
3. Continue with /ship after resolving
```

## Worktree Cleanup Failure

```markdown
[WARN] Failed to clean up worktree

Worktree at: ${WORKTREE_PATH}

Manual cleanup:
  git worktree remove ${WORKTREE_PATH} --force
  git worktree prune
```

## Force Push Safety

When rollback requires force push:

```bash
# ALWAYS use --force-with-lease instead of --force
# This prevents overwriting unexpected remote changes

if ! git push --force-with-lease origin $PROD_BRANCH; then
  echo "[ERROR] Force push failed - remote has unexpected changes"
  echo "Someone else may have pushed to production"
  echo "Manual investigation required"
  exit 1
fi
```

## Recovery Procedures

### Resume After CI Fix

```bash
# After fixing CI locally
git add .
git commit -m "fix: address CI failures"
git push

# Resume shipping
/ship
```

### Resume After Conflict Resolution

```bash
# After resolving merge conflicts
git add .
git commit
git push

# Resume shipping
/ship
```

### Resume After Manual Review Resolution

```bash
# After manually addressing review comments
git add .
git commit -m "fix: address review feedback"
git push

# Resume shipping
/ship
```

### Cancel and Cleanup

```bash
# If you need to abandon the PR
gh pr close $PR_NUMBER --delete-branch

# Clean up local
git checkout $MAIN_BRANCH
git branch -D $CURRENT_BRANCH
```

## Exit Codes

| Code | Meaning |
|------|---------|
| 0 | Success - PR merged |
| 1 | General failure |
| 2 | CI failure (retryable) |
| 3 | Review timeout (manual intervention) |
| 4 | Deployment failure |
| 5 | Rollback triggered |

## Logging for Debugging

Enable verbose logging:

```bash
export SHIP_DEBUG=1
/ship
```

This will output detailed information about each phase for troubleshooting.

© Community · MIT · composio-community/awesome-claude-plugins

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

Все слэш-команды по теме «DevOps и инфраструктура» →
ship raphaelsalaja Скилл ship для Claude Code проводит готовые изменения от коммита до проверки в продакшене. Запускается по просьбе отправить, слить или выпустить изменение. CX Codex +1 167установок verify-and-ship cyrusagents Скилл verify-and-ship проводит изменения через проверку критериев задачи, тесты, обновление changelog, коммит и создание pull request. CX Codex +1 888установок ship-it jssblck Скилл ship-it доводит завершённую правку до готового пул-реквеста: коммитит, пушит, открывает PR и следит за CI до зелёного. CX Codex +1 1 700установок coco-ship coco-research Скилл coco-ship помогает оформить ветку, обойти корпоративный git-guard при необходимости, создать пулл-реквест и дождаться CI. Защищает от прямой отправки коммитов в main. CX Codex +1 ★ 328звёзд репо deploy-steward SethGammon Скилл deploy-steward для Claude Code по очереди вливает готовые PR в main, проверяет CI, запускает деплой и создаёт задачи на починку при сбоях. CX Codex +1 ★ 937звёзд репо workflow-ship-change MengTo Скилл workflow-ship-change задаёт регламент релиза изменений: делает скриншоты, прогоняет тесты, обновляет список изменений и деплоит код в main с проверкой лимитов. CX Codex +1 658установок

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

Весь набор →
reflecting-on-sessions Скилл reflecting-on-sessions разбирает телеметрию skill-bus в конце сессии или ветки и находит пропущенные подписки скиллов. CX Codex +1 ★ 2 003звёзд репо remove-sub Команда remove-sub управляет подписками на события с учётом области действия: удаляет, отключает и снова включает триггеры. CX Codex +1 ★ 2 003звёзд репо audit-project-github Команда audit-project-github для Claude Code превращает отложенные находки /audit-project в GitHub-issues через gh, оставляя security-находки внутри. Нужны git и авторизованный gh. CX Codex +1 ★ 2 003звёзд репо edit-insert edit-insert — команда Claude Code, которая изменяет текст инсерта skill-bus или условия его срабатывания. Новые условия применяются к связанным подпискам, кроме подписок с флагом inheritConditions: false. CX Codex +1 ★ 2 003звёзд репо backend-architect Субагент backend-architect для проектирования API, серверной логики, баз данных и масштабируемых бэкенд-систем. CX Codex ★ 2 003звёзд репо frontend-developer Субагент frontend-developer помогает проектировать компоненты на React, Vue или Angular, исправлять вёрстку и оптимизировать рендеринг веб-приложений. CX Codex ★ 2 003звёзд репо add-sub Команда add-sub добавляет подписку на событие скилла: контекст подставляется до или после его запуска, с условиями по файлам, git-ветке и переменным окружения. CX Codex +1 ★ 2 003звёзд репо ship-deployment Команда ship-deployment доводит /ship до конца: ждёт деплой на Railway, Vercel или Netlify, гоняет смоук-тесты и откатывает прод, если проверки провалились. CX Codex +1 ★ 2 003звёзд репо

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

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