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

create-github-issues-for-unmet-specification-requirements에 대하여

이 스킬은 코드베이스에서 아직 구현되지 않은 명세서 파일의 요구사항에 대해 GitHub 이슈를 자동으로 생성합니다. 이는 작성된 명세서와 제공된 코드 간의 격차를 해소하며, 미 충족 요구사항을 체계적으로 추적 가능한 실행 가능한 이슈로 전환하여 문서화된 필요 사항이 묵묵히 누락될 가능성을 줄입니다.

워크플로우는 간결합니다: 명세서 파일을 분석하여 모든 요구사항을 추출하고, 코드베이스를 확인하여 각 요구사항의 구현 상태를 결정하며, 기존 이슈(search_issues를 통해)를 검색하여 중복을 피하고, 구현되지 않은 각 요구사항에 대해 하나씩 새 이슈(create_issue를 통해)를 생성합니다. 이때 저장소의 feature_request.yml 템플릿을 사용하며, 해당 템플릿이 없으면 기본 템플릿으로 대체합니다. 각 이슈에는 명확한 요구사항 ID와 설명 매핑, 구현 가이드, 수락 기준이 포함되어야 하며, feature 또는 enhancement와 같은 적절한 라벨이 부여됩니다. 구현 확인에는 관련 패턴에 대한 코드베이스 검색, /spec/ 디렉토리 하위의 관련 명세서 파일 확인, 그리고 요구사항이 이미 부분적으로 구현되지 않았는지 검증하는 작업이 포함됩니다.

이 스킬은 명세서 문서를 기반으로 작업하며 미 충족 요구사항과 이슈 추적기를 동기화하려는 개발자, 기술 리드 및 프로젝트 유지 관리자를 대상으로 합니다. 일반적인 사용 사례에는 새 명세서에서 백로그 초기화, 기존 코드베이스에 대한 명세서 조정, 그리고 각 요구사항에 추적 가능한 이슈가 있음을 보장하는 작업이 포함됩니다. 이는 얇은 읽기 및 생성 워크플로우로, 표준 도구류를 통해 명세서와 코드를 읽고 GitHub 이슈를 작성하며, 파괴적 작업, 자격 증명 처리 또는 코드 실행이 없으므로 위험도가 낮습니다.

FAQ

이 스킬은 무엇을 생성합니까?

명세서에서 발견된 구현되지 않은 각 요구사항에 대해 하나의 GitHub 이슈를 생성하며, 각 이슈에는 요구사항 ID와 설명, 구현 가이드, 수락 기준, feature 또는 enhancement와 같은 적절한 라벨이 포함됩니다.

중복 이슈 생성을 어떻게 피합니까?

이슈를 생성하기 전에 기존 이슈(search_issues 사용)를 검색하고, 각 요구사항이 코드베이스에서 이미 구현되었거나 부분적으로 구현되지 않았는지 확인합니다.

어떤 이슈 템플릿을 사용합니까?

저장소의 feature_request.yml 템플릿을 사용하며, 해당 템플릿이 사용 불가능할 경우 기본 템플릿으로 대체합니다.

요구사항이 구현되었는지 어떻게 결정합니까?

관련 코드 패턴에 대해 코드베이스를 검색하고, /spec/ 디렉토리 하위의 관련 명세서 파일을 확인하여 구현 상태를 평가합니다.

명세서 파일을 제공합니까?

네. 이 스킬은 지시된 명세서 파일을 대상으로 작동하며, 구현 상태를 확인하기 전에 파일에서 모든 요구사항을 추출합니다.