Пошаговое руководство: прочитайте лицензии, добавьте заголовок, запустите тесты, проверьте
Изучите код и найдите файлы лицензий
Вы начинаете с list_dir, чтобы увидеть структуру папок, и glob, чтобы найти LICENSE, COPYING и файлы зависимостей, затем grep ищет в исходных файлах строки SPDX. Бесплатное открытое программное обеспечение обычно указывает свою лицензию в этих 3 местах, поэтому поиск покажет, что объявляет каждый файл и какие файлы ничего не объявляют. Сохранители открытого обучающего приложения часто перечисляют следующие желаемые функции в своих задачах, поэтому прочитайте их тоже, прежде чем выбирать задачу. Читайте, не редактируйте. Каждый результат — это карточка, которую можно развернуть, и в конце этого шага у вас есть список файлов и лицензий для проверки, который вы тщательно просматриваете, прежде чем перейти к следующему шагу. Сохраните свои заметки в текстовом файле, чтобы вернуться к ним позже.
Прочитайте лицензию и правила внесения вклада
Теперь read_file открывает файл LICENSE и файл CONTRIBUTING. Лицензия говорит вам, что вы можете делать с кодом, а правила внесения вклада говорят вам, как проект хочет получать изменения, поэтому прочитайте оба полностью. Ваш первый вклад в открытое исходное код проще принять, когда он точно следует этим правилам, поэтому запишите их. Некоторые участники спрашивают, следует ли делиться историей сессий ИИ-кодинга в открытой разработке; политика проекта об изменениях с ИИ отвечает на это, и она может попросить вас указать, что инструмент помог. Запустите собственные тесты проекта один раз перед тем, как что-либо изменить, чтобы знать начальный результат. Затем просмотрите свои заметки и запишите правила, применимые к вашему изменению. Прочитайте также кодекс поведения, если он есть у проекта, потому что он говорит о том, какое поведение ожидается.
Добавьте заголовок, который требует проект
Некоторые проекты требуют короткий заголовок лицензии, например строку SPDX, в начале каждого нового файла. Только когда CONTRIBUTING или LICENSE так говорят, вы используете edit_file, чтобы добавить именно этот заголовок к вашим 3 новым файлам, и в Ask first агент показывает diff перед тем, как что-либо будет записано. Сохраните каждое существующее уведомление об авторских правах и никогда не меняйте лицензию. Просмотрите diff построчно. Затем используйте grep, чтобы перечислить файлы, которым всё ещё не хватает заголовка, и запустите тестовую команду проекта, потому что код выхода говорит о том, завершилась ли команда без ошибки. Если тест не прошел, прочитайте вывод, прежде чем что-либо еще изменить, и спросите у проекта, если правило заголовка неясно. Используйте одну и ту же строку заголовка в каждом файле.
Проверьте результат перед отправкой
Наконец, grep показывает, каким файлам не хватает заголовка, Shell снова запускает тесты и сообщает код выхода, и вы еще раз читаете весь diff. Это 3 результата для сравнения. Команда сканера уязвимостей исходного кода, которую вы предоставите, также может быть запущена через Shell; агент показывает его вывод, и вы решаете, что это значит, но ни сканирование, ни агент не гарантируют, что ничего другого нет. Напишите описание pull request, упомяните проверенную лицензию и запущенные тесты, и отправьте его самостоятельно. Следуйте правилам проекта. Рецензенты могут запросить изменения, и вы отвечаете на них так же: небольшой шаг, diff, тест. Ждите их ответа, прежде чем вносить больше изменений. Поблагодарите рецензента, когда он поможет, и держите каждый ответ кратким и вежливым, одно исправление за раз.