wiki-quick-chat-capture

Wiki クイックチャットキャプチャ

現在の会話から再利用可能な技術的知見を抽出し、後で昇格できるように _raw/ に保存します。セッション終了時に失われてしまう発見を、手間なく記録することが目的です。

速度に関する契約： インライン処理のみ。サブエージェントは使用しません。QMD は使用しません。マニフェストへの書き込みは行いません。目標：60 秒未満。

このスキルを使うタイミング

以下の場合に適しています：

• ユーザーがセッション中に、分かりにくいバグに遭遇した、またはフレームワークの落とし穴を確認した
• 保存する価値のある具体的な知見があるものの、完全な /wiki-ingest の実行は妨げになりすぎる
• ユーザーが知見を今すぐ記録し、昇格は一日の終わりまで延期したい

wiki-capture（最終的な Wiki ページに直接昇格）や wiki-ingest（相互リンクとマニフェスト追跡を含む完全なドキュメント取り込み）の代わりではありません。

開始前

1. 設定を解決する — llm-wiki/SKILL.md の設定解決プロトコル（CWD から上位へ .env を検索 → ~/.obsidian-wiki/config → セットアップを促す）に従います。次の値を取得します：
   • OBSIDIAN_VAULT_PATH
   • OBSIDIAN_RAW_DIR（既定値：$OBSIDIAN_VAULT_PATH/_raw）
2. $OBSIDIAN_RAW_DIR が存在することを確認します。存在しない場合は作成します。

ステップ 0：ゲート評価 — KEEP または SKIP？

何かを抽出する前に、このセッションに記録する価値があるかをすばやく判断します。このゲートにより、このスキルを（Stop フックなどから）自動的に呼び出しても、日常的なセッションや結論の出なかったセッションの不要な情報で _raw/ が埋まらないようにできます。

次の条件がすべて当てはまる場合は、SKIP — 「このセッションには記録する価値のある内容がありません。」と出力して、ただちに終了します。

• 実装を伴わない、純粋な会話（計画、Q&A、説明）である
• エラーメッセージ、デバッグ手順、問題解決のやり取りが見られない
• 想定外の動作や、ドキュメントに記載されていない動作に遭遇していない
• すべての知見が公式ドキュメントから明らかである

次の条件のいずれかに当てはまる場合は、KEEP — ステップ 1 に進みます。

• 修正が適用された、または調査を通じて回避策が見つかった
• 分かりにくいライブラリ／API／フレームワークの動作について議論され、確認された（例：時間を要したエッジケース、未文書化の制約、落とし穴）
• デバッグセッションで具体的な結論に至った
• 第一原理からは明らかでない、再利用可能なパターンや手法が得られた

Stop フック経由で自動的に呼び出された場合は、SKIP を優先します — 明確な根拠がある場合に限り KEEP とします。ユーザーが手動で呼び出した場合は、KEEP を優先します — 呼び出したのには理由があるはずです。

ステップ 1：会話から知見を探す

このセッションの記憶がなくても 3 か月後に役立つような、再利用可能な技術的知識を抽出します。

記録する内容：

• 分かりにくいバグとその根本原因
• フレームワークやライブラリの落とし穴（未文書化の動作、エッジケース）
• ユーザーが予想していなかった API の動作
• 調査を要した回避策や修正
• 環境やツールチェーン特有の挙動
• デバッグやテストを通じて得られたパターン

記録しない内容：

• プロジェクト管理上の更新、ロードマップの変更、CLAUDE.md にすでに記載されている設定
• 結論が出なかった探索的なやり取り
• ドキュメントや、どの開発者も初読で分かる定型的な内容から明らかなこと
• あいさつ、メタ会話、状況報告

重要な内容が何も得られなかった場合は、ユーザーに伝えて終了します。

ステップ 2：トピックごとにまとめる

関連する知見をグループ化します — 個々の知見ごとではなく、トピックのまとまりごとに raw ファイルを 1 つ作成します。

例：「Swift 6 の並行処理に関する落とし穴」「Next.js のハイドレーションに関するエッジケース」「Postgres のアドバイザリロック」。

各まとまりには、kebab-case のスラッグを付けます：swift-actor-reentrancy、nextjs-hydration-mismatch。

ステップ 3：プロジェクトのコンテキストを推定する

会話から手がかりを探します — リポジトリ名、ファイルパス、フレームワークへの言及、エラーメッセージなどです。確実に推定できる範囲で、最も具体的なプロジェクト名を使います。不明な場合は null を使います。

ステップ 4：生ファイルを書き込む

各クラスターについて、$OBSIDIAN_RAW_DIR/<ISO-date>-<slug>.md に書き込みます。

フロントマターの完全な仕様、本文の構造（調査結果ブロックの形式）、および出典・確信度の調整表については、references/RAW-FORMAT.md を確認してください。

クラスターごとに異なるフロントマターフィールドのクイックリファレンス：

• title — クラスターの内容を表すタイトル
• tags — ボルトの分類体系に合う、分野別のタグを2～4個
• summary — 1～2文、200文字以内
• project — 推定したプロジェクト名、または null
• base_confidence — 0.6（議論済み、未確認）→ 0.75（修正適用済み）→ 0.9（テストで確認済み）
• provenance.extracted / provenance.inferred — 合計が1.0になること
• lifecycle_changed — 今日の日付（ISO形式）
• sources — "<project> session (<YYYY-MM-DD>)"

ステップ 5：ユーザーに確認する

Staged to _raw/:
  _raw/2026-05-27-swift-actor-reentrancy.md   — "Actor reentrancy causes deadlock in async forEach"
  _raw/2026-05-27-xcode-derived-data-cache.md — "Stale derived data silently breaks incremental builds"

Run /wiki-ingest (or /data-ingest) to promote these to full wiki pages.

何も記録されていない場合：「このセッションには記録する価値のあるものが見つかりませんでした。」

このスキルで行わないこと

• マニフェストへの書き込みは行いません — _raw/ ファイルは .manifest.json で追跡されません
• index.md、log.md、hot.md の更新は行いません — これらは昇格時に行われます
• QMD の更新は行いません — raw ファイルは下書きであり、インデックス化されたコンテンツではありません
• サブエージェントは使用しません — このコンテキストウィンドウ内ですべてインラインで実行します

これらの制約には意図があります。重要なのは速度です。ユーザーの準備ができたら、/wiki-ingest による昇格ですべて処理されます。