ИИ-агент
по поиску работы

Как подготовить GitHub для поиска работы

Как оформить профиль и закреплённые проекты GitHub, показать личный вклад и проверить запуск. Новый репозиторий-пример, README и сценарий проверки.

На этой странице

GitHub помогает оценить твою работу, когда проверяющий понимает, что открыть, как запустить и где заканчиваются твои полномочия. Пустой профиль с десятками форков этого не объясняет. Большой репозиторий без инструкции тоже может остаться непрочитанным: работодателю придётся угадывать версию среды, происхождение данных и ожидаемый результат.

Начни с одной вакансии и одного самостоятельного проекта, который отвечает её задачам. Если в роли важны обработка данных и тестирование, покажи проверяемую обработку и ошибки входа. Если требуется веб-интерфейс, консольный скрипт подтвердит только часть требований. Не переименовывай учебный CLI в промышленную платформу, чтобы он казался ближе к объявлению.

Ниже разобран новый проект сравнения двух каталогов: полный код, тесты, данные и журнал исполнения доступны в приложении. Это самостоятельный учебный пример, созданный для статьи; реального магазина, заказчика и коммерческих показателей нет.

Раздели профиль и репозиторий

Профиль отвечает на вопрос «какие задачи ты умеешь решать». README отдельного проекта отвечает на другой: «что именно здесь сделано и как это проверить». В официальном руководстве GitHub по усилению резюме профилем рассматриваются оформление профиля, README и выбор работ. Используй эти возможности для навигации, а не для повторения всей биографии.

В описании профиля достаточно назвать направление, доступный для обсуждения уровень задач и несколько релевантных работ. Например: «Разрабатываю небольшие инструменты на JavaScript. В проектах показываю проверку входа, обработку ошибок и автоматические тесты. Ищу начальную роль в команде, где смогу развивать эти навыки». Такая формулировка не утверждает, что ты уже самостоятельно поддерживал высоконагруженный сервис.

Закрепляй работы осмысленно. Три законченных проекта под выбранную роль полезнее набора одинаковых копий курса. У каждого объясни собственный вклад: придумал условие, написал реализацию, добавил тесты, проверил ограничение. Если часть получена из учебного задания, назови её отдельно. Форк сам по себе не становится авторским проектом; ценность может быть в твоём исправлении, но тогда покажи конкретный diff и мотив.

Не оценивай квалификацию числом зелёных клеток или коммитов. Активность не раскрывает сложность решения, качество проверки и способность работать с чужими требованиями. Перерыв в публичном GitHub также не доказывает отсутствие работы: часть проектов может быть закрытой.

Выбери задачу, которую можно проверить без доступа к работодателю

Наш CLI получает два полных снимка каталога и сообщает, какие товары добавились, исчезли или изменились. Сопоставление идёт по SKU. Это узкая, но законченная задача: есть договор входа, явные ошибки, детерминированный результат и способ повторить проверку.

До и после по четыре записи. В первом снимке есть P01, P02, P03, P04; во втором - P01, P02, P04, P05. Ожидаемый результат: добавлен P05, удалён P03, цена P02 изменилась с 95000 до 99000 копеек, наличие P04 - с false на true. Названия не менялись. Количества, выручка и остатки не вычисляются, потому что их нет во входных данных.

Здесь важно слово «полных». Если второй файл на самом деле только выгрузка изменённых позиций, отсутствие P03 нельзя трактовать как удаление. В README прямо закреплён договор двух полных снимков с одинаковой системой SKU. Такой предел полезнее заявления «работает с любыми каталогами».

Вход - простой TSV без экранирования. В заголовке ровно четыре поля: sku, name, price_kopecks, available. Разделитель - табуляция; табуляция или перенос внутри значения не поддерживаются. Допустимы LF и CRLF, а также BOM перед заголовком. Каталог без записей, но с корректным заголовком разрешён. Это не универсальный CSV-парсер.

SKU содержит от 1 до 30 символов A-Z, цифры, подчёркивание или дефис и уникален внутри снимка. Название непустое после trim; длина исходного значения без обрезки - не более 100 единиц JavaScript length. Пробелы по краям сохраняются и учитываются при сравнении. Это ограничение реализации, не обещание 100 видимых символов любого письма. Цена - неотрицательное безопасное целое число копеек; наличие - строго 0 или 1. Повторы, неправильная строка и пустая строка внутри файла приводят к ошибке, а не к частичному «успешному» отчёту.

Что положить в репозиторий

В папке проекта находятся compare.cjs, compare.test.cjs, before.tsv, after.tsv, expected-report.json, README.md и execution-log.txt. Код работает без установки зависимостей. Функция parseTsv проверяет вход, compare сравнивает уже проверенные записи, а CLI связывает чтение файлов и вывод JSON. Вызов compare с произвольными непроверенными объектами не входит в договор.

В README сначала помести назначение и команды, затем формат входа, результат, ошибки и ограничения. Не заставляй читать весь исходник для выяснения того, какой файл запускать. Отдельно укажи минимальную поддерживаемую среду и фактическую проверенную версию. Для этого проекта нужен Node.js 18.1 или новее; реальный прогон выполнен на Node.js 26.8.2. Это не утверждение о выполнении тестов на каждой промежуточной версии.

node --test compare.test.cjs
node compare.cjs before.tsv after.tsv

Сначала выполни тесты. Затем CLI при успехе напечатает JSON в stdout с кодом 0. При ошибке сообщение идёт в stderr, код выхода 1. Скрипт не изменяет входные файлы. Сам пользователь может испортить вход перенаправлением вывода поверх TSV, поэтому README отдельно запрещает такое перенаправление.

Документация Node.js описывает встроенный test runner. Его наличие позволяет этому небольшому примеру обойтись без стороннего тестового пакета; само использование test runner ещё не доказывает полноту покрытия. Список проверяемых случаев и их связь с договором нужно объяснить в проекте.

Покажи проверку результата, а не только зелёную строку

В приложении 11 тестов. Они проверяют ожидаемые изменения, порядок результата, отсутствие мутации входа и ошибки формата. Отдельно сохранён отрицательный контроль: в изолированной временной копии отключено обнаружение изменения цены. Набор завершился ненулевым кодом. Рабочая реализация после эксперимента не менялась.

Такой контроль отвечает на узкий вопрос: способен ли данный набор заметить конкретную внесённую ошибку? Он не означает, что все возможные дефекты найдены. Не называй 11 тестов доказательством промышленной надёжности. Назови, что осталось за рамками: экранированный TSV, несколько валют, сопоставление изменённых SKU, конкурентная обработка и большие файлы.

Для проверяющего полезен короткий маршрут: открыть README, выполнить тесты, запустить CLI на двух образцах, сверить JSON, посмотреть один тест ошибочного входа. Если он может пройти этот путь без регистрации в стороннем сервисе, доказательство становится доступнее. Рекомендации ВШЭ по портфолио помогают связать работу с задачей и собственным вкладом; для кода эту связь дополняет исполняемый результат.

Проверь публичность, ссылки и секреты

Открой репозиторий без своей авторизации: действительно ли видны README и нужные файлы? Приватная ссылка не станет доступной только от того, что вставлена в резюме. Если работа должна остаться закрытой, согласуй иной способ передачи; не меняй права на код работодателя ради отклика.

Проверь пути после распаковки и после публикации. MDN объясняет различие относительных и абсолютных ссылок: ссылка, работающая из твоей локальной папки, может вести в другое место после переноса. Для данного проекта все команды рассчитаны на запуск из его собственной папки.

Перед публичным размещением проверь не только текущий файл, но и историю, если она существует. Токены, пароли, ключи, выгрузки клиентов и внутренние адреса не становятся безопасными после переименования. OWASP рассматривает управление секретами как отдельный процесс; простой поиск по нескольким словам не равен полному аудиту безопасности. Если действующий секрет уже раскрыт, удаление строки не отменяет необходимость его отзыва и замены по правилам владельца.

Не прикрепляй лицензию на чужой код от своего имени. Для собственного проекта осознанно выбери условия использования, а для сторонних компонентов сохрани их лицензии и авторство. В нашем примере сторонние библиотеки и данные работодателя не использованы.

Как связать проект с откликом

В сопроводительном контексте достаточно конкретного указателя: «В проекте сравнения каталогов проверяю договор TSV и ошибки входа; пример запуска и 11 тестов находятся в README». Затем объясни связь с вакансией: обработка выгрузок, аккуратность данных, тестирование. Не пиши «опыт внедрения e-commerce», если проект никто не внедрял.

Если в вакансии обязательны TypeScript, база данных и HTTP API, этот CLI не закрывает их автоматически. Отметь подтверждённую часть и пробелы. Можно развить проект под новую задачу, но сначала получи новое законченное доказательство: схему, реализацию и проверку. Переименование файлов не создаёт недостающего навыка.

Скачать полный проект с тестами и данными. Для проверки перед откликом доступны копируемая карта и заполненный CSV. Они помогают проверить передачу работы, а решение о приглашении остаётся за работодателем.