Communitygithub.com

OKF ドメイン引き出しスキル

セッション間で継続可能な構造化ドメイン引き出しインタビューを実施し、実行中にOKF知識バンドル(用語集、時間軸イベント、ルール、コンテキストマップ)を生成します。

OKF ドメイン引き出しスキル とは?

OKF ドメイン引き出しスキルは、セッションやコンテキストウィンドウを超えて生存するドメインインタビューを実施するためのAIエージェントスキルです。このスキルは「飽和」「ブランチキュー」「三時間性」の3つの主要概念に基づいて動作します。具体的には、会話の状態をすべてディスク上のファイル(state.json、queue.jsonlなど)に永続化することで、いつでも再開可能な状態を維持します。インタビューはフレーム設定、ナレーション、掘り下げ、ブランチ生成、定義、振り返りという状態遷移に従って進行し、各回答に対して曖昧な量化表現の具体化、例の要求、例外の探索、新用語の定義などを自動的にプローブします。すべての知識成果物(用語集、イベント、ルール、コンテキストマップ)はインタビュー中に逐次OKFバンドルとして出力され、完了条件(未処理ブランチなし、全用語に非例付き定義、全イベントに三時間性情報など)を満たした時点で成果物として引き渡せます。

対応~Claude Code~Codex CLI~Cursor
npx skills add NickMoignard/okf-domain-elicit

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

OKF ドメイン引き出し

セッションをまたいで生存し、実行中にOKFバンドルを生成するドメインインタビューを実施します。3つの主要語がすべての実行を制御します。

  • 飽和 — 質問のラインは、それが飽和したときにのみ完了します。すなわち、回答が具体的で、範囲が定まり、例示され、例外がテストされ、新しいスレッドを生み出さない状態です。
  • ブランチキュー — 未探索のケースはすべてディスク上のキューにプッシュされ、空になるまで処理されます。深さ優先、幅追跡、何も落とされません。
  • 三時間性 — 時間に関わるすべての事実は、それが発生した時、組織がそれを受信した時、それが入力された時を記録します。TRI-TEMPORAL.md を参照してください。

このスキルは 構造と成果物 を提供します。粘り強い インタビューの姿勢(例:/grilling)と組み合わせて使用してください。

セッションワークスペース — 何かを尋ねる前に再開

すべての状態はディスク上に存在するため、インタビューはコンテキストウィンドウとセッションの境界を超えて生存します。呼び出し時:

  1. トピックスラッグを決定します(未設定の場合はユーザーに主題を尋ねます)。
  2. .interview/<slug>/ を探します。存在する場合は、state.json と queue.jsonl を読み込み、記録された状態とアクティブなスレッドから再開し、どこから再開するかをアナウンスします。
  3. 存在しない場合は、以下を作成します:
.interview/<slug>/
  state.json      # {state, active_thread, topic, temporal_relevance}
  queue.jsonl     # 1行につき1ブランチ:{id, prompt, status, parent}
  index.md        # OKFバンドルルート        — BUNDLE-FORMAT.md 参照
  glossary.md     # ユビキタス言語           — GLOSSARY-FORMAT.md 参照
  events.md       # ドメインイベントタイムライン — EVENTS-FORMAT.md 参照
  rules.md        # ビジネスルール           — RULES-FORMAT.md 参照
  context-map.md  # 境界付けられたコンテキスト — CONTEXT-MAP-FORMAT.md 参照

取得した事実と状態遷移のたびに永続化します。キューや取得した事実をコンテキスト内だけで保持しないでください — ディスクが真実の源泉です。

ステートマシン

これらの状態を遷移します。エンジンは NARRATE → DRILL → BRANCH のループであり、終了条件が満たされるまでブランチキューを NARRATE に戻します。完全なプロンプトは QUESTION-BANKS.md を参照してください。

  • S0 フレーム設定 — スコープ、目標、境界のアクターを設定します。state.json に temporal_relevance(暦日?時秒?)を設定します。
  • S1 ナレーション — 具体的なストーリーを1つ、イベントタイムラインとして引き出します。events.md にイベントを追加します。
  • S2 掘り下げ — イベントごとに、トリガー・アクター・入力データ・ルール・結果・タイミング・識別子、およびその三時間性状態を抽出します(TRI-TEMPORAL.md 参照)。
  • S3 ブランチ生成 — 「ここで他に何が起こり得るか?」各例外 / 代替 / 失敗を pending として queue.jsonl にプッシュします。
  • S4 定義 — 用語(それぞれに非例付き)を固定し、多重度と境界を定義します。glossary.md と context-map.md に書き込みます。
  • S5 振り返り — モデルをステークホルダーの言葉で再生し、修正点を取得します。

プロービングリフレックス

すべての状態で、すべての回答に適用します — これが粘り強い中核です:

不明瞭な数量詞(「通常」「数個」「普通は」)→ 境界を尋ねる
例のない抽象化                             → 具体的なインスタンスを要求する
主張されたルール(「私たちは常にXする」)      → 例外を探す
新しい用語                                   → 非例とともに glossary.md に書き込む
新しいアクターまたはイベント                    → queue.jsonl にプッシュする
時間に関わる事実                             → 3つの三時間性状態すべてを取得する
それ以外(具体的、範囲あり、例示あり、例外テスト済み)
                                            → スレッドを飽和とマークし、次の pending ブランチをポップする

ブランチキュープロトコル

  • ブランチは {id, prompt, status: pending|active|saturated, parent} — 1行に1つのJSONオブジェクト、追記専用。
  • ブランチを処理するには:state.json で active に設定し、S1→S3 を実行し、saturated とマークした行を追加します。
  • 次の pending ブランチは、アクティブなスレッドが飽和した場合のみポップします。
  • 再開時、キューは残っているものの真実の源泉です — それを読み取り、メモリから再構築しないでください。

完了条件

以下のすべてが成立するまで停止しません。これらはチェック可能です — 早期に完了と宣言しないでください:

  • queue.jsonl に pending ブランチがない。
  • glossary.md のすべての用語に定義と非例の両方がある。
  • events.md のすべてのイベントに3つの三時間性状態すべて、または明示的な n/a — {理由} が含まれている。
  • S5の振り返りで実質的な訂正が発生しなかった。
  • 新しい質問は既知の事実の言い換えのみを生み出す。

出力

逐次OKFを書き込みます — 最後にバッチ処理しないでください。各成果物は対応する *-FORMAT.md に従います。これらは一緒に index.md をルートとするOKFバンドルを形成します。成果物が内容を得るにつれて index.md を最新に保ちます。バンドルが成果物です — 完了条件が成立したら引き渡します(例:/to-prd や /to-issues へ)。

関連スキル