Пишите описания коммитов сами: это инструмент мышления, который AI не заменит
Commit Description as a Thinking Tool
Автор с многолетним опытом писал подробные описания коммитов, чтобы объяснить не только что, но и почему были внесены изменения. В эпоху агентного кодинга AI генерирует и код, и описания, но, не зная реальных причин, выдумывает их. Автор предлагает писать сообщения коммитов самостоятельно: это помогает осмыслить изменения AI и проверить, понимаете ли вы, что именно выпускаете.
Если вы не можете объяснить это, значит, вы не поняли этого. Описание коммита снова работает здесь как инструмент мышления.
- WD-42
Написание текста — это мышление в любой ситуации, а не только в коммит-сообщениях. Это факт, который, как я боюсь, люди забывают, или, что ещё хуже, никогда изначально не понимали.
- dkarl
Меня заставили отказаться от коммит-сообщений задолго до появления AI, потому что другие люди были настолько плохи в них, что я с радостью согласился, что все PR должны сквошить коммиты.
По крайней мере, тогда сквошенные сообщения обычно были довольно приличными. Но потом люди начали использовать AI (или AI начал использовать людей) для создания абсолютно огромных коммит-сообщений, которые невозможно бегло просмотреть в git blame и в целом очень плохи для человеческого восприятия.
AI сделал огромные успехи практически во всех других отношениях. Почему они продолжают писать расточительным, враждебным к человеку способом?
Я думаю, нам пришлось бы быть очень наивными, чтобы не подозревать, что это намеренно. У AI-компаний есть заявленная цель заменить людей в процессе разработки программного обеспечения, и они активно делают сам процесс негостеприимным для людей.
Они впрыскивают огромные объёмы текста в процесс разработки своих клиентов, который затем превращается в токены, за обработку которых клиенты будут платить им снова и снова. Это как скруббер CO2, который выбрасывает CO2.
- kccqzy
Давным-давно я изменил коммит-сообщение по умолчанию, добавив заголовки «Почему?» и «Как?», чтобы напоминать себе, что нужно объяснить, почему вносится изменение (на чём сосредоточена эта статья), и как оно вносится (рассмотренные альтернативные подходы к реализации). Я следовал этому формату долгое время. Я входил в топ 1% по длине коммит-сообщений в компании.
Отступление: однажды я беспокоился, что что-то сломается, если коммит-сообщения станут слишком длинными. Я попробовал очень длинные коммит-сообщения, и ничего не сломалось: https://github.com/kccqzy/long-commit-messages/commit/ccfda4...
- evnp
> Когда AI не знает часть «почему», он придумывает своё собственное обоснование. Я нахожу это опасным. Когда мы читаем это позже, оно может не иметь смысла, потому что настоящая причина была совершенно другой.
Ещё опаснее: когда текст _имеет_ смысл, несмотря на оторванность от реальности.
- arialdomartini
Вдобавок к этому, окупается написание коммит-сообщений до кода
https://arialdomartini.github.io/pre-emptive-commit-comments