Next Steps：ターンごとに出る Claude Code のプロンプト提案

Next Steps は、Hamza Zafar（hamzafer）による claude-code-mods コレクションの一部で、コミュニティ Mod です。Claude Code のプロンプト提案を行います。ターンが終わると、入力欄の上の帯に、次に入力しそうな短いプロンプトを 2〜3 件表示します。たとえば Claude がファイルを説明した後に Write a test for the login function を提案することがあります。

入力欄が空のとき、1、2、3 を押すと対応する提案が下書きとして入力欄に入り、0 でリストが閉じます。何も自動では送信されません。下書きを編集するか、Enter を押します。ターミナルが広ければ提案は 1 行に並びます（next: 1 ... · 2 ... · 0 dismiss）。1 行に収まらないときは提案ごとに 1 行ずつ使い、帯に使える行数が足りない場合は 1 行にして末尾を切り詰めます。

提案は、ターンの後に haiku モデルを 1 回呼び出して作られます。Claude が作業中のとき、アンケートが開いているとき、返答が 20 文字未満のとき、バックグラウンドエージェントがまだ実行中のときは、帯は表示されません。サブエージェントのターンは無視されます。作者の where-am-i Mod は共有フラグを読み取り、このリストが表示されている間は自分の "next" 部分を省きます。

録画では、小さなデモプロジェクトでこの Mod を読み込んだ Claude Code を起動し、Claude に src/login.js を読んで 2 文で説明するよう依頼します。ターンが終わると、入力欄の上に next: の帯が現れ、Add error handling for empty strings や Write a test for the login function などの番号付き提案が 3 件と、0 dismiss の表示が出ます。動画はこの画面でしばらく止まり、その後、空の入力欄で 1 を押すと、1 件目の提案が未送信の下書きとして入力欄に入ります。動画は早送りされているため、実際の待ち時間は見た目より短くなっています。

インストールブロックのいずれかの方法を使ってください。どれも作者自身のマーケットプレイスから直接インストールします。帯は次にターンが完了した後に表示されます。

Mod は現在のリストをホストが保持する $.state アトムに保存し、AbovePrompt の描画位置に、他の Mod の帯の下として表示します。キー処理のコードは hooks/register.tsx からの抜粋です。

on('prompt.edit', async ($, e, next) => {
  if (hasSurvey || !e.key || e.key.ctrl || e.key.meta || e.text !== '' || e.start !== 0 || e.end !== 0 || !/^[0-9]$/.test(e.inputText)) return next(e)
  const s = await read($, steps)
  if (!s) return next(e)
  if (e.inputText === '0') {
    await setSteps($, () => null)
    return { text: '', cursor: 0 } // consumed: the box stays empty
  }
  const pick = s.items[Number(e.inputText) - 1]
  if (!pick) return next(e)
  return next({ ...e, inputText: pick }) // a draft: the person edits it or presses Enter
})

turn.complete（メインエージェントのみ）で、suggest は maxTokens: 200 と 20 秒のタイムアウトで $.model.complete を呼び出します。モデルには、60 文字未満の命令形のプロンプトを 1 行に 1 件ずつ 2〜3 件返すか、NONE と返すよう求めます。その後 parseSteps が、コードフェンス、箇条書き記号、番号、引用符、エムダッシュを取り除き、前置きや 120 文字を超える行を破棄し（切り詰めず、破棄します）、重複を除いて、最大 3 件を残します。その間に新しいプロンプトや新しいターンが始まっていない場合にのみ結果が書き込まれるため、遅れて届いた応答が新しい状態を上書きすることはありません。prompt.submit と turn.start はリストを消去します。

/config にオプションはありません。動作を変えるには、register.tsx の先頭にある定数を編集します。MODEL（既定値は haiku）、MAX_ITEMS（3）、MAX_CHARS（60、モデルに求める長さ）、MAX_KEPT（120、残す最長の行）、MIN_ANSWER（20、呼び出しの引き金になる最短の返答）です。モデルへのリクエストの文言は、suggest の system と prompt の文字列にあります。

何かを実行する前に、プラグインが実行できるすべてのファイルを読みました。.claude-plugin/plugin.json、hooks/hooks.json、hooks/register.tsx（唯一のモジュール）、型宣言、テストです。package.json、インストールスクリプト、バイナリ、バンドルまたは圧縮されたコードはなく、プラグインのフォルダー外から読み込まれるものもありません。

• モデル呼び出し。 メインエージェントのターンが完了するたびに、suggest は $.model.complete を通じて、直近のセッションメッセージ最大 6 件（各 800 文字まで）と最新の返答（2,000 文字まで）を haiku モデルに送ります。これは他のモデル呼び出しと同様にあなたの Claude Code アカウントを使い、Mod が他のネットワーク接続を開くことはありません。送られるのはセッションの内容なので、あなたと Claude が話した内容が含まれる可能性があります。
• プロンプトのテキスト。 Mod がモデルに渡す指示は、読みやすい普通の文字列です。あなたのプロンプトや Claude のコンテキストには何も注入しません。モデルの出力は下書きとして入力欄に入るだけで、送信するのはあなた自身です。提案はトランスクリプトから作られるため、Claude が読んだファイル内のテキストが提案内容に影響する可能性はありますが、送信前に目にすることになります。
• キーとプロンプトのフック。 prompt.edit は、空の入力欄に入力された数字を提案テキストに置き換えるか、0 を消費します。prompt.submit はリストを消去してプロンプトをそのまま渡すだけです。claude plugin validate は prompt.submit を .catch のないゲーティングフックとして記録していますが、プロンプトをブロックしたり書き換えたりすることはありません。
• それ以外はなし。 コマンドを実行せず、ファイルの読み書きもせず、設定、シェルファイル、デーモンには触れず、環境変数も読まず、テレメトリもありません。状態はホストがメモリ上で保持します。ライセンスは MIT で、リポジトリに LICENSE ファイルがあります。

claude plugin validate はエラーも警告も報告せず、作者の 16 件のテストは Claude Code 2.1.291 ですべて通りました。

macOS 上の Claude Code 2.1.291 で確認しました（validate、テスト、デモの録画）。提案が表示されない場合：

• 直前の返答が非常に短い（20 文字未満）か、モデルが付け加えるべき内容を思いつかなかった。
• バックグラウンドエージェントがまだ実行中で、メインエージェントが作業を再開するまで呼び出しは待機します。
• Claude がまだ作業中か、入力欄の上でアンケートが開いている。帯はターンが終わると表示されます。
• 入力欄にテキストがある状態で数字を押したか、数字を貼り付けた。数字は入力欄が空のときだけ動作します。
• プロンプトを送信したか新しいターンを始めた。ターンが終わるまでリストは消えたままです。