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

ship-change — скилл для Claude Code: процесс изменений и установка

Скилл ship-change для Claude Code ведёт изменение от issue до слитого PR. Он включается перед исправлением, новой функцией, правкой документации или рефакторингом.

MIT ★ 80 обновлён 2026-11-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add mralexivy/AutoMode --skill ship-change -a claude-code
Открыть на GitHub

Что делает ship-change

ship-change задаёт порядок работы над изменением: отдельные issue, ветка и PR для каждой задачи. Ветка хранит код, тесты, бенчмарк и результаты; напрямую писать в main нельзя. Скилл также описывает проверки через npm run check, claude plugin validate . --strict и claude plugin test ..

Для изменений поведения скилл требует бенчмарк на той же ветке: сначала фиксируют правило прохода и ожидаемые расходы, затем запускают эксперимент и добавляют отчёт. Перед запуском, который расходует лимит или деньги, нужно спросить пользователя.

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

  • провести изменение от issue до PR
  • собрать код, тесты и бенчмарк в одной ветке
  • проверить изменения перед созданием PR
  • подготовить бенчмарк и приложить его результаты
  • запустить выпуск после слияния изменений в поставляемых путях

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

  • Проведи исправление от issue до PR по правилам ship-change.
  • Подготовь ветку и бенчмарк для изменения поведения.
  • Создай PR для правки документации и выполни нужные проверки.

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

1Через Skills CLI (Vercel)

npx skills add mralexivy/AutoMode --skill ship-change -a claude-code

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

~/.claude/skills/ship-change/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/ship-change/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о ship-change

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

Выполни npx skills add mralexivy/AutoMode --skill ship-change -a claude-code.

Что делает ship-change?

Скилл задаёт процесс изменения репозитория: от issue и отдельной ветки до проверок, PR и слияния. Для изменения поведения он также описывает запуск бенчмарка.

Какие инструменты нужны для работы ship-change?

Процесс использует git, gh, npm, claude и node. Перед запуском бенчмарка, который расходует лимит или деньги, требуется разрешение пользователя.

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

SKILL.md · MIT
---
name: ship-change
description: The required workflow for any change to this repository, from issue to merged PR. Use it before you start a fix, feature, docs change or refactor here, and when asked to create an issue, a branch, a PR or a release. It keeps the release flow correct.
---

# Ship a change

Every task gets one issue, one branch and one PR. The branch holds the whole task: code, tests, benchmark and results. A task merges only when its evidence is on its branch. Nothing writes to `main` directly. CI enforces the branch and PR rules, so a shortcut fails in the `guard` job.

## 1. Sync

```bash
git status --short                # stop if tracked files are changed, and ask
git switch main
git pull --ff-only
```

## 2. Issue

Search first, so you do not open a duplicate:

```bash
gh issue list --state all --search "<words>"
```

If none fits, create one. Use the fields of the matching template in `.github/ISSUE_TEMPLATE/`: `bug_report`, `feature_request`, `benchmark_task` or `judge_case`.

```bash
gh issue create --title "<short title>" --label <bug|enhancement> --body-file <file>
```

## 3. Branch

Make one branch per task, not one per step. A task is one entity, even when its plan has phases, milestones or numbered parts. Those parts are commits on the task's branch and sections of its one PR. Never open a branch, issue or PR per phase, and never split a task so that its code lands first and its tests or benchmark follow.

When you plan a task, write the plan as one branch and one PR with ordered commits. Do not write it as "PR 1, PR 2, ...".

Use `<type>/<short-name>`. The type is `feature`, `fix`, `docs`, `chore`, `refactor`, `test` or `bench`. Keep the name to two or three words, in lowercase, with hyphens.

```bash
gh issue develop <N> --name feature/release-flow --base main --checkout
```

Always pass `--name`. Without it, the branch takes the whole issue title, and `guard` rejects it. This command also links the branch to the issue.

## 4. Work

- Keep to one task, and keep all of it here. Commit each phase of the plan on this branch as it is done.
- Add or update a test for each behavior change.
- Put the benchmark for the task on this branch, with the code it measures.
- If you change a shipped path, add a line under `[Unreleased]` in `CHANGELOG.md`. Shipped paths are `agents/`, `commands/`, `hooks/`, `output-styles/`, `scripts/`, `types/`, `workflows/`, `config.json` and `.claude-plugin/plugin.json`.
- Put the line under the right heading, because the heading sets the next version. `Fixed` and `Security` give a patch. `Added`, `Changed`, `Removed` and `Deprecated` give a minor.
- Never change `version` in `plugin.json`. The release PR does it.
- Never commit on `main`.

## 5. Check

```bash
npm run check
claude plugin validate . --strict
claude plugin test .
```

Fix every failure before you go on.

## 6. Benchmark

A change to what a session does needs a benchmark on its branch. That covers routing, model calls, tool gates, agents, the workflow and the guardian. A docs change does not need one, and neither does a fix that a test proves. Say so in the PR when you skip it.

1. Fix the pass rule before any result exists. Add the experiment to `bench/experiments/`, add its arm to `bench/arms.mts` if it needs one, write the veto rules in `bench/experiments/CANARIES.md`, and commit them.
2. State the expected spend. Ask the user before a run that spends usage or money. CI never runs a live benchmark, so this run happens here.
3. Run it on the branch's final code. A run id hashes the plugin code, so a later code change starts new runs.
4. Commit the rows and the report to the branch.
5. If the run changes a number you publish, follow the `publish-results` skill on the same branch. It updates the README, the docs, the comparison and the website together, and `tests/claims.test.mts` blocks the merge until they agree.

```bash
node bench/run.mts --experiment <id> --dry-run
node bench/run.mts --experiment <id> --out bench/results/<id>.jsonl
node bench/grade.mts bench/results/<id>.jsonl --budget-usd <n>
node bench/report.mts --manifest bench/results/<id>.manifest.json bench/results/<id>.jsonl
```

- A vetoed result blocks the merge. Fix the code and run again, or close the task.
- Never change a pass rule after results exist.
- A default of `off` or `shadow` does not replace this step.
- Under 30 tasks, a run is a pilot. It can veto a change, and it cannot prove a saving. See `bench/README.md`.

## 7. Pull request

```bash
git push -u origin HEAD
gh pr create --base main --title "<what changed>" --body-file <file>
gh pr checks --watch
```

- Fill in the template in `.github/PULL_REQUEST_TEMPLATE.md`.
- The body must contain `Closes #<N>`.
- Link the benchmark report, or say why the task needs none.
- Write the title as a plain sentence. A squash merge makes it the commit subject on `main`.
- Fix any failing check before you report the PR as ready.

If a change truly needs no changelog line, add the `no-changelog` label.

## 8. Merge

Merge only when the checks and the benchmark pass and the user asks:

```bash
gh pr merge <PR> --squash
```

Then go back to step 1 for the next change.

Before you merge a release PR, run the `publish-results` skill if any public number or promise changed since the last release.

## What happens next

- A merge that changes a shipped path makes the bot open or update the `Release x.y.z` PR from branch `release/next`.
- Merging that PR ships. It runs the gate on Linux and macOS, builds and attests the bundle, publishes the GitHub Release, and moves `stable` last.
- Users install from `stable`, so `main` can hold unreleased work.
- Docs-only merges start no release. Their changelog lines wait for the next one.
- To choose the version: `gh workflow run release.yml -f bump=major`.
- To test the release path and publish nothing: `gh workflow run release.yml -f dry_run=true`.

## Do not

- Push to `main`, or merge with `--admin`.
- Merge a task while its benchmark is pending.
- Edit `release/next` by hand. The bot force-pushes it.
- Create tags, or move `stable`, by hand.
- Name a commit `Release x.y.z`. That subject starts a release.

© mralexivy · MIT · mralexivy/AutoMode

Похожие скиллы

Все скиллы по теме «Git и GitHub» →
workflow-ship-change MengTo Скилл workflow-ship-change задаёт регламент релиза изменений: делает скриншоты, прогоняет тесты, обновляет список изменений и деплоит код в main с проверкой лимитов. CX Codex +1 658установок flag-and-release-change launchdarkly Скилл flag-and-release-change для Claude Code ведёт изменение в PR от решения о флаге до автоматического релиза. Работает с флагом LaunchDarkly и веткой PR. CX Codex +1 267установок ship-error-handling Community Команда ship-error-handling помогает восстановить работу /ship после сбоев CI, конфликтов слияния, проблем деплоя и других ошибок публикации. CX Codex +1 ★ 2 003звёзд репо 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установок gsd-ship open-gsd Скилл gsd-ship для Claude Code, который отправляет завершённую работу в PR после успешной проверки. Пушит ветку, запускает review и отслеживает слияние. CX Codex +1 582установок

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

Весь набор →
explorer Субагент explorer для Claude Code собирает технические факты о проекте для планировщика. Он находит зависимости, команды сборки и тесты до начала планирования задач. CX Codex ★ 80звёзд репо implementer Субагент implementer для Claude Code выполняет одну часть утверждённого плана. Он меняет назначенные ему файлы, добавляет тесты и запускает проверки. CX Codex ★ 80звёзд репо builder Субагент builder для Claude Code берёт задачу из готового брифа, правит рабочий каталог и гоняет проверки до успешного прогона. Подключается для доводки кода или чистого перезапуска после неудачной попытки. CX Codex ★ 80звёзд репо verifier verifier — субагент для Claude Code, который проверяет изменения тестами, проверкой типов и сборкой. Он также ищет регрессии в diff и исправляет ошибки, внесённые текущими изменениями. CX Codex ★ 80звёзд репо reviewer Субагент reviewer для Claude Code проводит независимый аудит изменений в коде. Инструмент сравнивает реализованный функционал с задачей и критериями приёмки, выявляя архитектурные огрехи. CX Codex ★ 80звёзд репо architect Субагент architect для Claude Code превращает результаты discovery в архитектурный план. Он распределяет работу по файлам и задаёт критерии приёмки. CX Codex ★ 80звёзд репо growth Скилл growth для Claude Code ведёт еженедельную работу по продвижению AutoMode. По запросу о постах, каталогах или метриках он собирает данные и готовит изменения для одного PR. CX Codex +1 ★ 80звёзд репо publish-results Скилл publish-results для Claude Code синхронизирует результаты бенчмарков по всем страницам проекта. Запускается перед слиянием релизного PR или после изменения публичных цифр. CX Codex +1 ★ 80звёзд репо

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

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