[Powered by 8sun]

Какие еще к черту требования?

Это восхитительный вопрос! Если он прозвучал, значит не все еще потеряно и есть хрупкий, но шанс, что вы начнете получать удовольствие от работы, ваши расходы сократятся, а доходы возрастут. Это не утопия, не причудливое воображение инфантильного оптимиста. Это — вполне реальные, закономерные последствия правильного подхода к решению задач.

“Будь у меня час, чтобы решить проблему, от которой зависела бы моя жизнь, я бы потратил 55 минут, размышляя и формулируя вопрос, а остальные 5 минут использовал бы на поиск ответа”.
— цитата, приписываемая Альберту Эйнштейну

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

И с этим трудно спорить — задачу невозможно решить, если она не ясна, то есть не сформулирована правильно. Но что такое задача?

No method is more effective than the good example.
Ни один метод не является более эффективным, чем хороший пример.
— Ингвар Кампрад, основатель компании Икеа

Рассмотрим простейший, но наглядный пример. Предположим, что нам требуется, чтобы ИИ написал для нас код:

— Создай функцию, которая возвращает разницу между датами
— fn diff<T: Date + PartialOrd>(date1: T, date2: T) -> T { … }
— О, нет, я же хотел функцию на Typescript
— function diff(date1: Date, date2: Date): Date { … }
— Не годится, дат может быть больше чем две
— function diff(dates: Date[]): Date { … }
— Я хочу, чтобы функция возвращала разницу в миллисекундах
— function diff(dates: Date[]): number | null { … }
— Нет, вводные даты должны быть в формате ISO8601

Пожалуй, на этом можно остановиться — идея понятна. Мы можем бесконечно долго уточнять, что мы хотим получить, и ИИ будет генерировать новые результаты.

Но что, если дело касается не функции, а целого проекта? Что, если его разрабатывает не ИИ, а человек? А ведь так оно обычно и происходит. Каковы тогда будут издержки на постоянную доработку?

Чтобы не отвечать на этот вопрос, нужно понять, что такое задача.

“Создай функцию, которая возвращает разницу между датами”

Является ли это задачей?

Нет. На основании этого ввода невозможно выработать корректное решение, как показывает пример. Это всего лишь посыл, нечто выраженное не до конца — внезапная идея.

“Создай функцию на Typescript, которая принимает массив дат в формате ISO8601 и возвращает разницу между датами в миллисекундах.”

Это уже больше похоже на задачу. Разница существенная, правда?

В принципе, если такой промпт предложить ИИ, он с первого раза напишет то, что нам нужно. Как и разработчик программного обеспечения. Однако, если мы хотим создать большой и сложный проект, подобный способ описания задачи будет трудоемким и неэффективным. Поэтому вместо художественной формы умные люди придумали техническое представление, на котором описывать и читать задачи становится гораздо проще.

Вот как будет выглядеть контекст нашей задачи в формате технической документации:

Цель:
Создать функцию, которая возвращает разницу между датами.

Требования:

Просто и понятно. Здесь снова функция, но моя задача — передать идею, концепцию, подход.

Наконец мы приблизились к требованиям.

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

И это вызывает опасения. Если вы откажетесь от простой практики выявления требований и ясного формулирования задачи, вы обязательно столкнетесь с допиливанием, подкручиванием, вырезанием, перепаиванием и т.д. В итоге это превратится в мучительную рутину и станет нормой рабочего дня.

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

Однако сбор требований — не такая уж простая задача.

Во-первых, классы требований различаются: бизнес-требования, функциональные, пользовательские, системные и т.д. Программиста в первую очередь интересуют функциональные и системные, бизнес-аналитика — бизнес-требования.

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

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

Но отчаиваться не стоит — если разобраться в предмете, практика станет простой и последовательной.

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

Original: What the hell are requirements?