using-agent-skills

Скилл using-agent-skills от Addy Osmani — это мета-инструкция для выбора и вызова других Agent Skills. Его задача начинается не с написания кода, а с распознавания фазы инженерной работы. Для нового запроса предлагается определить, нужно ли сначала уточнить идею, превратить её в спецификацию, разложить на задачи или сразу перейти к реализации. Для реализации предусмотрены отдельные направления: общий incremental implementation, разработка интерфейсов, проектирование API, context engineering, работа по официальным источникам и более осторожный режим для незнакомых или рискованных задач. Если запрос связан с проверкой, skill направляет к test-driven development или browser testing with DevTools; при поломке — к debugging and error recovery; при ревью — к code review and quality, а при лишней сложности, безопасности или производительности — к соответствующим специализированным проверкам. Ценность этого подхода в том, что он превращает каталог навыков в последовательность решений. В самом начале скилл требует назвать допущения о требованиях, архитектуре и границах задачи. Если в требованиях и существующей системе обнаружено противоречие, инструкция предлагает остановиться, сформулировать конкретную путаницу и показать компромисс, а не молча выбрать удобную трактовку. При спорном техническом решении допускается аргументированно возразить: нужно указать практический недостаток, по возможности измерить его и предложить более подходящий вариант. Это полезно для задач, где «сделать как попросили» может привести к лишней сложности или неверному результату. Отдельный блок посвящён простоте и границам изменений. Перед реализацией следует проверить, нельзя ли решить задачу меньшим числом строк, без новой абстракции или без дополнительной зависимости. Скилл рекомендует не трогать несвязанные комментарии, не делать побочную уборку, не удалять код только потому, что он кажется неиспользуемым, и не добавлять функции «на будущее». Такое правило особенно применимо к большим репозиториям: оно помогает оставить дифф локальным и сохраняет понятную связь между запросом и изменёнными файлами. Workflow не ограничивается выбором названия навыка. В описанном lifecycle после определения задачи идут уточнение идеи, спецификация, планирование, подбор контекста, проверка источников, инкрементальная реализация и тестирование. Затем перечислены review качества, упрощение, вопросы безопасности и производительности, а для полного жизненного цикла — CI, миграции, документация, наблюдаемость и запуск. Скилл прямо рассматривает эти шаги как процессы, которым нужно следовать, а не как необязательные советы. Для каждой применённой специализации нужна своя проверка: итог нельзя считать готовым только потому, что код выглядит правдоподобно. Практический сценарий — начало рабочей сессии, когда по короткому запросу ещё непонятно, нужен ли план, код, отладка или ревью. Другой сценарий — работа над новой функцией: сначала выбирается спецификация и план, затем реализация малыми частями, тесты и проверка качества. При browser-задачах добавляется специализированное тестирование, при незнакомом API — проверка по документированному источнику, а при CI или релизе — workflow, который относится к доставке. Ограничение скилла очевидно: он маршрутизирует работу и задаёт критерии поведения, но не заменяет содержание выбранного специализированного навыка, проверку конкретного репозитория или фактический запуск тестов. Эти проверки всё равно нужно выполнить на реальном проекте и зафиксировать их результат.