mcpField
A
agent-interview

agent-interview

github.com/scrollmarkエージェントワークフロー1644 回インストール1 日前に更新
リポジトリ

agent-interview について

agent-interviewは、明確な選択肢と回答確認を軸に、エージェントによる聞き取りを構成するスキルです。質問ラウンド、既定値、回答の読み返し、重要な操作前の段階的な説明方法を定めています。

主な機能

  1. 01選択肢を明示した質問
  2. 02ネイティブ、MCP、番号付きの質問形式
  3. 031ラウンドを4問以内に制限
  4. 04既定値と未回答の選択肢を明確化
  5. 05重要な操作の前に回答を読み返す
  6. 06試行と確認を伴う一段階ずつの説明

活用シーン

  1. 01費用のかかる操作の前に要件を収集
  2. 02複数質問で曖昧な回答を明確化
  3. 03タスクを一段階ずつユーザーに案内

MCP 対応

問題用MCPが登録されている場合に利用できます。このスキル自体がMCPサーバーを提供するとの説明はありません。

インストール

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

$npx skills add https://github.com/scrollmark/social-skills --skill agent-interview

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

詳細

エージェントへのインタビュー

インタビューはプロトコルであり、たまたま質問をしているだけの会話ではありません。 一度に一つの判断を行い、選べる実際の選択肢を提示し、対象ごとに一貫した名前を使い、費用のかかる作業に入る前に回答を読み返します。自由回答式の質問には曖昧な回答が返り、その曖昧な回答は後から具体的な内容へと、気づかれないまま作り変えられます。

質問する

選択式の質問をします。名前の付いた選択肢がある、実際に選べる質問です。ホストが提供する中で、最も上位の方法を使います。

  1. ネイティブの質問ツール（例：AskUserQuestion）。最適です。ユーザーが選択でき、「その他」も常に自由記述に使えます。
  2. 質問用の MCP（登録されている場合）。同じように選択でき、ネイティブの選択 UI は不要です。
  3. メッセージ内の番号付き選択肢。以下のフォールバックです。失敗ではなく、実際に使える方法です。

4 つ目の方法はありません。別の方法を考え出す前に、その理由を把握してください。シェルにはターミナルが接続されていません。tty も stdin もありません。read はすぐに戻るため、プロンプト用スクリプトは停止するか、誰も選んでいないデフォルトを黙って採用します。

番号付きのフォールバック

一度に 1 ラウンドずつ質問し、そのラウンドの質問をすべて 1 つのブロックにまとめます。ラベルはラウンド全体で重複しないようにします。

**Q1. Which filing status?**  (pick one · default: a)
   a) Single   b) Married filing jointly   c) Head of household
**Q2. Which apply to you?**  (pick any · default: none)
   a) Dependents   b) Self-employed income   c) Rental income

Reply like `1a 2c`, or say it in words. Anything the options miss, say
plainly and it goes in as-is.

以下の各ルールがあるのは、緩い運用では特定の問題が起きるためです。

  • 質問ごとではなく、ラウンド全体でラベルを付けます。 Q1／Q2 と a／b／c を組み合わせれば一意に判別できますが、質問ごとに 1) 2) 3) とすると、ラウンドに質問が 2 つあるだけで「2 つ目のもの」が曖昧になります。
  • 各質問に、1 つ選択か複数選択かを明記します。 明記しないと、複数選択の回答が 1 つの選択だと解釈され、追加の選択が気づかれないまま無視されます。
  • 各質問にデフォルトを指定します。 デフォルトを適用できるのは、ラウンド内の他の質問には回答があり、その質問だけが明確にスキップされた場合に限ります。ラウンド全体が無回答でも、同意したことにはなりません。
  • 未回答の質問を推測で補わないでください。 3 つの質問があるラウンドで「そうですね。1 つ目がよさそうです」と言われても、回答されたのは 1 つだけです。その質問だけをもう一度尋ねます。
  • 時間や費用がかかる作業、取り消しにくい作業を始める前に、回答を読み返します。 読み返しは 1 行で、すべての回答を含めます。読み違いの修正がまだ無料でできるうちに行います。
  • 1 ラウンドの質問は 4 つ以下にし、自由記述の選択肢も用意します。 長いラウンドは一部しか回答されず、このプロトコルが防ごうとしている問題につながります。

共通の用語

最初のメッセージを送る前に、動く要素ごとにユーザー向けの名前を決め、その後は別の名前を付けないでください。1 つのものに 2 つの名前を教えられた人は、それらを別物だと思い、答えのない質問をすることになります。何から作られているかではなく、その手順がユーザーに何をするのか（「回答を確認する」など）を名前にします。何を使って動作するのか聞かれたら、正直に答えます。仕組みを先回りして説明せず、隠しもしません。

進めながら教える

1 つのメッセージにつき、手順は 1 つだけ提示します。 手順全体を 1 つのブロックに貼り付けると、チャットにたまたま載っただけの文書になります。誰も途中を読まず、練習もせず、何が伝わったかを知ることもできません。全体の計画は自分の中で立て、まずは 1 つの段階だけを示します。各手順には、ユーザーが実際に実行または発言する TRY が必要です。これがなければ、その手順は講義にすぎません。また、先に進む前に実際の選択式の質問として尋ねる CHECK も必要です。答えが間違っている、または回答がない場合は、先に進まず教え直します。入手方法を説明する前に、すでに持っているものを確認します。

アンチパターン

  • 5 つの質問を 1 つの段落に詰め込み、回答を期待する
  • 「うまくいきますか？」だけを尋ねる。はいという回答を誘い、何も確認できない
  • 回答を読み返す前に、費用のかかる作業を始める
  • ツールの出力で別の言葉が使われたからといって、インタビューの途中で名前を変える

コメント

Markdown 対応