Tutorial 1 Orientation ru

Урок 1 · Ориентация

Цель: запустить проект, познакомиться со своим ИИ-агентом и один раз пройти тестовый барьер — чтобы всё дальнейшее было на автомате.

← Назад к Главная · Далее: Урок 2 Как работает код

---

1. Зачем шуточное приложение?

Учиться работать с агентом по коду проще всего, когда код маленький, настоящий и с низкими ставками. LockedIn CLI — всё три сразу:

• Маленький: один файл ядра, одна точка входа, один набор тестов, ноль зависимостей.
• Настоящий: устанавливается как глобальная команда lockedin и ведёт себя как подлинный ИИ-CLI.
• С низкими ставками: это сатира. Если ваш агент сделает humblebrag-и на 20% скромнее, никого не поднимут по тревоге.

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

2. Получите код

git clone https://github.com/xjamesmorris/lockedin-cli.git
cd lockedin-cli

Проверьте свою версию Node (нужна 18+):

node --version

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

3. Запустите

Попробуйте настоящую вещь:

node bin/lockedin.js            # заставка + баннер
node bin/lockedin.js post       # сгенерированный пост «идейного лидерства»
node bin/lockedin.js aura       # просканировать вашу профессиональную ауру
node bin/lockedin.js            # (без аргументов) бросает вас в сессию чата

Напечатайте /help внутри сессии, поковыряйтесь, затем /exit. Всё, что вы видите, генерируется локально из пулов слов — без сети, без аккаунтов. Полный список команд: Справочник команд.

4. Пройдите тестовый барьер

Это самая важная команда во всём учебнике:

npm test

Вы должны увидеть стену зелёных галочек, заканчивающуюся чем-то вроде pass 318. Этот набор — ваша страховочная сетка. С этого момента рабочий процесс всегда:

измените что-то → npm test → выкатывайте только если зелёно.

5. Познакомьтесь со своим агентом

Откройте своего агента по коду в папке проекта, чтобы он видел файлы. С GitHub Copilot CLI это:

copilot

Затем, чтобы сориентироваться, попросите агента сориентировать вас (пока ничего не меняя). Попробуйте промпт вроде:

«Дай мне двухабзацную экскурсию по этому репозиторию: для чего каждый файл и папка верхнего уровня, и как я запускаю приложение и тесты. Ничего не меняй.»

Сравните его ответ с тем, что вы видели в шагах 3–4. Привыкнуть просить агента объяснять перед тем, как редактировать — это ключевая привычка, мы будем на неё сильно опираться.

---

✅ Попробуйте со своим агентом

1. Спросите агента: «Что печатает node bin/lockedin.js reflect 'мой кофе был холодным', и какой файл решает этот вывод?» Подтвердите его ответ, запустив команду самостоятельно.
2. Попросите его запустить набор тестов и сообщить результат: «Запусти npm test и скажи мне, сколько проверок проходит.»

Теперь вы увидели приложение, тесты и агента. Далее мы посмотрим, почему этот код так дружелюбен к агентам — на дизайн, позволяющий передавать изменения с уверенностью.

Далее: Урок 2 Как работает код