to-issues について
to-issuesは、計画を個別に着手できるエンドツーエンドの課題に分割するスキルです。縦方向のスライスを重視し、範囲と依存関係を確認してから、ブロッカー順に課題を登録します。
主な機能
- 01計画をエンドツーエンドの縦スライスに分割
- 02各課題を単独で検証可能にする
- 03範囲と依存関係をユーザーと確認
- 04承認済み課題を依存順に登録
活用シーン
- 01承認済み計画をトラッカーの課題に変換
- 02作業をデモ可能な実装スライスに分割
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ utarn/ engineer-skills --skill to-issuesインストール後、Claude Code で/to-issuesを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
課題への分割
垂直スライス(トレーサーバレット)を使って、計画を個別に着手できる課題に分割します。
課題トラッカーとトリアージ用ラベルの語彙は、すでに共有されているはずです。共有されていない場合は、/setup-utarn-skills を実行してください。
プロセス
1. コンテキストを集める
会話のコンテキストにすでにある情報をもとに進めます。ユーザーが引数として課題への参照(課題番号、URL、パス)を渡した場合は、課題トラッカーから取得し、本文とコメントをすべて読みます。
2. コードベースを調べる(任意)
コードベースをまだ調べていない場合は、現在のコードの状態を把握するために調べます。課題のタイトルと説明には、プロジェクトのドメイン用語集の語彙を使い、対象領域の ADR を遵守してください。
実装を容易にするため、コードを事前にリファクタリングできる箇所がないか確認します。「変更を容易にしてから、容易な変更を行う。」
3. 垂直スライスを作成する
計画をトレーサバレットとなる課題に分割します。各課題は、特定のレイヤーだけを横断する水平スライスではなく、すべての統合レイヤーをエンドツーエンドで貫く、薄い垂直スライスです。
- 各スライスは、すべてのレイヤー(スキーマ、API、UI、テスト)を通る、範囲は狭いものの完全な経路を提供します
- 完了したスライスは、単独でデモまたは検証できます
- 事前のリファクタリングが必要な場合は、先に行います
4. ユーザーに確認する
提案する内訳を番号付きリストで提示します。各スライスについて、以下を示します。
- タイトル:短く、内容がわかる名前
- ブロック要因:先に完了する必要がある他のスライス(あれば)
- 対象となるユーザーストーリー:対応するユーザーストーリー(元の資料に記載がある場合)
ユーザーに以下を確認します。
- 粒度は適切ですか?(粗すぎる/細かすぎる)
- 依存関係は正しいですか?
- スライスを統合したり、さらに分割したりする必要はありますか?
ユーザーが内訳を承認するまで調整を繰り返します。
5. 課題を課題トラッカーに登録する
承認された各スライスについて、以下の課題本文テンプレートを使って新しい課題を課題トラッカーに登録します。これらの課題は AFK エージェントがすぐに作業できる状態とみなされるため、別途指示がない限り、適切なトリアージ用ラベルを付けて登録してください。
依存関係の順(ブロックする課題が先)に登録し、「ブロック要因」欄で実際の課題 ID を参照できるようにします。
## 親課題課題トラッカー上の親課題への参照(元の資料が既存の課題である場合。そうでなければ、このセクションは省略します)。
実装内容
この垂直スライスの内容を簡潔に説明します。レイヤーごとの実装方法ではなく、エンドツーエンドの動作を説明してください。
具体的なファイルパスやコードスニペットは避けてください。すぐに古くなるためです。例外として、プロトタイプで作成したスニペットが、文章よりも正確に判断内容を表現している場合(状態機械、リデューサー、スキーマ、型の形状など)は、ここにインラインで記載し、プロトタイプ由来であることを簡潔に注記してください。判断に重要な部分だけを残し、動作するデモではなく、重要な要点に絞ってください。
受け入れ条件
- 条件 1
- 条件 2
- 条件 3
ブロック要因
- ブロックする課題への参照(あれば)
ブロック要因がない場合は、「なし — すぐに着手できます」と記載します。
親課題をクローズしたり、変更したりしてはいけません。