Инженерия требований на основе ИИ-агентов

• Break Down Complex Requirements — проанализировать выбранные требования и разделить их на более мелкие, независимо проверяемые требования, сохранив исходный замысел.

  Пример запроса:

  Break down these requirements.

• Apply Requirement Writing Standards — проверить требования и переписать их в соответствии с правилами составления требований вашей организации. Типичные проверки включают выявление неоднозначности, непроверяемых формулировок, отсутствующих исполнителей и неясных критериев приемки.

  Пример запроса:

  Rewrite these requirements according to our requirement quality standard.

• Translate Requirements — перевести требования с одного языка на другой, сохранив технический смысл, терминологию, идентификаторы и ссылки для прослеживаемости.

  Пример запроса:

  Translate these requirements to German.

• Classify Requirements — применить к требованиям принятую в организации схему классификации, например по категориям «Электроника», «Механика», «Программное обеспечение», «Функциональная безопасность», «Защищенность» или по другим корпоративным классификациям.

  Пример запроса:

  Classify these requirements according to our applicability model.

• Generate Verification Criteria — проанализировать требования и предложить методы верификации, критерии приемки или условия испытаний, позволяющие единообразно подтверждать соответствие требованиям.

  Пример запроса:

  Generate verification criteria for these requirements.

• Summarize a Specification/Section/Group of Requirements — создать краткое структурированное резюме спецификации, раздела требований или набора требований.

  Пример запроса:

  Summarize the selected requirements.

Хорошо сформулированный навык помогает ИИ понять две вещи:

• Когда следует использовать навык

• Что должен делать ИИ при выполнении навыка

При определении навыка, 

Это задается с помощью трех полей, каждое из которых имеет свое назначение:

• Name — помогает вам распознать навык.

• Short Description — помогает ИИ определить, когда навык применим.

• Instructions — задают порядок действий ИИ после выбора навыка.

Подробные сведения о каждом поле приведены в разделах ниже.

Название

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

Удачное название навыка должно быть:

• Достаточно конкретным, чтобы отличать этот навык от других

• Достаточно кратким, чтобы его было легко найти при просмотре списка навыков

• Сосредоточенным на основной задаче, которую выполняет навык

• Сформулированным на понятном пользователям языке

Избегайте слишком широких или общих названий. Если название подходит для множества разных задач, скорее всего, оно недостаточно конкретно.

Краткое описание

Поле Short Description помогает ИИ понять, для чего предназначен навык и когда его следует активировать. Это поле важно, поскольку вам не нужно выбирать навык вручную. Ассистент анализирует ваш запрос, сопоставляет его с доступными навыками и определяет, подходит ли какой-либо из них.

Хорошее краткое описание должно объяснять:

• Какую задачу выполняет навык

• К какому типу инженерных данных он применяется

• Когда следует использовать навык

• Какой результат ожидается от навыка

Краткое описание должно быть лаконичным, но не расплывчатым. Оно должно содержать достаточно контекста, чтобы ИИ мог отличить этот навык от похожих.

Слабое краткое описание лишь указывает область, к которой относится навык. Сильное краткое описание объясняет конкретную задачу, предполагаемый контекст и условия активации. Например, вместо того чтобы описывать навык как нечто, что «помогает с требованиями», следует уточнить, проверяет ли он качество требований, разбивает ли сложные требования на составляющие, переводит ли текст требований, выявляет ли противоречия, формирует ли критерии проверки или выполняет другое конкретное действие.

Чем лучше краткое описание раскрывает назначение навыка и контекст его использования, тем надежнее ассистент сможет определять, когда его применять.

Инструкции

Поле Instructions определяет, что должен делать ИИ после выбора навыка. Это самое важное поле для управления поведением навыка. Краткое описание помогает ИИ решить, когда использовать навык, а инструкции определяют, как именно он должен работать.

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

Инструкции должны объяснять:

• What the AI should analyze first – прежде чем что-либо изменять или создавать, ассистент обычно должен понять инженерный замысел, контекст, структуру или взаимосвязи.

• What steps the AI should perform – действия следует разбить на явно заданные шаги, чтобы результат был воспроизводимым и предсказуемым.

• What the AI should preserve – это может включать исходный замысел, идентификаторы требований, технические термины, единицы измерения, значения, ограничения, ссылки, применимость, иерархию или контекст прослеживаемости.

• What the AI must not do – хорошие навыки явно запрещают ИИ выдумывать недостающие инженерные сведения, изменять замысел, вводить новые допущения или применять изменения без проверки пользователем.

• How the AI should handle uncertainty – если информация отсутствует, неоднозначна или недостаточна, навык должен предписывать ИИ четко указать на проблему, а не строить догадки.

• What output format is expected – навык должен определять, в каком виде представить результат: в виде таблицы, маркированного списка, переработанного текста, сводки, контрольного списка или структурированного отчета.

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

Другие замечания

• Цель — не написать длинный запрос, а задать для ИИ четкий порядок работы.

• Keep Skills Focused

  Навык должен хорошо выполнять одну повторяемую задачу.

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

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

• Define Boundaries Clearly

  Хорошие навыки явно задают границы допустимого.

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

  Полезные ограничения:

  • Не изменять исходный инженерный замысел

  • Не выдумывать значения, ограничения или проектные решения

  • Не удалять идентификаторы или ссылки

  • Не предполагать методы проверки, если они не указаны

  • Не применять изменения автоматически без проверки пользователем

  • Не считать неясную информацию фактом

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

• Define the Output Format

  Навык должен указывать ИИ, как представить результат.

  Единообразный формат результата упрощает его проверку, сравнение и повторное использование.

  В зависимости от навыка результатом может быть:

  • Таблица

  • Маркированный список

  • Переработанное требование

  • Структурированный отчет

  • Контрольный список

  • Сводка

  • Список предлагаемых изменений

  • Набор вопросов или нерешенных проблем

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