harness — скилл для Claude Code и Codex: многосессионные агенты
Скилл harness для Claude Code, Codex, Cursor и других платформ, который ведёт долгосрочные агентные задачи через несколько сессий с чекпоинтами и откатом при сбоях.
AGPL-3.0 158 установок ★ 2 756 обновлён 2026-05-04
npx skills add stellarlinkco/myclaude --skill harness -a claude-codeЧто делает harness
Скилл берёт любую многошаговую задачу и превращает её в управляемый цикл: инициализирует проект через /harness init <project-path>, создаёт два файла состояния — harness-tasks.json со структурированным списком задач и harness-progress.txt как append-only журнал всех действий — и затем ведёт выполнение шаг за шагом.
Когда контекстное окно сбрасывается, агент восстанавливает состояние из этих двух файлов и истории git — без потери прогресса. Задача, найденная со статусом in_progress при старте сессии, сигнализирует о прерванной предыдущей: скилл обрабатывает её по протоколу восстановления. Блокировка через mkdir в /tmp исключает одновременную запись из нескольких агентных сессий. Провальная задача откатывается через git reset --hard к базовому коммиту, а цепочка зависимостей (depends_on) не даёт запустить следующую задачу, пока предыдущая не завершена.
Значение max_tasks_per_session по умолчанию равно 20, max_sessions — 50; эти цифры взяты из примеров в исходнике, а не из жёстко заданных ограничений. Маркерный файл .harness-active включает все хуки: без него они завершаются с кодом 0 немедленно, то есть скилл полностью неактивен до явного запуска.
Какие задачи решает
- продолжить агентную задачу после сброса контекстного окна
- откатить незавершённую подзадачу к последнему рабочему коммиту
- выстроить очередь из десятков подзадач с зависимостями между ними
- защитить
harness-tasks.jsonот одновременной записи двух агентских сессий - добавить новую задачу в работающую очередь без остановки цикла
Примеры запросов агенту
- Запусти
/harness init .и создай задачи для рефакторинга всех контроллеров - Возобнови очередь командой
/harness run— она прерывалась на задачеtask-004 - Добавь подзадачу:
/harness add "Написать миграцию для таблицы users"
Как установить harness
1Через Skills CLI (Vercel)
npx skills add stellarlinkco/myclaude --skill harness -a claude-code2Вручную: положить файлы
~/.claude/skills/harness/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/harness/
1Через Skills CLI (Vercel)
npx skills add stellarlinkco/myclaude --skill harness -a codex2Вручную: положить файлы
.agents/skills/harness/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add stellarlinkco/myclaude --skill harness -a cursor2Вручную: положить файлы
.cursor/skills/harness/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install stellarlinkco/myclaude skills/harness2Вручную: положить файлы
.github/skills/harness/SKILL.md1Через Skills CLI (Vercel)
npx skills add stellarlinkco/myclaude --skill harness -a gemini-cli2Командой платформы
gemini skills install https://github.com/stellarlinkco/myclaude --path skills/harnessВручную: положить файлы
.devin/skills/harness/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add stellarlinkco/myclaude --skill harness -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о harness
Как установить harness в Claude Code?
Выполните npx skills add stellarlinkco/myclaude --skill harness -a claude-code. После этого скилл появится по пути ~/.claude/skills/harness/SKILL.md.
Что делает скилл harness?
Он организует долгосрочную агентную работу: хранит список задач и журнал прогресса в двух файлах, восстанавливает состояние после сброса контекста и откатывает упавшую подзадачу через git reset --hard.
Что нужно, чтобы откат при сбое работал?
Проект должен быть под управлением git — скилл откатывается к коммиту из поля started_at_commit провальной задачи. Без git-истории команда git reset --hard не выполнится.