Утечка workflow в скиллах Claude Code
Есть много занятий, которыми можно заниматься постоянно и у меня к таким в последний год добавился регулярный анализ конфигурации всей моей AI-инфраструктуры, включая агентов. Тут, конечно, главное — вовремя остановиться в совершенствовании инструмента и перейти к его применению, но процесс все равно интересный.
Я регулярно нахожу самые разные советы, собираю целые фреймворки для работы, например, Claude Code, стараюсь анализировать, что нахожу, комбинировать со своими наработками.
Вот очень необычный и интересный совет, который я вытащил из фреймворка superpowers.
Автор фреймворка обнаружил явление, которое можно назвать утечкой workflow. В Claude Code широко распространены скиллы, описывающие порядок действий в определенных случаях, которые подгружаются в контекст агента в случае срабатывания триггеров. Триггеры ориентируются на описание (description) скилла, поэтому принято там описывать назначение. Так вот, оказывается, если описание содержит не только случаи, в которых должен сработать скилл, но и описание того, что скилл делает, то Claude Code (точнее, LLM) может проигнорировать всё остальное содержание, посчитав описание достаточной инструкцией для работы.
В случае у автора Claude, прочтя в описании “code review between tasks”, провел одно ревью вместо процедуры из нескольких этапов.
Простое исправление — перечислять в description собственно условия срабатывания скилла и не допускать описания непосредственно процесса.
Например, вместо “Comprehensive testing workflow with parallel unit/integration tests and gated E2E” написать “Use for ‘run tests’, ’test this’, ‘check test coverage’” или вместо “Bug investigation and resolution workflow. Routes to investigate, diagnose, implement” прописать “Use for ‘fix this bug’, ‘debug this’, ’this is broken’”.
Тестировать исправление очень просто — если скилл продолжает срабатывать в нужных случаях, значит, описание достаточное для этого. Если нет — добавьте еще триггеры. Но вы точно будете знать, что агент прочтет весь скилл, что повысит вероятность его следования полному набору инструкций.