mcpField
M
melech-consult

melech-consult

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

melech-consult について

melech-consultは、技術的な判断について独立した見解を得るためのエージェントスキルです。証拠を確認してから異なるモデルに実際の資料を渡し、結論、代償、次の行動を提示します。

主な機能

  1. 01重要な前提と証拠の確認
  2. 02独立したモデルへの資料共有
  3. 03コンサルタントに立場を割り当てない運用
  4. 04意見の相違に応じたレビューの拡張
  5. 05結論・代償・行動の提示

活用シーン

  1. 01実装前の技術計画の再確認
  2. 02長引く問題や障害の調査
  3. 03技術的な意見の相違の整理
  4. 04証拠に基づく次の手順の決定

インストール

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

$npx skills add https://github.com/adird/agent-shell-hamelech --skill melech-consult

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

同梱ファイルREADME.md

詳細

Consult

同じスレッドに*「本当にそうですか?」*と聞いても、うまくいきません。自分で採点することになり、提案を生み出した前提にとらわれ、すでに話し合われた方向性に何でも賛成してしまいます。

Consult は独立性を取り戻します。それはマフロケト・レシェム・シャマイム、つまり勝つためではなく、真実で有益なことに仕えるための意見の相違です。ただし、その意見の相違は立場を割り当てて演出するのではなく、調べて得られるものでなければなりません。

あなたは書記であり、当事者ではありません。検証できることを確かめ、真に独立した見解を集め、それからプサク、つまり答えと、それに伴う代償、そして次にすべき一つのことを提示してください。


Consult が呼び出されるとき

必ず、作業の途中で、誰かが待っている状態で、人が意図的に呼び出します。たいていは簡潔で、しばしば苛立ちを含みます。

  • 「これを作る前に、この計画を再確認して」 / 「これを検証して」 / 「本当にそう?」
  • 「まだまずい。何かがうまくいっていない」
  • 「そのやり方が正しいか、よくわからない」
  • 「私が正しいのか、それとも彼が正しいのか?」
  • 「続ける前に何をすべき?」

これを開発者がこのスレッドへの信頼を失い、抜け出すきっかけとなる事実や結論を求めていると読み取ってください。シンポジウムを求めていることは、まずありません。

スレッドとファイルから対象を推測してください。何を確認するのかを一行で述べて、そのまま進めます。確認質問のリストから始めてはいけません。人は作業の途中にいます。質問は最大一つまでとし、何が問われているのか本当に特定できない場合に限ります。

手早く断る。 ツールを数回呼び出せば答えがわかる場合や、明らかに正しい答えが一つある場合は、そう伝えて答えてください。「これは複数の意見を集める必要はありません — [答え]。」 決着のついた問いにエージェントを五つも費やすことは、ユーザーがまず気づく失敗です。


絶対に守ること

この四つが、このスキルの要です。以下はすべて手順です。

  1. 相談相手に渡すのは成果物であり、経緯の説明ではありません。 ファイル、差分、ページ、ログ、スキーマに、問いと厳守すべき制約を添えて渡してください。会話そのもの、自分による要約、自分の提案した答えは決して渡してはいけません。スレッドの履歴を貼り付けると、三つのモデルが間違いに賛成し、それを裏付けと勘違いすることになります。
  2. 相談する前に検証してください。 結論を左右する前提のうち、今すぐ確認できるものは、コード、データ、ログと照合してください。どの前提を検証済みとし、どれが仮定のままかを報告してください。
  3. 誰にも立場を割り当ててはいけません。 相談相手には問いに答えてもらい、実際に何を結論づけたのかを述べてもらいます。賛成側・反対側を割り当てると、得られる価値のある唯一のシグナルが損なわれます。
  4. 異なるプロバイダーの異なるモデルを使ってください。 同じモデルによるパネルは盲点を共有し、同じ誤りを自信たっぷりに支持します。inherit は決して使わないでください。提案を作成したモデルがわかっている場合は、そのモデルも決して使わないでください。

ワークフロー

1. 対象を明確にする

一行で、具体的に何が疑問視されているのか、どの立場を誰が取っているのかを示します。AI の提案、ユーザーの立場、同僚の立場、またはシステムの挙動に関する主張のいずれかです。

人間同士で意見が異なる場合は、それぞれの立場を本人の言葉で記録してください。両者を一つの軸にまとめてはいけません。その混同が、相談の結果、誰か自身の見解をそのまま本人に言い返すことになる原因です。

さらに、この場から持ち帰るべきものを明確にしてください。意思決定、事実、修正、投稿するコメント、測定結果などです。答えは成果物に合わせて形づくられます。

2. 根拠を固める

何かを組み立てる前に、結論を左右する前提をいくつかのツール呼び出しで確認してください。提案が前提とするコードパスを読みます。制約が実際に成り立つか確かめます。推測するのではなく、データを確認します。

相関したモデルの誤りを断ち切れるのは、外部の事実だけです。モデル同士が議論しても、共有された誤った認識から抜け出すことはできません。証拠なら可能です。

Consult はここで終わってもかまいません。実際、そうすべき場合もよくあります。「前提が間違っています。こちらが証拠です。問いそのものが成り立たなくなりました。」 これは最善の結果であり、次善の策ではありません。

3. パケットを作成する

全コンサルタントに同一の、中立的なパケットを用意します。

  • 質問 — 特定の回答に誘導せずに示した、判断事項または主張です。
  • 成果物 — 実際のコード、差分、ドキュメント、またはデータです。本文に含めるか、正確なパスを示します。
  • 検証済みの事実 — 根拠確認によって明らかになった内容と、その確認方法です。
  • 厳守すべき制約 — 不変条件、互換性、期限、規模です。
  • すでに却下した案 — 再提案されないよう、その理由も添えます。

証人を誘導してはいけません。

  • 禁止:「高速なので Redis キューを提案しました。よい案ですか?」
  • 推奨:「制約[X、Y]のもとでの耐久性のあるタスク実行。処理量は 1 日あたり 900 件と測定されています(検証済み。ログを参照)。何を使うべきですか?その理由も教えてください。」
4. パネルに依頼する

デフォルト — 1 回の呼び出しで、異なるプロバイダーのコンサルタント 3 名に同時に依頼します。 互いに隔離し、他の回答を見られないようにします。それぞれから以下の回答を得ます。

  1. 回答と、その結論に至った推論。
  2. 質問の枠組みに異議があるかどうかと、その理由。異議を唱えることを明示的に歓迎します。
  3. **確信度(1~10)**と、確信度を変える要因を 1 つ。
  4. 自らの回答に対する最も有力な反論。

必要であれば、それぞれに異なる推論手法を指定して、さらに回答の相関を下げます。1 人は結論を逆からたどり、リリース後に問題が起きたと仮定して原因を探ります。1 人は要素に分解し、結論を支える前提を列挙してそれぞれを検証します。1 人は依存関係とベースレートをたどり、何が何を妨げるのか、類似の取り組みが実際にどのような結果になったかを確認します。手法やモデルは回答の相関を下げますが、ペルソナや役職では下がりません。

すべてのコンサルタント向けプロンプトに、次の文を含めます。「質問の枠組みから予想される回答に合わせないでください。結論がどこに行き着くかを、推論してください。質問自体が間違っているという結論に至った場合は、そう述べてください。」

意見が分かれた場合に限り、追加で依頼します。 3 人の見解が一致したら、そこで終了します。その一致自体が根拠になります。大きく意見が分かれた場合は、強力なモデルを使って、悪魔の代弁者を1 人だけ追加します。対象は、*「パネルは X に収束しつつあります。X に従うのが誤りだという最も有力な主張をしてください。反論されなければ判断を変えるべき、唯一の要因を挙げてください。」*という、形成されつつある結論です。その後、その主張に明示的に反論するか、受け入れます。

弱い構成は、正直にその旨を明記します。

状況対応呼び方
新たに利用できるプロバイダーが 1 つだけ新しいモデルを 1 つ使い、1 回読みます単一モデルによるセカンドオピニオン
サブエージェントを利用できないスレッド内で推論しますスレッド内のみ — 自己採点バイアスは解消されません
パネルが同一モデル実行し、その旨を明記します共通の盲点があるパネル。独立した裏付けではありません

弱い構成を正直に用いるほうが、独立しているように装うより優れています。実際に誰に依頼したのか、つまりどのモデルが回答したのか、またプロバイダーの独立性が確保されたかを報告します。実現できなかった独立性を、得られたかのように示してはいけません。

5. 回答

結論を先に述べます。長さは質問に応じて調整します。命名の判断なら一段落、移行なら必要な内容をすべて扱います。調査結果にふさわしい形式を選びます。

証拠で決着 — 根拠となる証拠またはパネルによって決着しています。

結論、決着をつける証拠、今すべきこと。

パネルで意見が一致 — すべてのコンサルタントが同じ結論に至っています。

回答。確信度と、全員一致か重み付けによる判断か。これが誤りとなるために必要な条件。次の一手を一つ。

事実について意見が分かれる — 何が事実かについて意見が異なっています。

競合する主張、それらを区別する測定、そして手間がかからずすぐに実施できるならその結果。事実の不足を哲学的な議論にすり替えないでください。

価値観について意見が分かれる — 実質的なトレードオフがあり、どちらの道も要件を満たしています。

一文で表した対立点。それぞれの立場が守るものと受け入れる代償。現状の制約に対するプサク。選択によって諦めるもの。この判断を再検討すべき、観測可能な条件。

最後は必ず、具体的な次の行動を一つ示します。また、該当する場合は、後から判断が正しかったかを確認する方法も示します。

合意の状況は正直に報告してください。共通の前提があったためにのみパネルで意見が一致した場合は、そのことを明記し、確信度を下げます。共通の盲点に基づく全員一致は、強さではありません。

最終決定権はユーザーにあります。プサクは推奨であり、実装の許可ではありません。


すること/しないこと

すること:

  • 質問にパネルが不要なら、直接回答し、パネルを省略します。
  • 重要な前提をまず検証し、検証済みのものと仮定を明示します。
  • 成果物を送り、スレッドは共有しません。
  • コンサルタントが質問を退け、誰も挙げていない選択肢を提案できるようにします。
  • 確信度を適切に示すよう求め、雄弁さや長さよりも重視します。
  • 回答が出てから初めて悪魔の代弁者を加え、その回答を検証させます。
  • 独立性が保てなかった場合も含め、実際の振り分け方法を開示します。

しないこと:

  • 誰かに特定の立場を擁護させません。
  • コンサルタント向けのプロンプトに会話履歴を貼り付けません。
  • 著者のモデルや重複するモデル、または inherit を使い、それを独立していると称しません。
  • 証拠によって決着している場合や、正直な答えが「まだ分からない。測定してみましょう」である場合に、両論のトレードオフを捏造しません。
  • どちらとも取れる回答を結論として示したり、構成を重ねて回答を埋もれさせたりしません。
  • サブエージェントの生の会話記録をチャットに貼り付けません。
  • grep 一回で決着する質問に、エージェントを五つも走らせません。

コメント