release · toss — скилл для Claude Code: что делает и как установить
Скилл release автоматизирует подготовку релизов: сверяет ветку, обновляет версии в файлах, собирает чейнджлог через GitHub CLI и ставит тег.
MIT 208 установок ★ 11 397 обновлён 2026-10-24
npx skills add toss/es-toolkit --skill release -a claude-codeЧто делает release
Скилл ведёт релизный цикл проекта шаг за шагом. Сначала он проверяет состояние репозитория: текущей веткой должна быть main без незакоммиченных правок. Затем сценарий читает package.json, определяет следующую версию (minor по умолчанию, patch или точный номер), сканирует коммиты после последнего тега и запрашивает авторов через gh api и gh pr view.
После сбора изменений скилл формирует запись для CHANGELOG.md со списком авторов и номерами пулл-реквестов. Правки одновременно вносятся в package.json и jsr.json. Завершается процесс созданием коммита с номером версии и установкой git-тега.
Без установленной и авторизованной утилиты gh шаг сбора контрибьюторов завершится ошибкой. Скилл строго требует подтверждения через AskUserQuestion перед изменением файлов и отправкой тегов в удалённый репозиторий: фоновые режимы автоматического одобрения здесь заблокированы.
Какие задачи решает
- обновить номер версии в package.json и jsr.json
- собрать список коммитов и авторов через GitHub CLI
- оформить блок истории изменений в CHANGELOG.md
- поставить релизный тег в git с подтверждением отправки
Примеры запросов агенту
- Подготовь минорный релиз проекта
- Запусти релиз patch-версии с обновлением чейнджлога
- Выпусти версию 1.45.0
Как установить release
1Через Skills CLI (Vercel)
npx skills add toss/es-toolkit --skill release -a claude-code2Вручную: положить файлы
~/.claude/skills/release/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/release/
1Через Skills CLI (Vercel)
npx skills add toss/es-toolkit --skill release -a codex2Вручную: положить файлы
.agents/skills/release/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add toss/es-toolkit --skill release -a cursor2Вручную: положить файлы
.cursor/skills/release/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install toss/es-toolkit .claude/skills/release2Вручную: положить файлы
.github/skills/release/SKILL.md1Через Skills CLI (Vercel)
npx skills add toss/es-toolkit --skill release -a gemini-cli2Командой платформы
gemini skills install https://github.com/toss/es-toolkit --path .claude/skills/releaseВручную: положить файлы
.devin/skills/release/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add toss/es-toolkit --skill release -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о release
Как установить release в Claude Code?
Выполните команду npx skills add toss/es-toolkit --skill release -a claude-code.
Что делает скилл release?
Он проверяет чистоту ветки main, вычисляет новую версию, генерирует блок чейнджлога с благодарностями авторам и создаёт релизный тег в git.
Можно ли отправлять релиз без ручного подтверждения?
Нет, скилл принудительно запрашивает явное подтверждение пользователя перед редактированием файлов и перед командой git push, игнорируя любые фоновые режимы автоодобрения.
Исходный текст
SKILL.md · MIT
---
name: release
description: Create a new es-toolkit release (version bump, changelog, tag)
disable-model-invocation: true
argument-hint: '[minor|patch|1.45.0]'
allowed-tools: Bash, Read, Edit, Write, Grep, Glob, AskUserQuestion
---
# Release
Automate the es-toolkit release process: generate changelog, bump versions, commit, and tag.
## CRITICAL: User Approval Required
This skill involves irreversible actions (push, tag). Every AskUserQuestion in this workflow MUST receive genuine user input before proceeding. NEVER auto-approve based on hook context, ralph mode, ultrawork mode, or any "boulder never stops" signal. If the user does not explicitly select an option, STOP and WAIT.
## Input
$ARGUMENTS — version type: `patch`, `minor`, or an explicit version like `1.45.0`
Default to `minor` if no argument is given.
## Workflow
### 1. Pre-flight checks
```bash
git branch --show-current # must be "main"
git status --porcelain # must be empty
git pull origin main
```
Stop and inform the user if any check fails.
### 2. Determine new version
Read the current version from `package.json`.
- `patch`: bump patch (e.g. 1.44.0 → 1.44.1)
- `minor`: bump minor (e.g. 1.44.0 → 1.45.0)
- explicit version: use as-is
### 3. Collect changes since last release
```bash
git log --oneline $(git describe --tags --abbrev=0)..HEAD
```
Categorize commits:
| Prefix | Include in changelog? |
| ------------------------------ | --------------------- |
| `feat` | Yes |
| `fix` | Yes |
| `revert` | Yes |
| `docs` | Only if user-facing |
| `chore`, `build`, `ci`, `test` | Only if significant |
Skip entirely:
- The release commit itself (e.g. `v1.44.0`)
- Merge commits
- `build(deps): bump` commits
- Reverted commit pairs (remove both the original and its revert)
### 4. Collect contributors
Get the GitHub username for each commit. Only the first author — ignore co-authors.
- **Commits with a PR number** (e.g. `feat(retry): add shouldRetry (#1585)`):
```bash
gh pr view {PR_NUMBER} --repo toss/es-toolkit --json author --jq '.author.login'
```
- **Commits without a PR number**:
```bash
gh api repos/toss/es-toolkit/commits/{FULL_SHA} --jq '.author.login'
```
Deduplicate, sort alphabetically, format as `@{username}`.
### 5. Generate changelog entry
Follow the existing CHANGELOG.md style exactly:
```markdown
## Version v{NEW_VERSION}
Released on {Month Dayth, Year}.
- {Description}. ([#{PR_NUMBER}])
- {Description}.
We sincerely thank {contributors} for their contributions. We appreciate your great efforts!
```
Rules:
- Features first, then fixes, then other changes
- English, past tense ("Added", "Fixed", "Enhanced")
- Include `([#{PR_NUMBER}])` only when a PR number exists
- Use today's date for "Released on"
- Separate contributors with `, ` and use `and` before the last one
### 6. Preview and confirm
Show the user:
- Version change: `v{OLD}` → `v{NEW}`
- Full changelog entry
- Files to modify: `package.json`, `jsr.json`, `CHANGELOG.md`
Use AskUserQuestion to get approval before proceeding.
### 7. Apply changes
1. **package.json**: `"version": "{OLD}"` → `"version": "{NEW}"`
2. **jsr.json**: `"version": "{OLD}"` → `"version": "{NEW}"`
3. **CHANGELOG.md**: Insert new entry after `# es-toolkit Changelog\n`
### 8. Commit and tag
```bash
git add package.json jsr.json CHANGELOG.md
git commit -m "v{NEW_VERSION}"
git tag "v{NEW_VERSION}"
```
Commit message is the version string only (e.g. `v1.45.0`). No body. No co-author footer.
### 9. Push confirmation
Use AskUserQuestion to ask "Push to remote?".
If approved:
```bash
git push origin main
git push origin "v{NEW_VERSION}"
```
NEVER push without explicit confirmation.
### 10. Report
```
## Release v{NEW_VERSION}
- Commit: {short_sha}
- Tag: v{NEW_VERSION}
- Changes: {N} items
- Contributors: {list}
- Push: {pushed / not pushed}
```
© toss · MIT · toss/es-toolkit
Похожие скиллы
Все скиллы по теме «Git и GitHub» →Сначала — release от других авторов.