Свой инструмент за вечер: шаблон задания и три готовых чертежа

Свой рабочий инструмент за вечер: шаблон задания, три готовых чертежа и порядок сборки по шагам

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

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

Почему первый инструмент почти всегда не доживает до конца

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

  • Задача должна решаться одной кнопкой. Один вход, одно действие, один результат.
  • Задачу ты уже делаешь руками. Тогда понятно, что считать правильным ответом.
  • Результат виден глазами. Файл, таблица, сообщение. Невидимый результат проверить нечем.
Хорошая первая задача звучит скучно: «переношу цифры из трёх мест в одну таблицу каждую пятницу». Это и есть правильный размер.

Шаблон задания на инструмент

Заполняется за десять минут и экономит вечер. Модель сильна ровно настолько, насколько точно описан вход и выход.

Шаблон, заполни по пунктам
Задача: [что я делаю руками и хочу отдать инструменту]. Вход: [что я даю инструменту: файл, ссылку, список, число]. Пример входа: [приведи один настоящий пример целиком]. Выход: [что я хочу получить]. Пример выхода: [приведи, как должен выглядеть ответ, вплоть до названий столбцов]. Где он живёт: [страница в браузере / программа на компьютере / бот в переписке]. Кто им пользуется: [только я / ещё люди]. Если только я, красивый вид не нужен. Чего делать не надо: [ничего не удалять, никуда не отправлять, ничего не публиковать]. Собираем по шагам. На каждом шаге показывай, что проверить, прежде чем идти дальше.

Два примера из этого шаблона решают половину дела. Пример входа и пример выхода снимают все догадки о том, что ты имел в виду.

Три готовых чертежа

Каждый проверен на реальной задаче. Подставляй своё в квадратные скобки и отдавай целиком.

Чертёж первый: сводная таблица

Промпт
Собери мне инструмент, который складывает данные из нескольких мест в одну таблицу. Вход: [опиши, откуда беру данные: файлы выгрузок, страницы, таблицы]. Пример входа: [вставь настоящий кусок данных]. Выход: таблица со столбцами [перечисли столбцы], отсортированная по [чему]. Пустые значения помечай словом «нет». Где живёт: страница в браузере, которую я открываю двойным щелчком по файлу. Без установки серверов. Собираем по шагам: 1. Сначала страница, которая принимает файл и показывает его содержимое. 2. Потом разбор данных в таблицу. 3. Потом сортировка и выгрузка результата. После каждого шага скажи, что мне открыть и что я должен увидеть, чтобы шаг считался рабочим.

Чертёж второй: считалка под свои цифры

Промпт
Собери мне считалку под мою задачу. Что считаем: [опиши словами, например расход по проекту и остаток на месяц]. Вход: поля [перечисли поля и в чём измеряются]. Пример: [дай реальные числа и то, что должно получиться]. Выход: [число или несколько чисел], плюс строка словами, что это значит. Если введены неверные данные, скажи об этом человеческим языком, без ошибок красным текстом. Где живёт: одна страница в браузере, всё на одном экране, считает сразу при вводе. Собираем по шагам: сначала поля и вывод числа, потом проверка ввода, потом пояснение словами. После каждого шага дай мне два примера для проверки: правильный ввод и заведомо неверный.

Чертёж третий: напоминалка

Промпт
Собери мне напоминалку, которая пишет мне сама. Что напоминает: [о чём именно, например о сроке оплаты и о дне отчёта]. Вход: список дел с датами. Пример: [дай три строки настоящих дел]. Выход: сообщение мне в [телеграм / на почту] за [сколько] дней до срока, один раз на дело. Где живёт: на моём компьютере, запускается сама раз в сутки. Собираем по шагам: 1. Сначала чтение списка и вывод на экран того, что подходит по сроку. 2. Потом отправка сообщения. 3. Потом ежедневный запуск. Объясни мне порядок запуска словами, как для человека, который никогда не открывал терминал. Доступы я вставлю сам, не проси меня прислать их в переписку.
Третий чертёж самый полезный и самый капризный: он требует доступа к отправке сообщений. Начинать лучше с первого или второго.

Порядок сборки и проверка на каждом шаге

Главное правило: просишь по одному шагу. Большая просьба приносит большой кусок, в котором ошибка не ищется.

  • Проси шаг. Один шаг это одно понятное действие, которое можно проверить глазами.
  • Спрашивай, как запустить, ровно этими словами: что мне открыть и что я должен увидеть. Формулировка важна, иначе получишь путь к файлу вместо порядка запуска.
  • Проверяй. Открыл, увидел ожидаемое, идёшь дальше. Увидел другое, возвращаешь ошибку целиком.
  • Сохраняй рабочее состояние. Проси называть версии: «рабочая первая», «рабочая вторая». Сломается, вернёшься.
  • Останавливайся, когда работает. Инструмент для себя не обязан быть красивым.
Строка, которую стоит давать в начале работы
Я собираю инструмент впервые и кода не знаю. Давай по одному шагу и жди моего подтверждения. После каждого шага пиши: что мне открыть, что я должен увидеть, что делать, если я вижу другое. Объясняй человеческим языком, термины расшифровывай в одну строку. Не предлагай мне ставить лишние программы, пока без них можно обойтись.

Пять ошибок, на которых бросают

Все пять встречались у тех, кому я это показывала.

  • Нет порядка запуска. Файл готов, и человек не знает, что с ним делать. Лечится вопросом «как мне это открыть», заданным на первом же шаге.
  • Ошибка красным текстом воспринимается как провал. Это обычный рабочий круг: копируешь целиком и отдаёшь обратно. Три таких круга за вечер это норма.
  • Просьба целиком. «Собери мне систему» приносит десять файлов и ни одного понятного места. Режется на шаги.
  • Переделки без края. Работает значит хватит. Улучшения начинаются после того, как ты попользовался инструментом неделю.
  • Доступы в переписку. Пароли и ключи вставляешь ты сам в отдельный файл. Модель об этом просить не должна. Просит, значит шаг сформулирован неверно.
И последнее. Первый инструмент почти никогда не выходит красивым. Ценность его в другом: после него исчезает страх, и вторая задача берётся уже спокойно.
Следующий шаг
Хочешь так же, но под свой блог и продукт?

Я собрал систему, по которой обычный человек запускает блог с нуля и набирает аудиторию без съёмок, монтажа и команды. Внутри разбор, с которого стартовал сам.

Открыть разбор: с чего начать