mcpField
Q
qwenchance

qwenchance

github.com/thananonエージェントワークフロー3.2k2.5k 回インストール19 週間前に更新
リポジトリ

qwenchance について

qwenchance は、長い複数ステップの作業を進めるためのスキルです。反復、考えすぎ、コンテキスト不足を検知し、方針変更や質問、作業の引き継ぎを促します。

主な機能

  1. 01ループと失敗の反復を検知
  2. 02思考を区切って行動を促進
  3. 03コンテキスト圧迫の兆候を確認
  4. 04ループを抜ける具体策を提示
  5. 05明確な引き継ぎを案内

活用シーン

  1. 01失敗したコマンドの再実行を回避
  2. 02調査が進まないときに方針を変更
  3. 03要件が曖昧な場合に確認を求める
  4. 04コンテキスト不足時に作業を引き継ぐ

インストール

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

$npx skills add https://github.com/thananon/9arm-skills --skill qwenchance

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

詳細

作業を軌道に乗せる

長い複数ステップの作業は、ループする、考えすぎる、コンテキストが尽きるという3つの原因で失敗します。各ステップの前に、以下のチェックリストを実行してください。該当する条件が発生したら、迷わず対応するアクションを実行してください。

各ステップの前に実行すること

確認項目次の場合に該当対応
ループしている?アクションを繰り返そうとしている(以下の兆候を参照)ループを断ち切る — 以下から修正方法を1つ選ぶ
考えすぎている?行動せずに約1000語を超えて考えているやめて、現時点で最善と考える判断に基づいて行動するか、ユーザーに質問を1つする
コンテキストに余裕がない?コンテキストが少ないことを知らせるリマインダーが表示された、または予算の兆候が2つ以上該当するこのステップを終えてから引き継ぐ

どれにも該当しなければ、ステップを実行してください。

1. ループ — 検知して断ち切る

次のいずれかに該当する場合、そのステップはループです。

  • このセッションですでに読んだファイルを再度読もうとしている(その後、変更されていない)。
  • 同じ引数でコマンドやツールを再実行し、同じ結果を期待している。
  • すでに試してやめた仮説に戻っている。
  • 新しい根拠なしに「最初から考え直している」。
  • 直近の2つのステップで新しい情報が得られていない。

直前に編集したファイルを読み返すのはループではありません。これは検証です。

ループが発生したら、停止し、次のうち1つだけを実行してください。

  1. 妨げとなっていることを1文で説明し、具体的な質問をユーザーにする。
  2. わかっていることとわかっていないことを書き出し、前回とは異なるアクションを実行する。
  3. 同じサブ問題で2回以上ループした場合は、現時点では解決できないと宣言し、先に進むか引き継ぐ。

失敗したアクションを、違う結果を期待して繰り返してはいけません。

再試行の上限: 同じ失敗するコマンドを3回目に実行してはいけません。コマンド、テストランナー、インポートなどを、約3回試しても(異なる方法を含めて)動作させられない場合は、停止してユーザーに尋ねてください。それ以上、試行錯誤を続けてはいけません。

内容を確認せずに編集しないでください — これがループの最大の原因です。編集前に、変更が正しいと判断できるだけの内容を読みましょう。編集のたびに、次のステップに進む前に検証してください(差分を読む/実行する/テストを実行する)。編集1回につき、確認は1回です。

2. 思考 — 範囲を定める

各ステップの思考は約1000語までにしてください。それを超えると、行動せずに考え込んでいる状態です。

  • 判断する → 行動する → 結果を確認する。すでに下した判断を再検討しないでください。
  • 約1000語で判断できない場合、タスクの指定が不十分です — 要点を絞った質問を1つ、ユーザーにしてください。
  • 問題全体を自分に言い直さないでください。結論を参照し、もう一度最初から考え直さないでください。

3. コンテキスト予算 — 推測せず、兆候を数える

最優先: コンテキストの不足や自動圧縮が近いことを知らせる <system-reminder> がある場合。→ 今すぐ引き継いでください(セクション4)。新しい作業を始めてはいけません。

それ以外の場合は、次のうち現時点で該当するものの数を数えてください。

  • タスクを開始してから、アシスタントのターンが20回以上ある。
  • 5個以上のファイル、または巨大なファイル/ログ/ダンプを1つ以上読んだ。
  • スクロールして何度も見返している長いツール出力がある。
  • 未完了の計画ステップが3つ以上ある。

該当する項目を数え、その数に応じて対応を決めてください。

  • 該当数が0または1 → 継続し、通常どおり作業する。
  • 該当数が2、3、または4 → 引き継ぎ — 現在のステップを終えてから、セクション4に進む。

まず数えてから判断し、感覚で決めないでください。該当数が多いほど、コンテキストへの負荷は大きくなります。最終ステップにいる場合や「もうすぐ終わる」場合でも、該当数は減らず、引き継ぎを取り消す理由にもなりません。

大きな読み込み、新しいサブタスク、長文の生成など、コストの高いステップの前に、次のように自問してください。「これを完了して、その後引き継ぐ余裕はあるか?」 該当数から引き継ぎが必要だとわかった場合は、現在の最小単位の作業を終えてから引き継いでください。次の作業を始めてはいけません。

4. スムーズに引き継ぐ

コンテキストに余裕がない場合、またはユーザーに求められた場合は、次の手順に従ってください。

  1. 永続する成果物を先に仕上げる — ファイルを保存し、コミットし、結果を書き込みます。何も失われないようにしてください。
  2. 会話を圧縮するために、handoff スキルを呼び出してください。引き継ぎ内容を自分で書いてはいけません。
  3. ユーザーに明確に伝えてください。「コンテキストに余裕がなくなってきたため、今から引き継ぎます。新しいセッションを開始してください(/clear)。」

コメント