Communityコーディング&開発github.com

chunyun1998-sudo/step-by-step-ask

逐个提问式需求沟通 Skill:先问清楚再执行 / ステップバイステップの要件ヒアリングスキル

step-by-step-ask とは?

このスキルは、AIエージェントに対して「まず要件を明確にしてから実行する」という対話フローを強制します。ユーザーが「一步一步来(一歩ずつ進めて)」「別急,先問清楚(慌てずに、まず確認して)」などのキーワードを発した場合、AIは即座に質問モードに移行し、1ターンに1つの質問だけを行い、情報を順次収集します。すべての必須情報が揃った後、AIはユーザーに理解内容を復唱し、明示的な確認を得てから初めてタスクの実行を開始します。一度に複数の質問をしたり、確認なしで実行を開始したりすることは禁止されています。このスキルは、CursorやCodexなどのAIエージェントプラットフォームに適しており、特に複雑な要求や誤解を避けたい場合に有効です。

対応~Claude Code~Codex CLI~Cursor
npx skills add chunyun1998-sudo/step-by-step-ask

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ステップバイステップの質問 — 逐次質問による要件ヒアリング

いつ呼び出すか

ユーザーが次のキーワードまたは類似の表現を発した場合、直ちに質問モードに入らなければなりません:

  • 「一步一步来」(一歩ずつ進めて)
  • 「別急,先問清楚」(慌てずに、まず確認して)
  • 「一步步来」(段階的に)
  • 「慢点,先搞清楚」(ゆっくり、まずはっきりさせて)
  • 「先問清楚」(まず確認して)
  • 「別急」+「問清楚」(慌てるな+確認しろ)の組み合わせ
  • その他、「急いで実行せず、まず要件を明確にしろ」という意図の表現

目標

逐次質問を通じて、タスクの実行に必要なすべての情報を完全に収集します。これにより、AIが着手する前にユーザーの要件を完全に理解し、方向性の誤りや手戻りを防ぎます。

基本ルール

一、毎回1つの質問だけを行う

  • AIは毎ターン、ユーザーに1つの質問のみを投げかけます
  • 複数の質問を一度に提示してユーザーに選ばせたり答えさせたりしてはいけません
  • 質問は具体的、明確で、現在の情報のギャップに向けたものでなければなりません

二、回答に基づいてさらに質問を続ける

  • ユーザーの回答を聞いた後、まだ必要な情報を判断します
  • 情報が不足していれば、次の質問を続けます
  • 質問の流れは自然で、会話のように行い、アンケートのようにしないでください

三、いつ質問を止めるかを知る

次の条件がすべて満たされた場合に質問を停止します:

  • AIがユーザーの目標と意図を完全に理解した
  • タスクの実行に必要なすべての重要な情報を収集した
  • 方向性の誤りを引き起こす可能性のある重大な情報ギャップが存在しない

四、復唱確認後に実行する

  • 質問終了後、AIは必ずユーザーに要件の完全な理解を復唱しなければなりません
  • 復唱には次を含める: 目標、範囲、重要要件、制約条件、成果物の期待
  • ユーザーが明確に確認(「そうです」「問題ない」「大丈夫です」など)した後にのみ、実行を開始します
  • 復唱の一部をユーザーが訂正した場合、AIは理解を更新し、再度確認を行います

ワークフロー

ユーザーがキーワードを発する(例: 「一步一步来」)
  ↓
① 質問モードに入り、現在の既知情報に基づいて最初の質問をする
  ↓
② ユーザーの回答を聞き、情報の完全度を評価する
  ↓
③ 情報不足?→ ①に戻り、次の質問をする
   情報十分?→ ④に進む
  ↓
④ ユーザーに要件の完全な理解を復唱する
  ↓
⑤ ユーザー確認?→ 実行を開始する
   ユーザー訂正?→ 理解を更新し、④に戻って再度復唱する

禁止行為

  • 一度に複数の質問を投げかけることを禁止
  • 情報が完全に収集される前にタスクの実行を開始することを禁止
  • 復唱確認ステップをスキップして直接実行することを禁止
  • 質問中にユーザーに代わって仮定を置いたり、情報ギャップを自分で埋めたりすることを禁止(仮定が必要な場合は、復唱段階で明確にマークし、ユーザーに確認させること)

使用例

ユーザー: 「別急,先問清楚,我要你帮我写一篇公众号文章」(慌てずに、まず確認して。WeChat公式アカウントの記事を書いてほしい)

AIの対応:

  1. 質問モードに入り、最初の質問をする: 「この記事のテーマやトピックの方向性は何ですか?」
  2. ユーザーが答えた後、さらに質問する: 「ターゲット読者は誰ですか?それともあなたの公式アカウントの通常の読者ですか?」
  3. 段階的に情報を収集した後、復唱する: 「理解しました。あなたはXXというテーマについて、ターゲット読者がXX、長さがXX字程度、重点はXX、避けるべきはXXといった、カズキ風のWeChat公式アカウント長文記事を作成したいのですね。合っていますか?」
  4. ユーザーが確認してから書き始める。

ユーザー: 「一步一步来,帮我做一个数据报表」(一歩ずつ進めて、データレポートを作ってほしい)

AIも同様に質問モードをトリガーし、データソース、フォーマット、時間範囲、主要指標などを一つずつ確認する。

関連スキル