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

create-github-issues-for-unmet-specification-requirements について

このスキルは、仕様に記載された要件のうち、コードベースでまだ実装されていないものに対して GitHub のイシューを自動作成するものです。書かれた仕様と提供されたコードの間のギャップを解消し、未実装の要件を追跡可能なアクション可能なイシューとして体系的に変換することで、文書化されたニーズが黙って見落とされる可能性を減らします。

ワークフローはコンパクトです：仕様ファイルを解析してすべての要件を抽出し、コードベースを確認して各要件の実装ステータスを判断し、既存のイシューを検索（search_issues 経由）して重複を回避し、実装されていない要件ごとにリポジトリの feature_request.yml テンプレートを使用して新しいイシューを 1 つ作成します（create_issue 経由）。テンプレートが存在しない場合はデフォルトのテンプレートにフォールバックします。各イシューには、明確な要件 ID と説明のマッピング、実装ガイドライン、および受入基準が含まれることが期待され、ラベルは機能や改善など適切なものが付与されます。実装チェックには、関連するパターンについてコードベースを検索し、/spec/ ディレクトリ内の関連する仕様ファイルを確認し、要件がすでに部分的に実装されていないことを検証することが含まれます。

このスキルは、仕様書から作業し、イシュートラッカーを未実装の要件と同期させたい開発者、テクニカルリード、およびプロジェクトメンテナを対象としています。典型的なユースケースには、新しい仕様からバックログを初期化する、既存のコードベースに対して仕様を照合する、各要件に追跡可能なイシューがあることを確保する、などが含まれます。これは読み取りおよび作成に特化したワークフローです：仕様とコードを読み取り、標準的なツールを使用して GitHub のイシューを作成し、破壊的な操作、資格情報の処理、またはコードの実行を行わないため、リスクが低いです。

FAQ

このスキルは何を生成しますか？

仕様で見つかった未実装の要件ごとに 1 つの GitHub イシューを生成します。各イシューには、要件 ID と説明、実装ガイドライン、受入基準、および機能や改善などの適切なラベルが含まれます。

重複するイシューの作成をどのように回避しますか？

イシューを作成する前に、既存のイシューを検索（search_issues を使用）し、各要件がコードベースで既に実装されているか、または部分的に実装されていないかを確認します。

どのイシューテンプレートを使用しますか？

リポジトリの feature_request.yml テンプレートを使用し、それが利用できない場合はデフォルトのテンプレートにフォールバックします。

要件が実装されているかどうかをどのように判断しますか？

関連するコードパターンについてコードベースを検索し、/spec/ ディレクトリ内の関連する仕様ファイルを確認して、実装ステータスを評価します。

仕様ファイルを提供する必要がありますか？

はい。このスキルは、指定された仕様ファイルを対象として動作し、実装ステータスを確認する前にそこからすべての要件を抽出します。