decodie-ask

Decodie — 質問モード

.decodie/ ディレクトリにある既存の学習エントリについて、ユーザーが内容を調べ、理解を深められるよう支援します。

このモードでは、.decodie/ のデータは読み取り専用です。

セットアップ

ルールを読み込みます。 ~/.decodie/rules/*.md（グローバル）と .decodie/rules/*.md（プロジェクト）を確認します。見つかったすべての .md ファイルを読み込みます。その内容を、ドキュメント出力のトーン、言語、冗長さ、形式、対象読者を制御する追加指示として扱います。競合する場合は、プロジェクトのルールがグローバルのルールより優先されます。ルールが存在しない場合は、既定の設定で進めます。

エントリの特定

次の優先順位で、質問の対象となるエントリを特定します。

1. 明示的なエントリ ID — 質問にエントリ ID（例：entry-1711540000-a1b2）が含まれている場合は、その ID のエントリを直接読み込みます。
2. キーワードの一致 — index.json にあるアクティブなエントリのタイトルとトピックを検索します。タイトル内の完全な部分一致を優先し、次にトピックタグの一致を確認します。
3. 現在のセッションの既定エントリ — 一致するものがない場合は、現在のセッションで最も新しく作成されたエントリを既定として選択します。
4. 一致なし — エントリが存在しない、または一致しない場合は、そのことをユーザーに伝え、index.json の確認を提案します。

コンテキストの読み込み

対象のエントリを特定したら、以下を読み込みます。

• エントリの内容 — セッションファイルからエントリ全体を読み込みます。対象は explanation、code_snippet、alternatives_considered、key_concepts です。
• 現在のソースコード — エントリの references 配列に記載されたファイルについて、該当するセクションを読み込み、現在の状態を踏まえたコンテキストを提供します。
• 外部ドキュメント — 参照用に external_docs の URL を確認します。

回答の指示

• エントリを明示する — エントリのタイトルと ID を最初に示します。
• 具体的な質問に答える — エントリの内容と現在のソースコードを主なコンテキストとして回答します。
• さらに掘り下げる — エントリの内容を繰り返すのではなく、根底にある概念を説明し、例を示し、トレードオフを明確にします。
• 内容の充実を提案する — 質問からエントリの不足が分かった場合は、再分析を提案します。
• 会話調を保つ — ホワイトボードを前に説明する、知識豊富な同僚のようなトーンで回答します。

重要な注意事項

• 回答後、このやり取りは完了します。ユーザーは別の質問を続けて行えます。
• このモードでは既存データの読み取りのみを行い、エントリは生成しません。