TGViewer
Журнал инженера-программиста Журнал инженера-программиста @software_engineer_notes · 247 subscribers
Post #301 140
(начало)

4) Создание документирующих комментариев (Generate doc comments for method)

Если эту команду вызвать в каком-то методе, то он от начала и до конца скопируется в новый чат с Напарником с системным промптом "Generate a docstring" (сгенерируй документацию?). В ответ возвращается комментарий, который можно установить методу (процедуре, функции).

Во всех протестированных случаях Напарник ленился и генерировал описание исключительно по названию метода лишь иногда упоминая параметры в формулировке "Сделай то-то на основании Параметр1 и Параметр2". Практически не отличается от стандартного описательного комментария, которую генерирует сам EDT. Преимущество Напарника в виде LLM, которая может проанализировать суть метода и написать что-то более "глубокое", никак не проявилось.

Описание параметров меня вообще расстроило, но было закономерным из-за неумения Напарника работать с контекстом. В моем примере, на вызов функции явно передавался массив; сама EDT в коде понимала, что тут массив и предлагала его методы; сама EDT при генерации комментария правильно указывала тип параметра - а вот Напарник сделал так:
PaymentData - <Type> - Payment data


Была надежда, что хоть может умеет делать комментирование выделенного блока кода - EDT так не имеет, так как "не понимает" суть кода в отличии от LLM. Но выделение проигнорировалось и был предложен комментарий на всю функцию.

Итого функционал получился настолько слабый, что настоятельно рекомендую продолжать использовать стандартное документирование от EDT.
  • 👍 5
  • ❤ 1
More from @software_engineer_notes
  1. Oct 3, 2026"Вы автоматизируете хаос" - этим страхом любят пугать своих бизнес-заказчиков консалтеры,…
  2. Sep 28, 2026Уже второй проект на работе делаю в методике "парного программирования" с Claude Code. И с…
  3. Sep 13, 2026За последний месяц произошло много событий, но наиболее интересным является использование…
  4. Sep 1, 2026Самая обычная бумажная книга учета - это пока лучший инструмент фиксации проектных изменен…
  5. Aug 31, 2026Очень показательная причина моей нелюбви реализации сравнения/объединения конфигураций в 1…
  6. Aug 29, 2026О концепции LLM-Wiki я впервые прочитал на X (Twitter). Чтобы позже ознакомится детальнее,…
Threads Profile ViewerView any public Threads profile without an account.Open ThreadLook →Writing with AI? Make it sound human.Metric37 rewrites AI drafts so they read naturally. Free AI detector, 1,500 words free.Try Metric37 →