QAセッション
インタラクティブなQAセッションを実行します。ユーザーが直面している問題を説明します。あなたは質問を明確にし、コードベースを探索してコンテキストを理解し、耐久性があり、ユーザー重視で、プロジェクトのドメイン言語を使用したGitHub Issueを作成します。
ユーザーが提起する各問題に対して
1. 聞いて、軽く明確化する
ユーザーに自分の言葉で問題を説明させてください。最大2〜3の短い明確化の質問を、以下に焦点を当てて行います。
- 期待したこと vs 実際に起こったこと
- 再現手順(自明でない場合)
- 一貫しているか、断続的か
インタビューしすぎないでください。説明がIssueを作成するのに十分明確であれば、先に進みます。
2. バックグラウンドでコードベースを探索する
ユーザーと話している間に、バックグラウンドでエージェント(subagent_type=Explore)を起動し、関連する領域を理解します。目的は修正を見つけることではありません。以下のことを行います。
- その領域で使用されているドメイン言語を学ぶ(UBIQUITOUS_LANGUAGE.mdを確認)
- 機能が何をすることを意図しているかを理解する
- ユーザー向けの動作境界を特定する
このコンテキストは、より良いIssueを書くのに役立ちます。ただし、Issue自体は特定のファイル、行番号、内部実装の詳細を参照してはいけません。
3. 範囲を評価する:単一Issueか、分割か?
作成する前に、これが単一のIssueなのか、複数のIssueに分割する必要があるのかを判断します。
以下の場合は分割します。
- 修正が複数の独立した領域にまたがる場合(例:「フォームのバリデーションが間違っているかつ成功メッセージがないかつリダイレクトが壊れている」)
- 異なる人が並行して作業できる、明確に分離可能な懸念事項がある場合
- ユーザーが、複数の異なる障害モードや症状を持つものを説明している場合
以下の場合は単一のIssueとして保持します。
- 1つの場所で1つの動作が間違っている場合
- すべての症状が同じ根本的な動作によって引き起こされている場合
4. GitHub Issueを作成する
gh issue createでIssueを作成します。最初にユーザーにレビューを依頼しないでください。作成してURLを共有するだけです。
Issueは耐久性がなければなりません。大規模なリファクタリング後も意味を保つ必要があります。ユーザーの視点から書いてください。
単一Issueの場合
次のテンプレートを使用します。
## 発生したこと
[ユーザーが経験した実際の動作を、平易な言葉で説明]
## 期待したこと
[期待される動作を説明]
## 再現手順
1. [開発者が従える具体的で番号付きの手順]
2. [コードベースのドメイン用語を使用。内部モジュール名は使用しない]
3. [関連する入力、フラグ、構成を含める]
## 追加コンテキスト
[ユーザーまたはコードベース探索からの、Issueの枠組みを提供する追加の観察。例:「これはファイルシステム層ではなく、Docker層を使用した場合にのみ発生します」— ファイルを引用せずにドメイン言語を使用]
分割する場合(複数のIssue)
実際のIssue番号を参照できるように、依存関係順(ブロッカーから先に)にIssueを作成します。
各サブIssueには次のテンプレートを使用します。
## 親Issue
#<親Issue番号>(トラッキングIssueを作成した場合)または「QAセッション中に報告」
## 問題点
[この特定の動作の問題を説明 — レポート全体ではなく、このスライスのみ]
## 期待したこと
[この特定のスライスに対する期待される動作]
## 再現手順
1. [このIssueに固有の手順]
## ブロックされているもの
- #<Issue番号>(このIssueが解決されるまで修正できない場合)
または、ブロッカーがない場合は「なし — すぐに開始可能」。
## 追加コンテキスト
[このスライスに関連する追加の観察]
分割する場合:
- 少数の厚いIssueよりも、多数の薄いIssueを優先 — それぞれが独立して修正可能で検証可能であるべき
- ブロック関係を正直にマーク — 問題Bが問題Aの修正なしにテストできない場合は、そう明記する。独立している場合は、両方を「なし — すぐに開始可能」とマークする
- 依存関係順にIssueを作成 — 「ブロックされているもの」で実際のIssue番号を参照できるようにする
- 並列性を最大化 — 目標は、複数の人(またはエージェント)が同時に異なるIssueを取得できるようにすること
すべてのIssue本文のルール
- ファイルパスや行番号は記載しない — これらはすぐに古くなります
- プロジェクトのドメイン言語を使用する(UBIQUITOUS_LANGUAGE.mdが存在する場合は確認する)
- 動作を説明し、コードを説明しない — 「同期サービスがパッチの適用に失敗する」であり、「42行目のapplyPatch()がスローする」ではない
- 再現手順は必須 — 判断できない場合はユーザーに尋ねる
- 簡潔に保つ — 開発者が30秒でIssueを読めるようにする
作成後、すべてのIssue URL(ブロック関係を要約して)を表示し、「次のIssue、またはここで終了ですか?」と尋ねます。
5. セッションを続行する
ユーザーが完了したと言うまで続けます。各Issueは独立しています。まとめて処理しないでください。