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

git-revert-safety — скилл для Claude Code: что делает и как установить

Скилл git-revert-safety помогает безопасно откатывать коммиты и мержи в Git без поломки версий в релизных манифестах и локфайлах.

MIT ★ 539 обновлён 2026-10-29

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

Что делает git-revert-safety

Скилл регламентирует процедуру отката изменений и очистки веток при случайных слияниях. Главная угроза операции git revert — случайный сброс версий пакетов назад, когда задеваются .release-please-manifest.json, package.json или CHANGELOG.md. Протокол разделяет действия на два сценария: штатный откат известных коммитов и восстановление ветки через перенос нужных правок на чистую основу.

Перед откатом агент проверяет список затронутых файлов, распознаёт мержи с несколькими родителями и выбирает стратегию. Если между коммитами успел пройти релиз, скилл запрещает прямой откат и направляет на cherry-pick. После операции запускаются проверки через node, gh release list и сверка с CI, чтобы не отправить сломанный тег.

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

  • предотвратить случайный откат версий в release-please манифесте
  • проверить зависимости и целостность локфайла после git revert
  • выбрать правильного родителя при откате мерж-коммита через ключ -m
  • очистить основную ветку от ошибочно влитого кода с помощью cherry-pick

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

  • Нужно откатить мерж-коммит abc1234, проверь родителей и релизные манифесты
  • Откати коммит def5678, но убедись, что package.json и lockfile не сломаются
  • В main попал лишний код, помоги очистить ветку по протоколу git-revert-safety

Как установить git-revert-safety

1Через Skills CLI (Vercel)

npx skills add ZaxbyHub/opencode-swarm --skill git-revert-safety -a claude-code

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

~/.claude/skills/git-revert-safety/SKILL.md

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

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

Вопросы о git-revert-safety

Как установить git-revert-safety в Claude Code?

Выполните команду npx skills add ZaxbyHub/opencode-swarm --skill git-revert-safety -a claude-code в терминале.

Что делает скилл git-revert-safety?

Он задаёт пошаговый процесс отката коммитов, проверяет сопутствующие файлы манифестов и помогает избежать поломок сборки и релизов.

Когда вместо revert выбирается cherry-pick?

Если между откатываемыми коммитами успел пройти автоматический релиз либо мерж был сделан через squash или octopus.

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

SKILL.md · MIT
---
name: git-revert-safety
description: >
  Apply when reverting commits, undoing merges, or recovering from branch contamination.
  Covers collateral damage verification (manifest, package.json, CHANGELOG, lockfiles),
  cherry-pick vs revert decision matrix, partial-revert detection, merge-parent handling,
  and post-revert CI verification. Prevents the most common revert failure mode: version
  metadata regression from git reverse-apply.
metadata:
  triggers: '["git revert","revert commit","revert merge","undo merge","reverse-apply","branch contamination","cherry-pick recovery","release-please duplicate tag"]'
  effort: small
  generated_from_knowledge: '[]'
  source_knowledge_ids: '["f07c1f4d-9bb0-4219-9804-26aa8efe8146"]'
  generated_at: "2026-06-14T16:50:00Z"
  confidence: "0.8"
  status: active
  version: "4"
  skill_origin: generated
  provenance_note: >
    Re-linked to current knowledge entries (version 4). The original source ID
    11f0e8cb... is no longer present in the active knowledge store. The skill
    body and behavior are unchanged; only source_knowledge_ids metadata was
    updated to point to the current lesson about verifying pre-existing state
    on parent commit, which is directly relevant to post-revert CI verification.
---

# Git Revert Safety Protocol

Two internal workflows: **Safe Git Revert** (Steps 1-4) and **Branch Contamination Recovery** (Steps 5-6).
Use the first when reverting known commits. Use the second when the wrong code was merged and you need a clean slate.

---

## Workflow A — Safe Git Revert

### Step 1 — Collateral Damage Assessment

Before reverting, list ALL files touched by each commit being reverted. Use the correct command for the situation:

**Single commit:**
```bash
git show --name-only --format= <sha>
```

**Multiple commits (contiguous range):**
```bash
git diff --name-only <commit-before-first>..<last-commit-sha>
```

**Merge commit — inspect all parents (handles octopus merges with 3+ parents):**
```bash
git show --format="%H %P" <merge-sha>   # Shows ALL parent SHAs
git log --oneline <merge-sha>^1         # First parent (usually main)
git log --oneline <merge-sha>^2         # Second parent (feature branch)
# For octopus merges: also inspect ^3, ^4, etc.
```

Identify which files in the diff are NOT part of the feature being reverted:
- `.release-please-manifest.json` — version state
- `package.json` — version field + dependency additions/removals
- `CHANGELOG.md` — release history
- Lockfiles (`bun.lock`, `package-lock.json`) — dependency graph
- Any config files modified by release PRs between the feature and now

`dist/` is generated and NOT committed, so it never appears in a revert diff and
needs no rebuild+commit as part of a revert — reverting the source is enough.

**Gate:** If ANY version metadata or dependency file appears in the diff, you MUST verify post-revert state (Step 3).

### Step 2 — Choose Recovery Strategy

| Scenario | Strategy | Caveat |
|----------|----------|--------|
| Single commit that does NOT touch release/build artifacts | `git revert <sha>` | Still verify metadata diff after |
| Single commit that DOES touch release artifacts | Verify post-revert metadata manually | May need corrective commit |
| Multi-commit revert, no releases between | `git revert <sha1> <sha2>...` | Verify each commit's file scope |
| Multi-commit revert, releases between | Cherry-pick fix onto fresh branch | Avoids collateral damage from reverse-apply |
| Merge commit revert | `git revert -m <parent-number> <merge-sha>` | Must specify correct parent (usually `-m 1` for main) |
| Branch contamination (wrong code merged) | Fresh branch + cherry-pick | See Workflow B |
| Revert of revert (re-apply feature) | `git revert <revert-sha>` | ⚠️ Code may have drifted — check for conflicts |
| Squash merge revert | Fresh branch + cherry-pick preferred | Squash merges have no merge-parent metadata |
| Octopus merge (3+ parents) | Fresh branch + cherry-pick unless parent is unambiguous | `-m` parent selection is error-prone; prefer clean slate |

**Rule:** If commits to revert span across release-please merge commits, ALWAYS prefer cherry-pick over revert.

### Step 3 — Post-Revert Verification

After reverting, verify these files match expected state:

1. **`.release-please-manifest.json`** — version must match the latest non-draft, non-prerelease GitHub release
   ```bash
   # List releases excluding drafts and prereleases
   gh release list --limit 5 --json tagName,isDraft,isPrerelease --jq '.[] | select(.isDraft==false and .isPrerelease==false) | .tagName'
   node -e "console.log(require('./.release-please-manifest.json')['.'])"
   ```

2. **`package.json` version field** — must match the manifest
   ```bash
   node -e "console.log(require('./package.json').version)"
   ```

3. **`CHANGELOG.md`** — must still contain entries for all released versions
   ```bash
   # Cross-platform: count version headings
   node -e "const c=require('fs').readFileSync('CHANGELOG.md','utf8'); console.log((c.match(/^## \[/gm)||[]).length)"
   # Compare against GitHub releases
   gh release list --limit 10
   ```

4. **Dependencies** — if `package.json` dependencies changed, verify lockfile is consistent
   ```bash
   bun install --frozen-lockfile   # Must succeed
   ```

5. **Bundle size** — if dependencies were added/removed, verify smoke test thresholds still pass. `dist/` is generated and NOT committed; run `bun run build` locally only when you need the bundle to verify.
   ```bash
   bun run build
   bun test tests/smoke --timeout 120000
   ```

**If any check fails:** Do NOT hand-edit release-please versions. Restore metadata from the known-good state of the latest release commit or re-run release-please. Apply a corrective commit restoring from the last known-good state before pushing.

### Step 4 — CI Verification

After pushing the revert:
1. Wait for CI to start
2. Check last-green-CI timestamp against the merge being reverted:
   ```bash
   gh run list --branch main --limit 10 --json databaseId,conclusion,createdAt --jq '.[] | select(.conclusion=="success")'
   ```
3. Do NOT dismiss any CI failure as "pre-existing" without timestamp evidence comparing the failure to the last known-green run
4. If release-please fails with "Duplicate release tag", the manifest was regressed — return to Step 3

---

## Workflow B — Branch Contamination Recovery

Use when the wrong code was merged to main and you need a clean recovery.

### Step 5 — Assess Contamination Scope

1. Identify the exact commits that should NOT be on the branch
2. Identify the commits that SHOULD be there (fix commits, other features merged after)
3. Check if release-please ran between the bad merge and now — if so, manifest/CHANGELOG/package.json version were all modified

### Step 6 — Clean-Slate Recovery

1. **Create a fresh branch from origin/main:**
   ```bash
   git fetch origin main
   git checkout -b fix/<name> origin/main
   ```

2. **Cherry-pick ONLY the fix/feature commits** that should be on the branch:
   ```bash
   git cherry-pick <fix-sha>
   ```

3. **Verify the cherry-picked branch** has exactly the files you expect:
   ```bash
   git diff --name-only origin/main..HEAD
   ```

4. **Run full QA gates** before pushing (lint, build, tests, smoke tests). `dist/` is generated and NOT committed — do not stage it; run `bun run build` locally only when you need the bundle to verify.

**Do NOT attempt incremental cleanup** (removing bad files one by one from a contaminated branch) when release metadata, generated bundles, or dependency graphs are involved. Clean-slate cherry-pick guarantees no contamination leaks.

---

## Conflict Resolution Gate

After resolving any revert or cherry-pick conflicts:
1. Run `git diff` to review ALL resolved files — not just the conflicted ones
2. For CHANGELOG/manifest conflicts — restore from known-good state, do NOT merge both versions
3. Verify build succeeds before committing: `bun run build` (`dist/` is generated and NOT committed — do not stage it)

---

## Forbidden Shortcuts

- NEVER assume version metadata survived a multi-commit revert unchanged — always verify
- NEVER dismiss CI failures as pre-existing without comparing timestamps against last-green-CI
- NEVER attempt incremental cleanup of contaminated branches when release metadata or dependency graphs are involved
- NEVER hand-invent release-please version numbers — restore from known-good state or re-run release-please
- NEVER trust stale local SHAs after force-pushes — refetch and compare against remote before recovery

## Delegation Template

```
SKILLS: file:.opencode/skills/generated/git-revert-safety/SKILL.md
```

© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm

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

Все скиллы по теме «Git и GitHub» →
skillshare-release runkids Скилл skillshare-release помогает готовить и проверять релизы skillshare: сверяет PR от Release Please, обновляет документацию и инспектирует черновики. CX Codex +1 ★ 3 269звёзд репо git-safety tamagui Скилл git-safety запрещает агенту выполнять деструктивные git-операции без явного разрешения: force push, git reset --hard, git clean -fd. CX Codex +1 ★ 14 319звёзд репо git-safety-net daymade Скилл git-safety-net для Claude Code находит и сохраняет локальные коммиты, незакоммиченные файлы и ветки перед очисткой репозитория. Защищает от потери кода при слияниях и удалении воркдеревьев. CX Codex +1 362установок git-hygiene-enforcer patricio0312rev Скилл git-hygiene-enforcer для Claude Code задаёт правила коммитов и веток, готовит шаблон PR и описывает процесс ревью. Он приводит Git-процесс проекта к общим правилам. CX Codex +1 271установок release-please bmad-labs По настройке релизного конвейера через Conventional Commits. Генерирует конфиги release-please, манифесты версий и воркфлоу GitHub Actions для публикации пакетов. CX Codex +1 128установок git-workflow oakoss Скилл git-workflow помогает агенту выстраивать trunk-based разработку, оформлять conventional commits, настраивать пайплайны GitHub Actions и чистить историю Git. CX Codex +1 149установок

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

Весь набор →
rust-crate-ci Скилл rust-crate-ci для правки Rust-крейта runners/swarm-sandbox-runner: задаёт порядок локальных проверок и разбирает ошибки Windows, которые видит только CI. CX Codex +1 ★ 539звёзд репо clarify Скилл clarify разбирает неясные требования через четырёхэтапную воронку с проверкой критиком и готовит пакет решений без лишних вопросов. CX Codex +1 ★ 539звёзд репо editing-skills Скилл editing-skills помогает менять SKILL.md в opencode-swarm, не нарушая правила зеркалирования, публикации и проверки расхождений. Загрузите его перед редактированием скиллов в этом репозитории. CX Codex +1 ★ 539звёзд репо pr-reviewer Субагент pr-reviewer для ревью пул-реквестов в плагине opencode-swarm: восстанавливает замысел PR, сверяет его с кодом и ищет дефекты. Работает только на чтение. CX Codex +1 ★ 539звёзд репо qa-sweep qa-sweep организует параллельную работу субагентов и независимую проверку изменений. Скилл пригодится при реализации функций, исправлении ошибок и разборе сбоев. CX Codex +1 ★ 539звёзд репо swarm-pr-subscribe Скилл swarm-pr-subscribe держит открытый пул-реквест под присмотром: разбирает приходящие события CI и ревью и сам решает, что чинить, о чём спросить, а что пропустить. CX Codex +1 ★ 539звёзд репо brainstorm Скилл brainstorm для Claude Code проводит пошаговый брейншторм: изучает кодовую базу, задаёт точечные вопросы и оформляет спецификацию для задачи без готовых требований. CX Codex +1 ★ 539звёзд репо bundle-safety Скилл bundle-safety помогает проверять минификацию бандла, сохранность имён идентификаторов и учёт реэкспортов. Пригодится перед изменениями сборки, которые могут переименовать или удалить код. CX Codex +1 ★ 539звёзд репо

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

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