spec-it について
Matt Pocock の `to-spec` スキルを使い、仕様を GitHub issue として公開した後、必要なラベルを追加して検証するスキルです。仕様公開と既存の issue トリアージ状態の保持が必要なリポジトリ向けです。
主な機能
- 01`to-spec` スキルの呼び出し
- 02仕様の GitHub issue 化
- 03不足ラベルのみ追加
- 04既存のトリアージラベルを保持
- 05issue のラベルと URL を検証
活用シーン
- 01仕様を GitHub に公開
- 02公開済み issue への `spec` 追加
- 03状態ラベルがない場合の `status/todo` 追加
- 04issue を重複作成せずラベル作業を再開
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ goncalvesjoao/ ship-it --skill spec-itインストール後、Claude Code で/spec-itを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
仕様を作成する
ユーザーからの質問
ユーザーからの質問を尋ねたり伝えたりする前に、ユーザーからの質問に関するルールを読み、従ってください。
Matt Pocock の to-spec スキル、その前提条件、および認証済みの GitHub CLI(gh)が必要です。
-
インストール済みの
to-specスキルを見つけて読みます。利用可能な場合は Skill ツールを使って呼び出し、そうでない場合はそのSKILL.mdに従ってください。GitHub を公開先として、探索、テストの接点の確認、仕様テンプレート、トリアージラベルを維持してください。前提条件が不足している場合、または対象リポジトリが曖昧な場合は、公開前にその阻害要因を報告してください。 -
公開されたイシューの URL を保持し、そのリポジトリとイシュー番号を特定します。
to-specによって GitHub イシューが公開された場合にのみ続行してください。ラベル付けを再開する場合は、別の仕様を公開せず、そのイシューを再利用してください。 -
イシューの現在のラベルを読み取ります。
gh issue view <issue-number> --repo <owner/repo> --json url,labelsspecがない場合にのみ追加します。現在のラベルにstatus/で始まるものがない場合にのみstatus/todoを追加します。既存のステータスラベルや上流のトリアージラベルを含め、すべての既存ラベルを保持してください。 -
追加が必要なラベルごとに、リポジトリにそのラベルが存在するか確認します。存在しないリポジトリラベルは、既存のラベル設定を維持しながら
gh label create <label> --repo <owner/repo>で作成してください。不足しているイシューラベルのみを、gh issue edit <issue-number> --repo <owner/repo> --add-label <label>で追加します。リポジトリを明示的に指定し、値は安全に引用符で囲んでください。 -
イシューのラベルを再取得します。
specが存在し、status/で始まるラベルが少なくとも1つあることを確認してください。確認に成功した後にのみ、イシューの URL と結果のラベルを返します。
ラベル付けまたは確認に失敗した場合は、イシューの URL と未完了の操作を報告してください。再試行の前に現在のラベルを確認し、ステータスを置き換えたり、重複を作成したりせずに、既存のイシューを更新して復旧してください。