ax-narrate — скилл для Claude Code: история сессии и установка
Скилл собирает структурированный рассказ о работе в текущей сессии: фиксирует изменения, правки пользователя, неудачные попытки и сбои инструментов.
npx skills add Necmttn/ax --skill narrate -a claude-codeЧто делает ax-narrate
ax-narrate превращает контекст текущего разговора в JSON-файл для просмотра в ax studio. Рассказ состоит из остановок по ходу работы: каждая привязана к подтверждениям вроде фрагментов кода, шагов диалога или ошибок. Так в истории остаются и события, которые не попали бы в PR.
Скилл ищет идентификатор сессии через ax sessions here --days=1 --json, а при необходимости получает номера ходов командой ax sessions show <id> --json. Если ax недоступен, он формирует идентификатор из названия репозитория и времени; номера ходов тогда приблизительные. Для такой сессии это ограничение важно: привязки к диалогу могут быть менее точными.
Готовый артефакт сохраняется в .ax/narrations/<session-id>.json и должен пройти проверку схемы SessionNarration. У каждой остановки нужны подтверждения, а исправления пользователя и существенные сбои требуют отдельных привязок. Установить можно командой npx skills add Necmttn/ax --skill narrate -a claude-code; файл скилла находится по пути ~/.claude/skills/narrate/SKILL.md.
Какие задачи решает
- сохранить ход работы в виде рассказа для ax studio
- зафиксировать правки пользователя, неудачные попытки и восстановление после сбоев
- связать этапы сессии с фрагментами кода и ходами диалога
- создать JSON-артефакт сессии, который проверяется по схеме
Примеры запросов агенту
- Составь рассказ о том, что мы сделали в этой сессии.
- Собери историю работы, включая мои исправления и неудачные попытки.
- Оформи ход этой сессии для ax studio.
Как установить ax-narrate
1Через Skills CLI (Vercel)
npx skills add Necmttn/ax --skill narrate -a claude-code2Вручную: положить файлы
~/.claude/skills/narrate/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/narrate/
1Через Skills CLI (Vercel)
npx skills add Necmttn/ax --skill narrate -a codex2Вручную: положить файлы
.agents/skills/narrate/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Necmttn/ax --skill narrate -a cursor2Вручную: положить файлы
.cursor/skills/narrate/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Necmttn/ax narrate2Вручную: положить файлы
.github/skills/narrate/SKILL.md1Через Skills CLI (Vercel)
npx skills add Necmttn/ax --skill narrate -a gemini-cli2Командой платформы
gemini skills install https://github.com/Necmttn/ax --path skills/narrateВручную: положить файлы
.devin/skills/narrate/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Necmttn/ax --skill narrate -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о ax-narrate
Как установить ax-narrate в Claude Code?
Выполните npx skills add Necmttn/ax --skill narrate -a claude-code. Файл скилла будет доступен по пути ~/.claude/skills/narrate/SKILL.md.
Что делает ax-narrate?
Скилл записывает рассказ о текущей сессии в JSON для ax studio. Он включает изменения и важные события, которые не видны в итоговом PR.
Как ax-narrate связывает рассказ с ходом сессии?
Скилл получает идентификатор и номера ходов через команды ax sessions. Если ax недоступен, он создаёт идентификатор самостоятельно, а номера ходов становятся приблизительными.
