ship-error-handling — команда для Claude Code: ошибки /ship
Команда ship-error-handling помогает восстановить работу /ship после сбоев CI, конфликтов слияния, проблем деплоя и других ошибок публикации.
MIT ★ 2 003 обновлён 2026-07-26
/plugin marketplace add composio-community/awesome-claude-plugins
/plugin install ship@awesome-claude-pluginsЧто делает 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-plugins2Вручную: положить файлы
.claude/commands/ship-error-handling.mdВызов — /ship-error-handling. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/ship-error-handling.mdВызов — /prompts:ship-error-handling. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/ship-error-handling.prompt.mdВручную: положить файлы
.gemini/commands/ship-error-handling.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о 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