mcpField
T
to-issues

to-issues

github.com/utarn開発4976 回インストール9 週間前に更新
リポジトリ

to-issues について

to-issuesは、計画を個別に着手できるエンドツーエンドの課題に分割するスキルです。縦方向のスライスを重視し、範囲と依存関係を確認してから、ブロッカー順に課題を登録します。

主な機能

  1. 01計画をエンドツーエンドの縦スライスに分割
  2. 02各課題を単独で検証可能にする
  3. 03範囲と依存関係をユーザーと確認
  4. 04承認済み課題を依存順に登録

活用シーン

  1. 01承認済み計画をトラッカーの課題に変換
  2. 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

ブロック要因

  • ブロックする課題への参照(あれば)

ブロック要因がない場合は、「なし — すぐに着手できます」と記載します。

親課題をクローズしたり、変更したりしてはいけません。

コメント