principle-sequence-verifiable-units — скилл для Claude Code
Скилл учит агента разбивать миграции и массовые правки на мелкие шаги с проверкой каждого. Помогает собирать понятные цепочки коммитов для ревью.
npx skills add backnotprop/pstack --skill principle-sequence-verifiable-units -a claude-codeЧто делает principle-sequence-verifiable-units
Скилл задаёт строгий порядок для многошаговых задач: рефакторинга, миграций и серии однотипных правок. Каждая операция оформляется как шаг с проверяемым состоянием. Агент обязан сначала зафиксировать базовое состояние, сделать ровно одно изменение и запустить проверку. Переходить к следующей правке разрешено только после того, как текущий шаг завершился успехом.
Перед началом работы скилл требует сделать rebase на чистый trunk, иначе проверки будут опираться на неактуальный базовый код. При формировании коммитов и pull request задаётся проверяемая структура: сначала падающий тест, затем исправляющий код. Для структурных правок действует та же логика: сначала удаление лишнего, затем решейпинг, либо фиксация базового состояния перед основной доработкой.
Это руководство по дисциплине работы. Если агент склонен вносить двадцать правок за один вызов и запускать сборку только в самом конце, этот скилл остановит такой хаос. При этом в метаданных скилла прописан флаг disable-model-invocation: true, поэтому агент не станет вызывать его автоматически без явного контекста.
Какие задачи решает
- делить массовый рефакторинг на изолированные проверяемые шаги
- выстраивать коммиты в последовательность «падающий тест — исправление»
- фиксировать базовое состояние перед структурными правками в коде
- локализовать поломки сразу на вызвавшем их единичном шаге
Примеры запросов агенту
- Сделай миграцию по правилам principle-sequence-verifiable-units: проверяй каждый шаг перед переходом к следующему.
- Разбей рефакторинг модуля на цепочку коммитов, оформив сначала падающие тесты, затем правки.
Как установить principle-sequence-verifiable-units
1Через Skills CLI (Vercel)
npx skills add backnotprop/pstack --skill principle-sequence-verifiable-units -a claude-code2Вручную: положить файлы
~/.claude/skills/principle-sequence-verifiable-units/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/principle-sequence-verifiable-units/
1Через Skills CLI (Vercel)
npx skills add backnotprop/pstack --skill principle-sequence-verifiable-units -a codex2Вручную: положить файлы
.agents/skills/principle-sequence-verifiable-units/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add backnotprop/pstack --skill principle-sequence-verifiable-units -a cursor2Вручную: положить файлы
.cursor/skills/principle-sequence-verifiable-units/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install backnotprop/pstack principle-sequence-verifiable-units2Вручную: положить файлы
.github/skills/principle-sequence-verifiable-units/SKILL.md1Через Skills CLI (Vercel)
npx skills add backnotprop/pstack --skill principle-sequence-verifiable-units -a gemini-cli2Командой платформы
gemini skills install https://github.com/backnotprop/pstack --path skills/principle-sequence-verifiable-unitsВручную: положить файлы
.devin/skills/principle-sequence-verifiable-units/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add backnotprop/pstack --skill principle-sequence-verifiable-units -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Из того же набора44
Похожие
Рядом в теме «Git и GitHub»
Все скиллы по теме «Git и GitHub» →Вопросы о principle-sequence-verifiable-units
Как установить principle-sequence-verifiable-units в Claude Code?
Выполните команду npx skills add backnotprop/pstack --skill principle-sequence-verifiable-units -a claude-code. Конфигурация сохранится по пути ~/.claude/skills/principle-sequence-verifiable-units/SKILL.md.
Что делает скилл principle-sequence-verifiable-units?
Он инструктирует агента выполнять работу небольшими шагами с верификацией каждого шага до перехода к следующему. Также он задаёт правила упорядочивания коммитов и pull request, чтобы ревьюер мог легко перепроверить цепочку изменений.
С какими скиллами сочетается этот принцип?
Скилл дополняет принцип prove-it-works, обеспечивающий достоверность проверок, и build-the-lever, который снижает затраты на верификацию каждого отдельного шага.
Исходный текст
SKILL.md · MIT
--- name: principle-sequence-verifiable-units description: "Apply to multi-step work (sweeps, migrations, runs of similar edits) and to how you stack commits and PRs. Break work into small units that each end in a verifiable state, check each before the next, and order delivery so the sequence proves itself to a reviewer." disable-model-invocation: true --- # Sequence work into verifiable units Order work as a sequence of small units, each ending in a state you can check, and don't advance until the current one is green. **Why:** A break caught at the unit that caused it is cheap to localize. A break caught after a batch is buried, and you have already built further on a broken base. Sequencing those same units into a delivery a reviewer can replay turns "trust me" into "watch it go red, then green." **Execution.** In a sweep, migration, or any run of similar edits, verify each change before starting the next. Each unit is a before/after bracket: known-good state, one change, run the check, then proceed. Rebase onto clean trunk first so every check measures against the real baseline. When a lever does the edits, the per-unit check is nearly free. Run it anyway. **Delivery.** Stack commits and PRs in the order that proves the work. The canonical shape is the failing test first, then the fix on top. Other story orders are a subtraction before the reshape, a baseline capture before the treatment, the scaffold before the feature. Each commit lands on its own and the sequence reads as an argument. The sequencing complement to the **prove-it-works** principle skill, which keeps each check real, and the **build-the-lever** principle skill, which makes the per-unit check cheap.
© backnotprop · MIT · backnotprop/pstack