mcpField
W
When Stuck - Problem-Solving Dispatch

When Stuck - Problem-Solving Dispatch

github.com/obraエージェントワークフロー756526 回インストール54 週間前に更新
リポジトリ

When Stuck - Problem-Solving Dispatch について

よくある行き詰まりの症状に、デバッグや簡素化、並行調査などの手法を対応付ける問題解決スキルです。困難の種類に応じて、エージェントが次の手順を選ぶ際に役立ちます。

主な機能

  1. 01症状に応じた手法の選択
  2. 02指定された問題解決スキルへの振り分け
  3. 03必要に応じた手法の組み合わせ
  4. 04試した方法の記録

活用シーン

  1. 01失敗したテストの調査方法の選択
  2. 02増え続ける実装の複雑さへの対処
  3. 03複数の独立した問題の調査

インストール

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

$npx skills add https://github.com/obra/superpowers-skills --skill when-stuck---problem-solving-dispatch

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

詳細

行き詰まったとき — 問題解決の振り分け

概要

行き詰まりの種類によって、適した手法は異なります。このスキルは、どの問題解決スキルを使うべきかをすばやく見極めるのに役立ちます。

基本原則: 行き詰まりの症状に合った手法を選びます。

すばやく振り分ける

digraph stuck_dispatch {
    rankdir=TB;
    node [shape=box, style=rounded];

    stuck [label="You're Stuck", shape=ellipse, style=filled, fillcolor=lightblue];

    complexity [label="Same thing implemented 5+ ways?\nGrowing special cases?\nExcessive if/else?"];
    innovation [label="Can't find fitting approach?\nConventional solutions inadequate?\nNeed breakthrough?"];
    patterns [label="Same issue in different places?\nFeels familiar across domains?\nReinventing wheels?"];
    assumptions [label="Solution feels forced?\n'This must be done this way'?\nStuck on assumptions?"];
    scale [label="Will this work at production?\nEdge cases unclear?\nUnsure of limits?"];
    bugs [label="Code behaving wrong?\nTest failing?\nUnexpected output?"];

    stuck -> complexity;
    stuck -> innovation;
    stuck -> patterns;
    stuck -> assumptions;
    stuck -> scale;
    stuck -> bugs;

    complexity -> simp [label="yes"];
    innovation -> collision [label="yes"];
    patterns -> meta [label="yes"];
    assumptions -> invert [label="yes"];
    scale -> scale_skill [label="yes"];
    bugs -> debug [label="yes"];

    simp [label="skills/problem-solving/\nsimplification-cascades", shape=box, style="rounded,filled", fillcolor=lightgreen];
    collision [label="skills/problem-solving/\ncollision-zone-thinking", shape=box, style="rounded,filled", fillcolor=lightgreen];
    meta [label="skills/problem-solving/\nmeta-pattern-recognition", shape=box, style="rounded,filled", fillcolor=lightgreen];
    invert [label="skills/problem-solving/\ninversion-exercise", shape=box, style="rounded,filled", fillcolor=lightgreen];
    scale_skill [label="skills/problem-solving/\nscale-game", shape=box, style="rounded,filled", fillcolor=lightgreen];
    debug [label="skills/debugging/\nsystematic-debugging", shape=box, style="rounded,filled", fillcolor=lightyellow];
}

行き詰まりの種類 → 手法

行き詰まりの状況使用するスキル
複雑さが増大している - 同じことを5通り以上で実装し、特殊ケースが増えているskills/problem-solving/simplification-cascades
革新が必要 - 従来の解決策では不十分で、適切なアプローチが見つからないskills/problem-solving/collision-zone-thinking
パターンが繰り返される - 同じ問題が別の場所で起き、同じことを何度も作り直しているskills/problem-solving/meta-pattern-recognition
思い込みに縛られている - 「この方法でやるしかない」と考え、前提を疑えないskills/problem-solving/inversion-exercise
規模に不安がある - 本番環境で動くか? エッジケースが不明確か?skills/problem-solving/scale-game
コードが壊れている - 動作が間違っている、テストが失敗する、予期しない出力があるskills/debugging/systematic-debugging
独立した問題が複数ある - 調査を並行して進められるskills/collaboration/dispatching-parallel-agents
根本原因が不明 - 症状は明確だが、原因が隠れているskills/debugging/root-cause-tracing

手順

  1. 行き詰まりの種類を特定する - 上記のどの症状に当てはまりますか?
  2. 該当するスキルを読み込む - その手法の詳細を確認します
  3. 手法を適用する - 手順に従います
  4. それでも解決しない場合 - 別の手法を試すか、組み合わせます

手法の組み合わせ

複数の手法が必要な問題もあります。

  • 単純化 + メタパターン:パターンを見つけてから、すべての該当箇所を単純化します
  • 衝突 + 反転:比喩を強制的に当てはめてから、その前提を反転させます
  • 規模 + 単純化:極端なケースによって、何を取り除くべきかが明らかになります

覚えておくこと

  • 症状に合った手法を選ぶ
  • 一度に使う手法は1つ
  • 最初の手法でうまくいかなければ、組み合わせる
  • 試した内容を記録する

コメント