audit-agent-history — скилл для Claude Code: функции и установка
Скилл находит в локальных логах сессий частые ошибки ИИ-ассистента и переводит их в правила проекта. Пригодится, когда агент раз за разом наступает на одни и те же грабли.
npx skills add timschoch/skilly --skill audit-agent-history -a claude-codeЧто делает audit-agent-history
Скилл извлекает записи диалогов из каталогов ~/.claude/projects/ и ~/.codex/sessions/. Он ищет фразы, где человек отменяет или исправляет действия модели — например, слова «нет», «верни» или «я не просил». Каждое исправление относится к отдельной категории сбоя, после чего инструмент считает частоту промахов на каждые 100 сообщений пользователя.
Вся тяжёлая выборка идёт внутри изолированного субагента. Логи не засоряют основное окно контекста. Скилл отдельно опрашивает модель на примере самого неудачного диалога и анализирует сессию с максимальным числом вызовов инструментов, выявляя лишние чтения и проверки.
Итоговый отчёт предлагает до трёх правил в формате Never с конкретной причиной и примерами из логов. Без сохранённых JSONL-файлов в стандартных директориях скрипту не с чем работать. При одобрении правок он обновляет правила только в центральном репозитории, не трогая локальные копии проектов.
Какие задачи решает
- разобрать историю сессий и выявить повторяющиеся сбои ассистента
- превратить частые ошибки в список запрещающих правил проекта
- найти бесполезные вызовы инструментов в самых длинных диалогах
- перенести удачные локальные инструкции в общий репозиторий
Примеры запросов агенту
- Проведи аудит логов Claude Code за последние 30 дней и покажи главные ошибки
- Разбери историю сессий Codex и составь правила защиты от частых сбоев
- Выдели в логах диалоги с наибольшим числом правок и проверь вызовы инструментов
Как установить audit-agent-history
1Через Skills CLI (Vercel)
npx skills add timschoch/skilly --skill audit-agent-history -a claude-code2Вручную: положить файлы
~/.claude/skills/audit-agent-history/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/audit-agent-history/
1Через Skills CLI (Vercel)
npx skills add timschoch/skilly --skill audit-agent-history -a codex2Вручную: положить файлы
.agents/skills/audit-agent-history/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add timschoch/skilly --skill audit-agent-history -a cursor2Вручную: положить файлы
.cursor/skills/audit-agent-history/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install timschoch/skilly audit-agent-history2Вручную: положить файлы
.github/skills/audit-agent-history/SKILL.md1Через Skills CLI (Vercel)
npx skills add timschoch/skilly --skill audit-agent-history -a gemini-cli2Командой платформы
gemini skills install https://github.com/timschoch/skilly --path bundles/workflow/skills/audit-agent-historyВручную: положить файлы
.devin/skills/audit-agent-history/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add timschoch/skilly --skill audit-agent-history -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о audit-agent-history
Как установить audit-agent-history в Claude Code?
Выполните команду npx skills add timschoch/skilly --skill audit-agent-history -a claude-code. Также можно вручную поместить файл навыка по пути ~/.claude/skills/audit-agent-history/SKILL.md.
Зачем нужен скилл audit-agent-history?
Он помогает писать правила на основе реальной статистики правок пользователя, а не догадок. Инструмент подсчитывает сбои на сотню сообщений и находит корни проблем в поведении моделей.
Почему аудит выполняется через отдельного субагента?
Разбор сотен строк сырых логов быстро переполнил бы контекст основной сессии. Субагент проводит вычисления изолированно и возвращает в основной чат только готовый структурированный отчёт.
