unknowns-discovery

不明点の洗い出し

エージェントが計画、実装、レビュー、マージに着手する前に、ユーザー、仕様、プロンプト、またはコードベースに何が不足しているかを洗い出す必要がある場合に、このスキルを使用します。

プロンプト、スキル、チケット、スクリーンショット、コンテキストウィンドウは地図です。実際のコードベース、製品、ユーザー、データ、制約、経緯、レビュー担当者の期待は領域です。その間にある隔たりが、タスクにおける不明点です。

不明点の種類

種類	意味	エージェントの対応
既知の既知事項	プロンプトに明記された事実や制約	保持し、簡潔に言い直す
既知の未知事項	未解決だとすでに認識されている質問	尋ねる、調査する、パラメーター化する、またはゲートを設ける
未知の既知事項	ユーザーが目にして初めて気づく、暗黙の基準	試作する、モックを作る、比較する、または聞き取りを行う
未知の未知事項	誰も言及していない隠れた制約、不足している用語、先行事例、落とし穴、品質の上限	見落としを探す工程を実施し、参考資料を調べ、コードや履歴を検索し、重大な注意点を明らかにする

有効化するタイミング

次のいずれかに該当する場合、このスキルを有効にします。

• 作業が複数の段階にわたる、曖昧である、不慣れである、リスクが高い、または判断を要する可能性が高い。
• ユーザーが「見落としを探す工程」「未知の未知事項」「何が不足しているか」「私に質問して」「まず試作して」「実装メモ」「合意形成用ドキュメント」「クイズして」などを求めている。
• ユーザーに専門領域の用語知識がない、または良い結果がどのようなものか分からない。
• 作業にコードベースの履歴、アーキテクチャ、データモデル、権限、移行、UX、ビジュアルデザイン、製品のスコープ、ロールアウト、またはレビュー担当者の承認が関わる。
• エージェントが長期にわたる実装に着手しようとしている、または計画とコードベースが一致しないことがすでに判明している。

タイポの修正、変数名の変更、重大な不明点のない直接的な質問への回答など、調査によって余計な手間が増える小さく決定的な作業では、有効化しないでください。

基本的な流れ

1. 地図を示します。 タスク、制約、ユーザーが把握していることを言い直します。
2. 領域を調査します。 関連するファイル、ドキュメント、例、データ、スクリーンショット、参考資料、過去の作業、またはユーザー提供のコンテキストを確認します。
3. 不明点のマトリックスを作成します。 既知の既知事項、既知の未知事項、未知の既知事項、未知の未知事項を分けます。
4. 役に立つ、最も手軽な成果物を選びます。 影響範囲が最大の不明点を最も早く明らかにする手法を選びます。
5. 実装の開始を判断します。 危険な不明点が解決されるか、明示的に受け入れられるか、または元に戻せる判断によって切り離されるまで、先に進みません。
6. 発見した内容を引き継ぎます。 発見事項を、より良いプロンプト、計画、実装メモ、合意形成用ドキュメント、クイズ、テスト、またはレビュー資料に反映します。

Artifact モードセレクター

モード	使用する場合	出力
blindspot-pass	未知のコードベース／ドメイン／設計領域で、まだ把握していない未知の問題がありそうな場合	ブラインドスポットカード＋改善された実装プロンプト
teach-me-my-unknowns	ユーザーに用語や品質基準の知識が不足している場合	メンタルモデル＋用語の段階的な習得＋改善されたプロンプト
brainstorm-prototype	ユーザーが実際に見て判断する必要がある場合	多様なプロトタイプ／選択肢＋反応テンプレート
mock-before-wire	バックエンド／状態／アプリを変更する前に UI／フローを確認する必要がある場合	仮データを使った使い捨てモック＋接続計画
option-space-brainstorm	問題の捉え方が狭すぎる、または広すぎる可能性がある場合	低コストなものから意欲的なものまで、優先順位を付けた介入策
one-question-interview	探索後も曖昧さが残っている場合	影響範囲の大きい順に、一度に1つずつ質問
reference-semantics-map	既存のコード／設計／ドキュメントが最適な説明になっている場合	移植／適用の前にセマンティクスマップを作成
tweakable-plan	実装の準備はできているが、変更されやすい部分を人間が確認する必要がある場合	実行順ではなく、人間が調整する可能性の高い順に並べた計画
implementation-notes	実装中に予想外の事態が発生した場合	継続的な逸脱記録
buy-in-doc	作業に承認または関係者間の合意が必要な場合	異論への対応と承認欄を含む、デモを先に示す提案／説明
merge-readiness-quiz	マージ／リリース前に、人間が複雑な変更を理解する必要がある場合	合格基準付きのレポート＋クイズ

詳細な手順はreferences/WORKFLOWS.mdにあります。コピーして使えるプロンプトカードはreferences/PROMPT_PATTERNS.mdにあります。出力スキーマはreferences/OUTPUT_SCHEMAS.mdにあります。

デフォルトの出力要件

すべての未知事項に関する成果物には、次の項目を含めてください。

1. 対象範囲の確認： 調査した内容、または前提とした内容。
2. 見つかった未知事項： 未知事項の種類と重大度ごとのラベル。
3. 影響範囲： この未知事項への回答が異なる場合に、何が変わるか。
4. 保守的なデフォルト： 続行せざるを得ない場合に、エージェントが実行する内容。
5. 必要な判断： ユーザーが選択する必要がある場合、その内容。
6. プロンプトの改善： 発見事項を反映して改訂したプロンプト／指示。
7. 停止条件： 推測が許容されないケース。

自律性に関するルール

• 未知事項によってアーキテクチャ、データモデル、認証、プライバシー、コンプライアンス、コスト、パブリック API、移行、ロールアウト、またはユーザー向けの動作が変わる可能性がある場合は、実行前に確認してください。
• 未知事項のリスクが低く、変更を元に戻せて、ユーザーから中断しないよう求められている場合は、保守的に進めてください。前提には ASSUMED のラベルを付けてください。
• フィードバックが好み、レイアウト、文体、操作フロー、情報アーキテクチャ、またはデータ密度に左右される場合は、接続する前にプロトタイプを作成してください。
• 動作がすでに別の場所に存在する場合は、説明文よりもソースへの参照を優先してください。
• 実装中に重要な逸脱があった場合は、続行する前にすべて記録してください。
• 差分をざっと確認しただけで、複雑なエージェント作業をマージしないでください。理解が重要な場合は、レポートとクイズを作成してください。

次の場合は直ちに停止してください

• 対象領域がタスクの目標に反している場合。
• 未知事項が、データ損失、認証の回避、プライバシー漏洩、請求への影響、破壊的な移行、パブリック API の破壊、またはコンプライアンス違反につながる可能性がある場合。
• 以前に失敗または取り消された試みがあり、その理由が依然として当てはまる場合。
• 正確な法務／セキュリティ／コンプライアンス上の動作が求められているのに、正式な情報源が存在しない場合。

最小限の例

Do a blindspot pass before implementation. Find unknown unknowns, explain why each matters, and rewrite my prompt with the discoveries folded in.

Before touching the app, make a single HTML mock with fake data so I can react to layout and product decisions.

Keep implementation-notes.md as you build. If code forces a plan deviation, choose the conservative option, log it under Deviations, and continue unless it affects security/data/migrations/API/compliance.

Give me a merge-readiness report with a quiz at the bottom. I should not merge until I pass it perfectly.

パッケージに含まれるリソース

• references/ARTICLE_DIGEST.md — 提供された記事から忠実に抽出した要約です。
• references/WORKFLOWS.md — 各成果物モードの詳細な手順です。
• references/PROMPT_PATTERNS.md — 再利用可能なプロンプトカードです。
• references/OUTPUT_SCHEMAS.md — 成果物のスキーマとゲートです。
• references/EVALUATION.md — 評価用プロンプトと品質評価基準です。
• references/SOURCE_INDEX.md — ソースと形式に関する参考情報です。
• assets/templates/ — 再利用可能な Markdown テンプレートです。
• examples/ — コーディング、プロダクト／デザイン、調査にわたるアプリケーション例です。
• scripts/ — テンプレートの生成と検証に使用できる補助スクリプトです。