rehearse-qa について
rehearse-qaは、講演、論文審査、ポスター発表に備えるためのリハーサルスキルです。論文やスライドに基づく質疑、回答のコーチング、記録の採点を行い、実際の質問を予測するものではありません。
主な機能
- 01会場に応じた聴衆ペルソナ
- 02一問ずつ進める質疑練習
- 03論文の根拠に沿った回答指導
- 04記録の時間と回答を定量チェック
- 05難問の準備とレポート作成
活用シーン
- 01学会発表や論文審査の練習
- 02ポスター発表の質疑準備
- 03難しい質問への簡潔な回答練習
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ shaishavmaisuria/ research-paper-lifecycle-skills --skill rehearse-qaインストール後、Claude Code で/rehearse-qaを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/answer-coaching.mdaudience-personas.mddreaded-questions.mdscripts/grade_answers.pyqa_drill.py詳細
質疑応答のリハーサル
本番前に質疑応答の練習をします。会場に合わせて調整された、批判的な人や好奇心旺盛な人などの聴衆をシミュレーションし、ユーザーが実際に書いた論文やスライドに基づいて、一度に一つずつ質問します。回答はすべて、簡潔で誠実な、回答を先に述べる形式になるよう指導します。話者が「誰にも聞かれたくない」と思っている質問も、漠然と恐れるのではなく、意識して準備します。
使用するタイミング
- 「論文について厳しく質問して」/「講演の質疑応答をリハーサルして」/「模擬質疑応答」
- 「聴衆からはどんな質問が出る?」/「受ける可能性がある最悪の質問は?」
- 「博士論文の審査/口頭試問の練習をして」/「ジョブトークの質問に備えて」
- ポスターセッションの準備(継続的な質疑応答、2分間および5分間のピッチ)
write-talk-script/make-slidesの後 — 講演の準備ができたら、台本にない部分をリハーサルします。simulate-reviewersの後 — その弱点リストを、恐れている質問の一覧に反映します。
入力
- 論文(存在する場合はスライド/台本も)、読み取り可能な形式で用意します。 一時的に処理し、論文の文章をこのリポジトリにコピーしないでください。
- 会場の形式と持ち時間:学会講演/ライトニングトーク/基調講演/ポスター/論文審査/ジョブトーク、および質疑応答の時間(分)。不明な場合は尋ねます。
- 任意ですが、用意するとよりよいものとして、会場のプロフィール
venues/conferences/<venue>-<year>.yml(スキーマはvenues/schema.yml)があります。これを使うと、聴衆をその会場の分野に合わせられます。 プロフィールがない場合は、parse-cfpで作成するか、汎用的な聴衆設定で実行します。
プロセス
-
ドリル計画を作成します。 次を実行します。
python3 scripts/qa_drill.py --setting conference-talk --minutes 3 \ --venue venues/conferences/<venue>-<year>.yml決定論的に動作し、オフラインで実行されます。スロットの計算結果(実際にライブの発表枠で収まる質問数と、ドリルする質問数)、ペルソナの構成と各ペルソナへの割り当て数(
--venueを指定した場合は会場の分野に合わせて調整)、ラウンド計画、回答時間の目標、およびステップ 6 用のトランスクリプトのひな形を出力します。機械処理用の出力には--jsonを、設定一覧には--helpを指定してください。終了コード:0 は正常終了、2 は引数が不正、またはプロフィールが存在しないか解析できない場合です。 -
スロットを再確認します — 必須です。 会場プロフィールには発表枠の長さが記録されておらず、質疑応答の長さは年、トラック、セッションによって変わります。会場の最新の発表者向け案内を確認し(プロフィールの
cfp_urlとwebsiteから確認してください)、発表枠の長さ、質疑応答の時間、形式(司会者進行の質疑応答、ライトニングトークで質疑応答なし、ポスター発表の運営方法)を確認します。時間を誤ってリハーサルすると、誤った回答を練習することになります。何をいつ確認したかを明記してください。 -
論文を読み、答えにくい質問の一覧を作ります。 限界、主張、実験の範囲、前提、割愛した内容、反論の履歴、不自然な数値、倫理、データの出所を洗い出します。完全なチェックリストと質問ごとの準備カードのテンプレートは、references/dreaded-questions.md を参照してください。確率 × ダメージで 8~15 個の質問に順位を付け、それぞれに誠実な回答カードを作成します。発表前に修正できる弱点があれば、その旨を伝えてください。リハーサルより修正を優先します。
-
一問ずつドリルを実施します。 ラウンド計画(ウォームアップ → 厳しい連続質問 → 答えにくい質問の最終ラウンド → 早押し質問 → 変化球)に従います。実際の論文やスライドに基づいて、それぞれのペルソナになりきって質問したら、ユーザーの回答があるまで待ってから次に進みます。質問一覧をまとめて提示してはいけません。ペルソナの話し方、追加質問の仕方、会場や状況に応じた調整については、references/audience-personas.md を参照してください。先行研究に関するルール:ドリルの質問で実在の論文を挙げる場合は、
find-papersとverify-citationsで確認済みの論文に限ります。それ以外は、論文名を挙げずに「先行研究で X が行われたと主張する人がいるとします」のようにします。引用を捏造してはいけません。 -
すべての回答をコーチングします。 ユーザーの回答ごとにペルソナを中断し、references/answer-coaching.md に従って、5 部構成のフィードバック(判定/うまくいった点/修正点を 1 つ/論文で裏付けられる情報のみを使った模範回答/不合格の場合は再ドリル)を行います。回答を先に述べるテンプレートを指導します。つまり、要点を述べる一文、根拠を 1 つ、そしてそこで止めます。厳しい不合格だった質問は後で再度尋ねます。回答は、2 回うまく答えられた時点で初めてドリル済みとします。
-
トランスクリプトを決定論的に採点します。 ステップ 1 のひな形にやり取り(ユーザーが実際に話した、または入力した回答)を記録し、次を実行します。
python3 scripts/grade_answers.py transcript.md --target 45 --max 75目標値はドリル計画に基づきます。各回答について、推定発話時間と目標/上限の比較、未回答の質問、曖昧な言い回しで始まる回答、フィラーの頻度、「はい/いいえ」で答える質問に対する結論の先送りをフラグとして示します。終了コード:0 は準備完了、1 は再ドリルが必要、2 は入力不正です。機械処理用の出力には
--jsonを指定してください。 -
準備状況レポートを作成します。 うまく答えられた質問、もう一度ラウンドが必要な質問(それぞれ修正点を 1 つ添える)、答えにくい質問の要点シート(質問 → 暗記する要点 → 数値を 1 つ)、および
make-slides/write-talk-scriptに差し戻す「スライド自体を修正」すべき項目をまとめます。
出力
対話形式のドリルセッションに加えて、最後に(チャット上に。ファイルへの書き込みはユーザーが求めた場合のみ)、grade_answers.py による採点済みトランスクリプトレポート、発表当日の朝に確認するための答えにくい質問の要点シート、再ドリルのリストを提示します。質問の予測はしません。ドリルで回答を練習することは準備であり、何を質問されるかを保証するものではありません。
専門分野に合わせる
聴衆の構成は、scripts/qa_drill.py の会場 family: フィールド(FAMILY_LINEUPS)に基づいて決まります。フォークして、あなたのコミュニティの聴衆(例:人文科学セミナーの参加者、臨床分野のグランドラウンドのパネル)と、新しいペルソナがあればそれらを PERSONAS および
references/audience-personas.md に追加してください。設定テーブル(SETTINGS)にも同じ方法で新しい形式を追加できます。
ガードレール
- 誠実な回答のみ。 制約や結果を隠したり、過小評価したり、誤って伝えたりする表現を決して助言しないでください。「Xを認めずに済む方法を教えて」という趣旨の依頼には応じず、認めたうえで範囲を明確にする回答を提案してください(こちらのほうが効果も高いです)。修正可能な弱点は、うまく切り抜ける練習ではなく、修正してください。
- 質問にもモデルの回答にも、引用を決して捏造しないでください。演習で先行研究に言及する場合は、
find-papersとverify-citationsを使うか、著者名などを挙げないでください。 - 論文が裏付けられない主張を、ユーザーの口から述べさせないでください。モデルの回答には、論文自体のエビデンスのみを使ってください。
- 発表枠やセッションの事実は、最新の会場ページで再確認してください(ステップ 2 は省略できません)。プロフィールには、発表枠に関する確定情報を記載しないでください。
- 論文は一時的に処理し、このリポジトリに論文のテキストを保存しないでください。
- ユーザーに代わって、セッション座長、委員会、投稿・会議システムに連絡しないでください。
- これはリハーサルであり、予言ではありません。練習で扱った質問が実際に聞かれると主張したり、発表の受け止められ方を予測したりしないでください。