На прошлой неделе я удалил функцию, которая была «задокументирована» комментарием, объясняющим поведение, которого функция не имела в трех версиях. Комментарий был уверенным. Функция пропала. Это настоящий дефект документов, созданных ИИ:...
На прошлой неделе я удалил функцию, которая была «задокументирована» комментарием, объясняющим поведение, которого функция не имела в трех версиях. Комментарий был уверенным. Функция пропала.
Это настоящий недостаток документов, созданных ИИ: они могут быть беглыми, правдоподобными и ошибочными. Не потому, что модель плохая, а потому, что ни один человек не проверил то, что утверждает текст. Исправление не в том, чтобы избежать ИИ. Речь идет о создании контрольно-пропускного пункта, где модель рисует черновики, а люди подписывают.
Разделение собственности
Модель может суммировать код, описывать параметры и превращать сообщения о фиксации в примечания к выпуску. Он не может знать, почему было принято такое решение, какие крайние случаи заканчивают карьеру или какие комментарии сейчас опасны.
Мое практическое правило:
Черновики модели: описания API, примеры использования, таблицы параметров, списки изменений из истории git.
Человек владеет: последствиями для безопасности, бизнес-правилами, архитектурными компромиссами, предупреждениями об устаревании и всем, что связано с обещаниями клиентов.
Приведенный ниже конвейер делает это разделение явным. Он генерирует черновик, а затем вызывает проверку проблемы с помощью контрольного списка, разделяющего две категории.
Трубопровод
Я запускаю это как рабочий процесс GitHub Actions для каждого объединенного PR, который касается src/.