create-github-issues-for-unmet-specification-requirements

О create-github-issues-for-unmet-specification-requirements

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

Рабочий процесс компактен: анализируется файл спецификации для извлечения всех требований, проверяется кодовая база для определения статуса реализации каждого требования, осуществляется поиск существующих задач (через search_issues) для избежания дубликатов, и создается одна новая задача для каждого нереализованного требования (через create_issue) с использованием шаблона feature_request.yml репозитория, с переходом к шаблону по умолчанию, если он отсутствует. Каждая задача должна содержать четкий идентификатор требования и описание, рекомендации по реализации и критерии приемки, а также соответствующие метки, такие как feature или enhancement. Проверка реализации включает поиск в кодовой базе связанных паттернов, проверку связанных файлов спецификаций в каталоге /spec/ и подтверждение того, что требование еще не реализовано частично.

Он ориентирован на разработчиков, технических руководителей и сопровождающих проекты, которые работают со спецификациями и хотят поддерживать трекер задач в синхронизации с нереализованными требованиями. Типичные случаи использования включают инициализацию бэклога на основе новой спецификации, сопоставление спецификации с существующей кодовой базой и обеспечение наличия отслеживаемой задачи для каждого требования. Это легкий рабочий процесс «чтение-создание»: он читает спецификацию и код и создает задачи в GitHub через стандартные инструменты, без деструктивных операций, обработки учетных данных или выполнения кода, что делает его низко рисковым.

Часто задаваемые вопросы

Что производит этот навык?

Одна задача GitHub для каждого нереализованного требования, найденного в спецификации, каждая с идентификатором требования и описанием, рекомендациями по реализации, критериями приемки и соответствующими метками, такими как feature или enhancement.

Как он избегает создания дубликатов задач?

Перед созданием задач он ищет существующие задачи (используя search_issues) и проверяет, что каждое требование еще не реализовано или не реализовано частично в кодовой базе.

Какой шаблон задач он использует?

Он использует шаблон feature_request.yml репозитория и переходит к шаблону по умолчанию, если тот недоступен.

Как он определяет, реализовано ли требование?

Он ищет в кодовой базе связанные паттерны кода и проверяет связанные файлы спецификаций в каталоге /spec/ для оценки статуса реализации.

Предоставляю ли я файл спецификации?

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