jpskill.com
🛠️ 開発・MCP コミュニティ

interactive-bug

ユーザーが不具合を報告した際に、UIやAPI、データなどのエラーや予期せぬ動作について、質問を重ねて原因を特定し、修正を支援するSkill。

📜 元の英語説明(参考)

Diagnosticar y corregir bugs con preguntas adaptativas usando `question` (multiple choice + respuesta libre). Usar cuando el usuario reporta que algo no funciona, hay errores en UI/API/datos o comportamiento inesperado, especialmente con poco contexto inicial.

🇯🇵 日本人クリエイター向け解説

一言でいうと

ユーザーが不具合を報告した際に、UIやAPI、データなどのエラーや予期せぬ動作について、質問を重ねて原因を特定し、修正を支援するSkill。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o interactive-bug.zip https://jpskill.com/download/10601.zip && unzip -o interactive-bug.zip && rm interactive-bug.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/10601.zip -OutFile "$d\interactive-bug.zip"; Expand-Archive "$d\interactive-bug.zip" -DestinationPath $d -Force; ri "$d\interactive-bug.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して interactive-bug.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → interactive-bug フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

インタラクティブなバグ修正ツール

目的: 最小限のやり取りで、一度の試行でバグを解決するのに十分なコンテキストを得ること。

運用プロトコル

  1. バグを迅速に分類する
  • UI/UX
  • API/backend
  • データ/状態
  • インフラ/設定
  1. 質問の第1ラウンドを実行する (必須、questionを使用)
  • 1回のquestion呼び出しで2〜4つの質問をする
  • 選択肢のある質問（クローズド）と自由記述の質問（オープン）を混ぜる
  • 診断価値の高い質問を優先する
  1. 3つの箇条書きで理解を確認する
  • 観察された問題
  • 期待される動作
  • 初期仮説
  1. 短い確認を求める
  • 「この要約は問題をうまく表していますか？」
  • そうでない場合は、短い第2ラウンド（最大2つの質問）を行う
  1. 調査と修正
  • 関連するコードを読む
  • 根本原因を見つける
  • 最小限かつ安全な修正を適用する

質問の設計

  • 予測可能な回答がある場合は、選択肢を使用する。
  • 具体的な詳細が不足している場合は、自由記述を使用する。
  • ユーザーがすでに提供した情報を繰り返さない。
  • 覚えておくこと: questionには、独自の回答を記述するオプションがすでに含まれている（「その他」を追加しない）。

タイプ別のテンプレート

UI/UX

  • クローズド: 「どこで発生しますか？」（header、modal、tabla、formulario、otro）
  • オープン: 「何が起こるはずで、実際に何が起こりますか？」
  • クローズド: 「コンソールにエラーが表示されますか？」（si/no/no se）

API/backend

  • クローズド: 「どのように失敗しますか？」（timeout、4xx/5xx、respuesta invalida、intermitente）
  • オープン: 「status/mensaje/stack traceを貼り付けてください」
  • クローズド: 「以前は機能していましたか？」（si/no/no se）

データ/状態

  • クローズド: 「何が失敗しますか？」（no guarda、guarda mal、no lee、inconsistente）
  • オープン: 「影響を受けるデータの具体的な例を挙げてください」
  • クローズド: 「常に発生しますか、それとも特定のケースで発生しますか？」

厳守すべきルール

  1. 質問にはquestionを使用し、プレーンテキストは使用しない。
  2. 1ラウンドあたり最大4つの質問、合計2ラウンド。
  3. 重要なデータが不足している場合は、少なくとも1つの自由記述の質問を含める。
  4. 十分なコンテキストがある場合は、質問をスキップして調査に進む。
  5. 最小限の変更で修正する。必要がない限りリファクタリングしない。

期待される最小限の出力

編集前:

  • 可能性の高い根本原因
  • 触るべきファイル
  • 修正戦略（1〜3行）

編集後:

  • 簡単な言葉で修正を説明する
  • 変更がなぜバグを解決するのかを示す
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Interactive Bug Fixer

Objetivo: obtener contexto suficiente para resolver el bug en un solo intento, con minimo ida y vuelta.

Protocolo operativo

  1. Clasificar rapido el bug
  • UI/UX
  • API/backend
  • Datos/estado
  • Infra/config
  1. Ejecutar ronda 1 de preguntas (OBLIGATORIO con question)
  • Hacer 2-4 preguntas en un unico llamado a question
  • Mezclar preguntas cerradas (opciones) y abiertas (texto libre)
  • Priorizar preguntas de alto valor diagnostico
  1. Confirmar entendimiento en 3 bullets
  • Problema observado
  • Comportamiento esperado
  • Hipotesis inicial
  1. Pedir confirmacion corta
  • "¿Este resumen representa bien el problema?"
  • Si no, hacer una segunda ronda breve (maximo 2 preguntas)
  1. Investigar y corregir
  • Leer codigo relevante
  • Encontrar causa raiz
  • Aplicar fix minimo y seguro

Diseno de preguntas

  • Usar opciones cuando hay respuestas previsibles.
  • Usar abiertas cuando falta detalle especifico.
  • No repetir informacion que el usuario ya dio.
  • Recordar: question ya incluye opcion de escribir respuesta propia (no agregar "Otro").

Plantillas por tipo

UI/UX

  • Cerrada: "¿Donde ocurre?" (header, modal, tabla, formulario, otro)
  • Abierta: "¿Que deberia pasar y que pasa realmente?"
  • Cerrada: "¿Ves errores en consola?" (si/no/no se)

API/backend

  • Cerrada: "¿Como falla?" (timeout, 4xx/5xx, respuesta invalida, intermitente)
  • Abierta: "Pega status/mensaje/stack trace"
  • Cerrada: "¿Antes funcionaba?" (si/no/no se)

Datos/estado

  • Cerrada: "¿Que falla?" (no guarda, guarda mal, no lee, inconsistente)
  • Abierta: "Da un ejemplo concreto de dato afectado"
  • Cerrada: "¿Pasa siempre o con ciertos casos?"

Reglas duras

  1. Usar question para preguntar, no texto plano.
  2. Maximo 4 preguntas por ronda y 2 rondas totales.
  3. Incluir al menos 1 pregunta abierta si faltan datos criticos.
  4. Si hay contexto suficiente, saltar preguntas y pasar a investigacion.
  5. Arreglar con cambio minimo; no refactorizar sin necesidad.

Salida minima esperada

Antes de editar:

  • Causa raiz probable
  • Archivos a tocar
  • Estrategia de fix (1-3 lineas)

Despues de editar:

  • Explicar fix en lenguaje simple
  • Indicar por que el cambio resuelve el bug