Свой инструмент за вечер: шаблон задания и три готовых чертежа
Свой рабочий инструмент за вечер: шаблон задания, три готовых чертежа и порядок сборки по шагам
Для тех, кто не писал код никогда. Внутри шаблон задания на инструмент, три чертежа под живые задачи (таблица, считалка, напоминалка), порядок сборки с проверкой на каждом шаге и разбор пяти ошибок, на которых новички бросают.
Возьми одну свою рутину, которую делаешь руками каждую неделю. Заполни шаблон из второго раздела. Дальше иди по порядку сборки из четвёртого. К концу вечера инструмент запускается у тебя.
Почему первый инструмент почти всегда не доживает до конца
Типичный заход выглядит так: человек берётся за приложение мечты, к третьему вечеру внутри сотни файлов, ошибка не ищется, интерес гаснет. Причина одна: размер первой задачи.
Задача должна решаться одной кнопкой. Один вход, одно действие, один результат.
Задачу ты уже делаешь руками. Тогда понятно, что считать правильным ответом.
Результат виден глазами. Файл, таблица, сообщение. Невидимый результат проверить нечем.
Хорошая первая задача звучит скучно: «переношу цифры из трёх мест в одну таблицу каждую пятницу». Это и есть правильный размер.
Шаблон задания на инструмент
Заполняется за десять минут и экономит вечер. Модель сильна ровно настолько, насколько точно описан вход и выход.
Шаблон, заполни по пунктам
Задача: [что я делаю руками и хочу отдать инструменту].
Вход: [что я даю инструменту: файл, ссылку, список, число]. Пример входа: [приведи один настоящий пример целиком].
Выход: [что я хочу получить]. Пример выхода: [приведи, как должен выглядеть ответ, вплоть до названий столбцов].
Где он живёт: [страница в браузере / программа на компьютере / бот в переписке].
Кто им пользуется: [только я / ещё люди]. Если только я, красивый вид не нужен.
Чего делать не надо: [ничего не удалять, никуда не отправлять, ничего не публиковать].
Собираем по шагам. На каждом шаге показывай, что проверить, прежде чем идти дальше.
Два примера из этого шаблона решают половину дела. Пример входа и пример выхода снимают все догадки о том, что ты имел в виду.
Три готовых чертежа
Каждый проверен на реальной задаче. Подставляй своё в квадратные скобки и отдавай целиком.
Чертёж первый: сводная таблица
Промпт
Собери мне инструмент, который складывает данные из нескольких мест в одну таблицу.
Вход: [опиши, откуда беру данные: файлы выгрузок, страницы, таблицы].
Пример входа: [вставь настоящий кусок данных].
Выход: таблица со столбцами [перечисли столбцы], отсортированная по [чему]. Пустые значения помечай словом «нет».
Где живёт: страница в браузере, которую я открываю двойным щелчком по файлу. Без установки серверов.
Собираем по шагам:
1. Сначала страница, которая принимает файл и показывает его содержимое.
2. Потом разбор данных в таблицу.
3. Потом сортировка и выгрузка результата.
После каждого шага скажи, что мне открыть и что я должен увидеть, чтобы шаг считался рабочим.
Чертёж второй: считалка под свои цифры
Промпт
Собери мне считалку под мою задачу.
Что считаем: [опиши словами, например расход по проекту и остаток на месяц].
Вход: поля [перечисли поля и в чём измеряются].
Пример: [дай реальные числа и то, что должно получиться].
Выход: [число или несколько чисел], плюс строка словами, что это значит. Если введены неверные данные, скажи об этом человеческим языком, без ошибок красным текстом.
Где живёт: одна страница в браузере, всё на одном экране, считает сразу при вводе.
Собираем по шагам: сначала поля и вывод числа, потом проверка ввода, потом пояснение словами.
После каждого шага дай мне два примера для проверки: правильный ввод и заведомо неверный.
Чертёж третий: напоминалка
Промпт
Собери мне напоминалку, которая пишет мне сама.
Что напоминает: [о чём именно, например о сроке оплаты и о дне отчёта].
Вход: список дел с датами. Пример: [дай три строки настоящих дел].
Выход: сообщение мне в [телеграм / на почту] за [сколько] дней до срока, один раз на дело.
Где живёт: на моём компьютере, запускается сама раз в сутки.
Собираем по шагам:
1. Сначала чтение списка и вывод на экран того, что подходит по сроку.
2. Потом отправка сообщения.
3. Потом ежедневный запуск.
Объясни мне порядок запуска словами, как для человека, который никогда не открывал терминал. Доступы я вставлю сам, не проси меня прислать их в переписку.
Третий чертёж самый полезный и самый капризный: он требует доступа к отправке сообщений. Начинать лучше с первого или второго.
Главное правило: просишь по одному шагу. Большая просьба приносит большой кусок, в котором ошибка не ищется.
Проси шаг. Один шаг это одно понятное действие, которое можно проверить глазами.
Спрашивай, как запустить, ровно этими словами: что мне открыть и что я должен увидеть. Формулировка важна, иначе получишь путь к файлу вместо порядка запуска.
Проверяй. Открыл, увидел ожидаемое, идёшь дальше. Увидел другое, возвращаешь ошибку целиком.
Останавливайся, когда работает. Инструмент для себя не обязан быть красивым.
Строка, которую стоит давать в начале работы
Я собираю инструмент впервые и кода не знаю.
Давай по одному шагу и жди моего подтверждения.
После каждого шага пиши: что мне открыть, что я должен увидеть, что делать, если я вижу другое.
Объясняй человеческим языком, термины расшифровывай в одну строку.
Не предлагай мне ставить лишние программы, пока без них можно обойтись.
Пять ошибок, на которых бросают
Все пять встречались у тех, кому я это показывала.
Нет порядка запуска. Файл готов, и человек не знает, что с ним делать. Лечится вопросом «как мне это открыть», заданным на первом же шаге.
Ошибка красным текстом воспринимается как провал. Это обычный рабочий круг: копируешь целиком и отдаёшь обратно. Три таких круга за вечер это норма.
Просьба целиком. «Собери мне систему» приносит десять файлов и ни одного понятного места. Режется на шаги.
Переделки без края. Работает значит хватит. Улучшения начинаются после того, как ты попользовался инструментом неделю.
Доступы в переписку. Пароли и ключи вставляешь ты сам в отдельный файл. Модель об этом просить не должна. Просит, значит шаг сформулирован неверно.
И последнее. Первый инструмент почти никогда не выходит красивым. Ценность его в другом: после него исчезает страх, и вторая задача берётся уже спокойно.
Следующий шаг
Хочешь так же, но под свой блог и продукт?
Я собрал систему, по которой обычный человек запускает блог с нуля и набирает аудиторию без съёмок, монтажа и команды. Внутри разбор, с которого стартовал сам.