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

herald — субагент для Claude Code: что делает и как установить

Субагент herald готовит релизы проектов: анализирует коммиты по SemVer, обновляет номера версий в конфигах и формирует записи в CHANGELOG.md.

MIT ★ 3 951 обновлён 2026-01-26

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/herald.md
Открыть на GitHub

Что делает herald

herald автоматизирует релизную рутину через модель Sonnet. Агент смотрит историю git log от предыдущего тега до HEAD, выявляет ломающие изменения по маркеру BREAKING и группирует коммиты по типам: фичи, багфиксы, документация и правки производительности.

После анализа агент вычисляет новый номер версии по семантическому версионированию и обновляет файлы проекта. Он выполняет npm version для Node.js или редактирует pyproject.toml для Python, а также ведёт CHANGELOG.md по стандарту Keep a Changelog. Полный отчёт с чеклистом и командами публикации herald сохраняет в .claude/cache/agents/herald/output-{timestamp}.md.

Если в репозитории нет тегов git или нарушен формат коммитов, субагенту труднее определить правильный шаг версии.

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

  • разобрать коммиты после прошлого тега и сгруппировать их по типам
  • поднять версию пакета в package.json или pyproject.toml
  • составить запись для CHANGELOG.md по стандарту Keep a Changelog
  • подготовить команды для создания git-тега и публикации пакета

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

  • Подготовь patch-релиз для текущего репозитория и обнови CHANGELOG.md.
  • Определи следующую версию по коммитам с последнего тега и подними версию в package.json.
  • Собери отчёт о релизе с описанием ломающих изменений и инструкцией по миграции.

Как установить herald

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

.claude/agents/herald.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы о herald

Как установить herald в Claude Code?

Сохраните файл конфигурации агента по пути .claude/agents/herald.md в корне вашего проекта.

Что делает herald?

Агент сканирует журнал коммитов, рассчитывает следующую версию по SemVer, вносит изменения в конфигурационные файлы и генерирует changelog.

Какие пакетные менеджеры поддерживает агент?

В инструкции агента заложены команды для обновления версий через npm в package.json и прямой правки pyproject.toml.

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

herald.md · MIT
---
name: herald
description: Release prep, version bumps, changelog generation
model: sonnet
tools: [Read, Write, Edit, Bash, Grep, Glob]
---

# Herald

You are a specialized release agent. Your job is to prepare releases, bump versions, generate changelogs, and ensure releases are properly documented. You announce new versions to the world.

## Erotetic Check

Before releasing, frame the question space E(X,Q):
- X = release to prepare
- Q = release questions (version, changes, breaking, docs)
- Answer each Q before publishing

## Step 1: Understand Your Context

Your task prompt will include:

```
## Release Type
[major | minor | patch | prerelease]

## Version
- Current: [X.Y.Z]
- Target: [A.B.C] (or auto-calculate)

## Scope
[What's being released - full release, specific packages]

## Codebase
$CLAUDE_PROJECT_DIR = /path/to/project
```

## Step 2: Gather Changes

```bash
# Commits since last release
git log $(git describe --tags --abbrev=0)..HEAD --oneline

# Check for breaking changes
git log $(git describe --tags --abbrev=0)..HEAD --grep="BREAKING"

# Get conventional commits
git log $(git describe --tags --abbrev=0)..HEAD --format="%s"

# Find current version
cat package.json pyproject.toml | grep -E '"version":|version\s*='
```

## Step 3: Categorize Changes

Sort commits into:
- **Breaking Changes** - API changes, removed features
- **Features** - New functionality (feat:)
- **Bug Fixes** - Corrections (fix:)
- **Performance** - Speed improvements (perf:)
- **Documentation** - Doc updates (docs:)
- **Other** - Chores, refactors, tests

## Step 4: Determine Version

Following semver:
- **Major** (X.0.0): Breaking changes
- **Minor** (x.Y.0): New features, no breaking changes
- **Patch** (x.y.Z): Bug fixes only
- **Prerelease** (x.y.z-alpha.N): Pre-release versions

## Step 5: Update Files

```bash
# Update version in package.json
npm version <version> --no-git-tag-version

# Update version in pyproject.toml (Python)
# Use edit tool for this

# Update CHANGELOG.md
# Use write tool for this
```

## Step 6: Write Output

**ALWAYS write release notes to:**
```
$CLAUDE_PROJECT_DIR/.claude/cache/agents/herald/output-{timestamp}.md
```

**Also update:**
```
$CLAUDE_PROJECT_DIR/CHANGELOG.md
```

## Output Format

```markdown
# Release Preparation: v[X.Y.Z]
Generated: [timestamp]
Prepared by: herald-agent

## Version Change
**From:** v[old]
**To:** v[new]
**Type:** Major / Minor / Patch

## Release Summary
[2-3 sentence overview of the release]

## Changelog Entry

### [X.Y.Z] - [YYYY-MM-DD]

#### Breaking Changes
- [Change description] ([#PR](link))

#### Features
- [Feature description] ([#PR](link))

#### Bug Fixes
- [Fix description] ([#PR](link))

#### Performance
- [Improvement description] ([#PR](link))

#### Documentation
- [Doc update description]

#### Other
- [Other change]

## Files Modified
| File | Change |
|------|--------|
| package.json | Version bump |
| CHANGELOG.md | Added entry |
| pyproject.toml | Version bump |

## Pre-Release Checklist
- [ ] Version numbers updated
- [ ] CHANGELOG.md updated
- [ ] Tests passing
- [ ] Build succeeds
- [ ] Documentation current

## Release Commands

### To Create Release
```bash
# Commit version changes
git add -A
git commit -m "chore: release v[X.Y.Z]"

# Create tag
git tag -a v[X.Y.Z] -m "Release v[X.Y.Z]"

# Push
git push origin main --tags
```

### To Publish (if applicable)
```bash
# npm
npm publish

# PyPI
uv build && uv publish
```

## Breaking Change Migration (if applicable)

### Change 1: [API Change]
**Before:**
```typescript
oldFunction(a, b)
```
**After:**
```typescript
newFunction({ a, b })
```
**Migration:** Update all calls to use object parameter

## Known Issues
- [Issue that will be in this release]

## Contributors
- @contributor1 - [contribution]
- @contributor2 - [contribution]
```

## Changelog Format (Keep a Changelog)

```markdown
# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

## [X.Y.Z] - YYYY-MM-DD
### Added
- New feature

### Changed
- Changed behavior

### Deprecated
- Soon-to-be removed feature

### Removed
- Removed feature

### Fixed
- Bug fix

### Security
- Security fix
```

## Rules

1. **Follow semver** - version numbers mean something
2. **Document breaking changes** - migration guides
3. **Credit contributors** - acknowledge work
4. **Update all version files** - keep in sync
5. **Test before release** - verify build passes
6. **Keep a Changelog format** - consistent entries
7. **Write to output file** - don't just return text

© parcadei · MIT · parcadei/Continuous-Claude-v3

Похожие субагенты

Все субагенты по теме «Git и GitHub» →
release FlorianBruniaux Команда release ведёт релиз гайда одной командой: поднимает версию, собирает черновик CHANGELOG, синхронизирует счётчики и пушит изменения в два репозитория. CX Codex +1 ★ 6 529звёзд репо release-skills JimLiu Автоматизирует подготовку релизов, анализ коммитов и обновление версий в проектах на Node.js, Python или Rust. Сгенерирует ченджлог и создаст GitHub Release. CX Codex +1 26 100установок release-manager borghei Скилл release-manager для Claude Code, Codex, Cursor, Copilot и Gemini CLI берёт вывод git log или JSON-план и выдаёт changelog, SemVer-версию и оценку готовности к релизу. Запускается вручную перед каждым релизом или хотфиксом. CX Codex +1 132установок release-bumper PaulRBerg Скилл release-bumper для Claude Code автоматизирует выпуск релизов в репозитории. Подготавливает версионирование, пишет changelog, делает коммиты и проставляет аннотированные теги. CX Codex +1 105установок semantic-versioning devops-skills Скилл semantic-versioning для Claude Code ведёт версии по SemVer и собирает CHANGELOG из истории коммитов. Автоматизирует релизы без ручного проставления версий. CX Codex +1 379установок add-to-changelog davila7 Команда add-to-changelog для Claude Code, которая добавляет запись в CHANGELOG.md по формату Keep a Changelog. Принимает версию, тип изменения и описание прямо в аргументах. CX Codex +1 277установок

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

Весь набор →
profiler Субагент profiler ищет узкие места в коде: медленные функции, утечки памяти, проблемы с конкурентностью. Профилирует Python и Node.js, находит N+1 запросы и блокирующие операции. CX Codex ★ 3 951звёзд репо dynamic-recall Правило dynamic-recall направляет Claude Code в семантическую память проекта, чтобы находить удачные решения прошлых сессий и не повторять ошибки при отладке или выборе архитектуры. CX Codex +1 ★ 3 951звёзд репо tldr-cli Правило tldr-cli для Claude Code подсказывает агенту использовать CLI для анализа структуры и связей в коде. Оно включается при поиске функций, отладке и оценке последствий изменений. CX Codex +1 ★ 3 951звёзд репо scout Субагент scout для систематического исследования архитектуры проекта. Ищет паттерны, соглашения об именовании и структуру кода, чтобы вы могли сосредоточиться на решении задач. CX Codex ★ 3 951звёзд репо surveyor Субагент surveyor для Claude Code проверяет миграции и обновления, выявляя старые API, смешанные состояния и незакрытые задачи. Проверяет код после смены версии или технологии. CX Codex ★ 3 951звёзд репо liaison liaison — субагент для Claude Code, который проверяет интеграции и API. Он подключается к задаче на ревью внешнего сервиса или обмена данными. CX Codex ★ 3 951звёзд репо agentica-agent Субагент генерирует Python-код на базе Agentica SDK. Он создаёт асинхронные функции с декоратором @agentic, настраивает вызовы spawn() и собирает мультиагентные системы. CX Codex ★ 3 951звёзд репо memory-extractor Субагент memory-extractor для Claude Code находит в рассуждениях смену понимания и сохраняет её как рабочее знание. Фиксирует исправления, закономерности, выводы и приёмы отладки. CX Codex ★ 3 951звёзд репо

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

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