consult について
予期しない障害に直面した際、重要な判断を行う前にユーザーへ相談するようエージェントに求めるスキルです。タスク、問題、判明事項、選択肢を整理し、判断事項と記録すべき後続作業を区別します。
主な機能
- 01重大な障害では作業を一時停止
- 02背景と判明事項を整理
- 03選択肢とトレードオフを提示
- 04延期する作業をバックログに記録
- 05結果を決定または質問として記録
活用シーン
- 01複数の実装案を比較
- 02計画上の動作を変える調整を評価
- 03新たな依存関係のリスクを検討
- 04後続作業を記録して取りこぼしを防止
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ davidlee/ doctrine --skill consultインストール後、Claude Code で/consultを入力して読み込まれたか確認します。
詳細
相談
ユーザーはアーキテクチャーや計画の順守について強いこだわりがあり、特にエージェントが相談なしに重大な決定や譲歩を行うことを非常に嫌います。
独断で進めてはいけません。
予期しない障害に遭遇した場合は、作業を止めて相談することを必ず検討してください。障害が次のいずれかに該当する場合:
- 計画されていた機能を変更する可能性のある調整が必要
- トレードオフが異なる複数の解決策がある
- 大幅な調査やデバッグが必要、または作業から逸れる
- 新たなインポートや結合要因の導入を示唆している
- ポリシー違反や教義上の曖昧さ(つまり異端。「/canon」を参照)のリスクがある
- 手抜きや省略をしたくなる
直ちに作業を止めてください。
状況を背景とともに提示してください。次の内容を要約します。
- 関連するタスクコード、計画、
design.md、または適用される教義 - 何をしようとしているか
- 障害の内容
- 関連する発見
- 選択肢や仮説
- 明らかなトレードオフ
そのうえで、先に進む前に指示を求めてください。
障害が、今すぐユーザーの判断を仰ぐ必要のある決定ではなく、先送りすべき潜在作業(後続作業、新たに見つかったリスク、雑務)である場合は、会話で失われないように backlog new で記録し、その旨を伝えてください。それは作業、知識、それとも決定ですか? 境界については lib:reference/using-doctrine.md を参照してください。
相談の結果は /knowledge に記録してください。解決済みのトレードオフは DEC、未解決のものは QUE とし、ブロックされている作業は自らをブロックする条件として指定します(doctrine needs <work> QUE-n)。
コメント
Markdown 対応