mcpField
T
to-issues-yes

to-issues-yes

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

to-issues-yes について

計画を個別に実装できるエンドツーエンドの課題へ分割するスキルです。依存関係の整理から課題トラッカーへの登録までを案内します。

主な機能

  1. 01垂直スライスで計画を分割
  2. 02課題間の依存関係を整理
  3. 03タイトルとユーザーストーリーを記載
  4. 04依存順に課題を登録

活用シーン

  1. 01機能計画を検証可能な課題に変換
  2. 02エージェント向けの独立した作業を準備

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/utarn/engineer-skills --skill to-issues-yes

インストール後、Claude Code で/to-issues-yesを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yaml

詳細

To Issues

プランを垂直スライス(トレーサーバレット)を使って、個別に着手できるイシューに分割します。

イシュートラッカーとトリアージ用ラベルの語彙は、あらかじめ共有されているはずです。共有されていない場合は、/setup-utarn-skills を実行してください。

プロセス

1. コンテキストを集める

会話内にある情報をもとに作業してください。ユーザーから引数としてイシューの参照(イシュー番号、URL、またはパス)が渡された場合は、イシュートラッカーから取得して、本文とコメントをすべて読んでください。

2. コードベースを調べる(任意)

まだコードベースを調べていない場合は、コードの現在の状態を把握するために確認してください。イシューのタイトルと説明には、プロジェクトのドメイン用語集の語彙を使い、変更対象の領域に関する ADR を遵守してください。

実装を容易にするため、コードを事前にリファクタリングできる機会を探してください。「変更を容易にしてから、容易になった変更を行います。」

3. 垂直スライスを作成する

プランをトレーサーバレットのイシューに分割してください。各イシューは、1 つのレイヤーだけを対象とする水平スライスではなく、すべての統合レイヤーをエンドツーエンドで通す、薄い垂直スライスです。

  • 各スライスは、すべてのレイヤー(スキーマ、API、UI、テスト)にまたがる、範囲が狭くても完全な経路を提供します
  • 完了したスライスは、それ単体でデモまたは検証ができます
  • 事前のリファクタリングが必要な場合は、先に実施してください
4. スライスは承認されたものとして進める

提案する内訳を番号付きリストで提示してください。各スライスについて、次の内容を示します。

  • タイトル:短く、内容が伝わる名前
  • ブロックされる要因:先に完了する必要がある他のスライス(あれば)
  • 対応するユーザーストーリー:該当するユーザーストーリー(元の資料に記載がある場合)

ユーザーが内訳を承認したものとして、イシューの公開に進んでください。

  • 粒度は適切ですか?(粗すぎる/細かすぎる)
  • 依存関係は正しいですか?
  • スライスを統合したり、さらに分割したりするべきですか?

ユーザーが内訳を承認するまで、調整を繰り返してください。

5. イシューをイシュートラッカーに公開する

承認された各スライスについて、新しいイシューをイシュートラッカーに公開してください。以下のイシュー本文テンプレートを使用します。これらのイシューは AFK エージェントがすぐに作業できる状態とみなされるため、別途指示がない限り、適切なトリアージラベルを付けて公開してください。

依存関係の順に(ブロッカーを先に)イシューを公開し、「ブロックされる要因」欄で実際のイシュー識別子を参照できるようにしてください。

## 親イシュー

イシュートラッカー上の親イシューへの参照(元の資料が既存イシューの場合。そうでなければ、このセクションは省略します)。

実装内容

この垂直スライスの内容を簡潔に説明します。レイヤーごとの実装方法ではなく、エンドツーエンドの振る舞いを記述してください。

具体的なファイルパスやコードスニペットは避けてください。すぐに古くなるためです。例外として、プロトタイプで作成したスニペットが、文章よりも正確に設計上の決定(状態機械、リデューサー、スキーマ、型の構造など)を表している場合は、ここにインラインで記載し、プロトタイプ由来であることを簡潔に明記してください。重要な判断を示す部分だけを残し、動作するデモ全体は含めないでください。

受け入れ条件

  • 条件 1
  • 条件 2
  • 条件 3

ブロックされる要因

  • ブロッカーとなるチケットへの参照(あれば)

ブロッカーがない場合は「なし — すぐに着手できます」と記載してください。

親イシューをクローズしたり変更したりしないでください。

コメント