ds-unstick について
ds-unstickは、修正が繰り返し失敗する場合に使う、開発者やコーディングエージェント向けのデバッグスキルです。試行を記録し、共通の前提を簡単な調査で検証してから、必要に応じて別の方法を選びます。
主な機能
- 01失敗した修正とエラーの記録
- 02試行に共通する前提の特定
- 03直接的な調査による前提の検証
- 04異なる方法のコストとリスクの比較
- 05調査結果の保存と検証の再開
活用シーン
- 01同じ修正が繰り返し失敗する原因の調査
- 02想定したファイルや設定の有効性確認
- 03複数の失敗後に別のデバッグ方法を選択
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ aicodeking/ deepseek-stack --skill ds-unstickインストール後、Claude Code で/ds-unstickを入力して読み込まれたか確認します。
詳細
ds-unstick
2 つの修正が同じように失敗する場合、問題はたいてい編集内容ではなく、誤った思い込みにあります。その思い込みを見つけて検証してください。
手順
- 編集を中断します。同じ修正の 3 つ目のバリエーションは試さないでください。
- 失敗した試行をそれぞれ 1 行で書き出します。変更内容と結果を記載してください。正確なエラーテキストも含めます。
- すべての試行に共通していた前提を書き出します。典型的な例:「このファイルが実行される」「設定が読み込まれている」「関数は文字列を受け取る」「キャッシュはクリアされている」「エラーは自分のコードに起因する」。1 つを選び、1 文で示します。
- はい/いいえで答えがわかる、最も手軽な調査方法でその前提を直接検証します。print 文、ログ行、
whichや--version、実際の呼び出し箇所を探す grep、最小限のスクリプト、またはインストール済みの正確なバージョンに対応するドキュメントの確認などが使えます。結果を貼り付けます。 - 前提が誤りなら、真の問題が見つかったことになります。新たにわかった事実に基づいて修正を計画します。
- 前提が正しければ、異なるアプローチを 3 つ挙げます。「異なる」とは、同じ編集への微調整ではなく、別の仕組み、ライブラリ、レイヤー、またはデータ経路を意味します。それぞれについて、コストとリスクを 1 行で示します。
- アプローチを 1 つ選び、その理由を 1 文で述べます。
- 失敗した試行の痕跡が残っている場合は、クリーンな状態から再開します。git(
git stashまたはgit checkout -- <files>)でそれらを元に戻し、選んだアプローチだけを適用します。 - 後のセッションで同じ試行が繰り返されないよう、誤った前提または選んだアプローチを PROGRESS.md に記録します(ds-context-reset を参照)。
- 新しいアプローチで ds-verify-loop に戻ります。
中止する条件
- 手順 4 の調査で失敗の原因が明らかになった場合、または新しいアプローチが検証に合格した場合。
- このスキルを 2 ラウンド実行しても失敗した場合は中止し、試したこと、検証した前提、得られた証拠をユーザーに報告します。指示を求めてください。
ルール
- 小さな変更を加えた場合も含め、すでに失敗した修正を繰り返さないでください。
- 推論より証拠を優先します。調査に 1 分かかるなら、実行してください。
- 失敗した試行の一覧は残してください。報告において最も役立つ情報です。
- 新しいアプローチを試す前に、クリーンな状態にしてください。古い編集によって結果がわかりにくくならないようにします。
コメント
Markdown 対応