ask-question

遭遇した問題について技術調査の質問を作成するのをお手伝いし、ChatGPTに調査してもらいます。

引数: $ARGUMENTS

• 最初の単語が draft の場合: 質問ファイルを作成するだけで、ChatGPTへの送信をスキップします
• その他の場合: 質問を作成し、ChatGPTに送信し、回答を読んで、一緒に検討します

重要な原則: 自信よりも好奇心。 目標は有用な調査結果を得ることであり、賢そうに聞こえることではありません。何を知っているのか、何を推測しているのかを明確にしてください。誤った仮定は ChatGPT の推論を間違った問題に費やしてしまいます。

プロセス:

1. 問題のコンテキストを理解する

   • トピックが提供されている場合、現在のコードベースで調査します
   • 最近のエラー、コード変更、または会話の記録を確認します
   • 具体的な技術的な問題を特定します(エラーメッセージ、予期しない動作、アーキテクチャの質問など)

2. 環境コンテキストを集める

   • 言語/フレームワークのバージョンを確認します(package.json、build.gradle、pom.xml、MODULE.bazel など)
   • 関連する依存関係とそのバージョンを特定します
   • モノレポやビルドシステムの制約を記録します

3. 最小限の再現例を作成する

   • 問題を示す具体的なコードを抽出します
   • 関連のないプロジェクト固有の詳細を削除します
   • 必要に応じて設定ファイル(application.yml など)を含めます

4. ローカルのマークダウンファイルに質問を書く

   ファイルの場所: /tmp/ に research-{topic-slug}-question.md というパターンで保存します(例: research-bazel-caching-question.md)。

   以下のセクションで質問を構成します:

   # [説明的なタイトル(質問形式)]
   
   ## キーワード
   `keyword1` `keyword2` `keyword3` (ChatGPT がドメインを理解するのに役立つ)
   
   ## 質問
   
   [冒頭段落: 何をしようとしていて、何がうまくいっていないのか]
   
   ### 環境
   - 言語/フレームワークのバージョン
   - 関連するライブラリのバージョン
   - ビルドシステム(関連する場合)
   - OS/プラットフォーム(関連する場合)
   
   ### コード
   
   **[ファイル名またはコンポーネント名]:**
   ```language
   // 最小限のコード例
   

   [関連する設定ファイル]:

   # 関連する設定
   

   エラー/動作

   [正確なエラーメッセージまたは予期しない動作の説明]
   

   わかっていること(確認済みの事実)

   • [事実 1 - どのように確認したか]
   • [事実 2 - どのように確認したか]

   不確実なこと

   • [仮説 1 - なぜそう疑うのか、信頼度]
   • [仮説 2 - なぜそう疑うのか、信頼度]
   • [理解のギャップ - まだ確認していないこと]

   具体的な質問

   1. [具体的な質問 1]
   2. [具体的な質問 2 - オプション]
   3. [具体的な質問 3 - オプション]

   制約

   [ソリューションを制限するハードな制約: 「X を使う必要がある」「Y を変更できない」「モノレポが Z を要求している」など。実際の制約のみを含め、好みは含めません。]

5. 完成前に正誠性チェックリスト

   • タイトルは具体的な質問である(「X の問題」ではない)
   • コードは最小限だが完全である(再現するためにコピー&ペーストできる)
   • エラーメッセージは正確である(言い換えではない)
   • 「わかっていること」は実際に確認したものだけを含む
   • 「不確実なこと」は正直にギャップを捉えている
   • 作り話の主張がない(例: 実際にテストしていないのに「Linux でテスト済み」)
   • 信頼度が妥当である(確実性を過大評価していない)
   • 質問は具体的で回答可能である
   • 機密情報がない(認証情報、内部 URL、会社名など)
   • 制約は実際の制約であり、好みではない

文体ガイドライン:

• 簡潔でありながら完全にする
• 「我々」を使う(ユーザーとの協調的なトーン)
• 説明するだけでなく問題を示す
• テストしていない、または確認していないことを明示する
• バージョン番号を含める - それは重要です!
• 何か不確実な場合は、推測するのではなく言及する

6. ChatGPT に送信する(ドラフトモード以外)

   $ARGUMENTS が draft で始まる場合、このステップをスキップします - ファイルが保存された場所をユーザーに伝えるだけです。

   それ以外の場合、ask-question CLI を使用して質問を ChatGPT に送信します:

   ask-question -f /tmp/research-{topic-slug}-question.md \
                -o /tmp/research-{topic-slug}-answer.md \
                -t 1200000
   

   重要: 常に 20 分以上のタイムアウト(-t 1200000)を使用してください。ChatGPT の「Extended Thinking」モードは複雑な質問に対して数分かかることがあります。より短いタイムアウトは使用しないでください。

   ask-question が正常に返された後、回答が stdout に出力され、将来の参考のために回答ファイルに保存されます。ユーザーと一緒に検討してください。応答から重要な洞察と推奨事項を要約します。