AgentSkillsCN

agent-consultation-workflow

通过向外部AI(如子代理或Copilot等)咨询,以消除疑问的流程型技能。整理背景信息、AI代理的身份定位、待确认的论点以及各项约束条件,一次性生成完整的问题集,避免反复提问,最终高效达成结论。当规格模糊、需要比较多个方案、或缺乏一手资料时,可使用此技能。但切勿用于闲聊或显而易见的问题。

SKILL.md
--- frontmatter
name: agent-consultation-workflow
description: 不明点を外部AI(sub-agentやcopilotなど)への照会で解消するためのワークフロースキル。背景情報、AI Agentとしての立場、確認したい論点、制約を整理して一括質問を作成し、質問返しを避けて結論まで回収する。仕様が曖昧なとき、複数案の比較判断が必要なとき、一次情報が不足しているときに使用する。単なる雑談や自明な質問には使用しない。

外部AI照会ワークフロー

Overview

このskillは、外部AI照会を場当たりで行わず、背景付きで一回の問い合わせで結論を回収するための標準手順を提供する。
回答は常に「結論・根拠・代替案・リスク・信頼度」を回収する。

照会前チェック

次のどれかに該当する場合のみ照会する。

  • 仕様や要件に未確定がある
  • 実装方針が2案以上あり判断が割れる
  • 手元情報だけでは確信度が低い

該当しない場合は照会せずに通常実装を進める。

フェーズ1: 不明点の定義

  1. 不明点を1文で定義する
  2. 決めるべき意思決定を1つに絞る
  3. 照会先の候補を決める(sub-agent / copilot / 他)

出力:

  • question_focus
  • decision_needed
  • target_agent_candidate

フェーズ2: モデル選定

references/model-selection.md を読み、照会対象に応じてモデルを選ぶ。

  • 既定: Codex系の最新モデルを優先
  • Codexで詰まる場合: claude-opus-4.6 へ切り替える
  • 速度重視の当たり付け: 軽量モデルを優先
  • 迷う場合: primary 1つ + challenger 1つで2本照会

チャネル選択ルール:

  • preferred_model が Codex 系 (gpt-*-codex) の場合: target_agent = sub-agent
  • preferred_model が Opus/Sonnet/Gemini など Copilot 経由モデルの場合: target_agent = copilot
  • 2モデル比較時は primary を先に実行し、必要時に challenger を実行する

出力:

  • preferred_model
  • challenger_model(必要時)
  • selection_reason
  • target_agent

フェーズ3: 背景パッケージ作成

references/query-template.md を使って、次を必ず埋める。

  • 自分がAI Agentであること
  • 現在の作業背景
  • 既存の前提と制約
  • 今回確認したい論点
  • 必要な回答形式

必須ルール:

  • 質問返しを禁止する
  • 不足情報があっても仮定を明示して結論まで返すよう要求する

フェーズ4: 一括照会

照会文には次の指示を含める。

  • 質問は返さずに、合理的な仮定を置いて結論まで回答してください
  • 回答は指定フォーマットで返してください
  • 不確実性がある箇所は明示してください

Copilot へ照会する場合は --model を明示する。

bash
copilot -s --model <preferred_model> --allow-all-tools --add-dir <repo_path> -p "<query>"

challenger を使う場合は同じ照会文で再実行する。

bash
copilot -s --model <challenger_model> --allow-all-tools --add-dir <repo_path> -p "<query>"

複数照会先を使う場合は、同一の背景パッケージを使って比較可能性を確保する。

フェーズ5: 回答正規化

references/response-rubric.md を使って回答を同じ軸で整理する。

  • 結論
  • 根拠
  • 代替案
  • リスク
  • 信頼度
  • 追加で必要な確認事項

フェーズ6: 最終判断

  1. 回答同士の一致点・相違点を分ける
  2. 採用案を1つ選ぶ
  3. 非採用案を捨てた理由を短く記録する
  4. 未解決点が残る場合は明示したうえで進める

返答方針

  • 外部AIへ渡した照会文を提示する
  • 回収した結論を要約して提示する
  • 採用理由と信頼度を示す
  • 未解決リスクを明示する