ナレッジキャプチャ

会話とノートを構造化された、リンク可能な Notion ページに変換して、簡単に再利用できるようにします。

クイックスタート

1. キャプチャ対象を明確化（決定、ハウツー、FAQ、学習、ドキュメンテーション）し、ターゲット読者を決定します。
2. reference/ 内の適切なデータベース/テンプレートを特定します（チームウィキ、ハウツー、FAQ、決定ログ、学習、ドキュメンテーション）。
3. Notion:notion-search → Notion:notion-fetch で Notion から事前コンテキストを取得します（既存ページの更新/リンク用）。
4. Notion:notion-create-pages を使用してデータベーススキーマでページを下書きします。概要、コンテキスト、ソースリンク、タグ/所有者を含めます。
5. ハブページと関連レコードからリンクします。ソースの変更に応じて Notion:notion-update-page でステータス/所有者を更新します。

ワークフロー

0) Notion MCP が接続されていないために MCP 呼び出しが失敗する場合は、一旦停止してセットアップしてください：

1. Notion MCP を追加します：
   • codex mcp add notion --url https://mcp.notion.com/mcp
2. リモート MCP クライアントを有効にします：
   • config.toml で [features].rmcp_client = true を設定 するか codex --enable rmcp_client を実行
3. OAuth でログインします：
   • codex mcp login notion

ログインに成功したら、ユーザーは codex を再起動する必要があります。次に試行するときに手順 1 を続行できるよう、回答を終了して再起動が必要な旨をお伝えください。

1) キャプチャの定義

• 目的、対象読者、鮮度、および新規作成か更新かを確認します。
• コンテンツタイプを決定します：決定、ハウツー、FAQ、コンセプト/ウィキエントリ、学習/ノート、ドキュメンテーションページ。

2) 宛先を特定

• reference/*-database.md ガイドを使用して正しいデータベースを選択します。必要なプロパティ（タイトル、タグ、所有者、ステータス、日付、関連）を確認します。
• 複数の候補データベースがある場合は、ユーザーに使用するものを尋ねてください。それ以外の場合は、プライマリウィキ/ドキュメンテーション DB に作成します。

3) 抽出と構造化

• 会話から事実、決定、アクション、根拠を抽出します。
• 決定については、代替案、根拠、結果を記録します。
• ハウツー/ドキュメントについては、ステップ、前提条件、アセット/コードへのリンク、エッジケースをキャプチャします。
• FAQ については、Q&A 形式で簡潔な回答とより詳細なドキュメントへのリンクを含めます。

4) Notion で作成/更新

• Notion:notion-create-pages を正しい data_source_id で使用します。プロパティ（タイトル、タグ、所有者、ステータス、日付、関連）を設定します。
• reference/ のテンプレートを使用してコンテンツを構造化します（セクション見出し、チェックリスト）。
• 既存ページを更新する場合は、フェッチしてから Notion:notion-update-page で編集します。

5) リンクと表面化

• ハブページ、関連するスペック/ドキュメント、チームへの関連/バックリンクを追加します。
• 今後の読み手のために短い概要/変更ログを追加します。
• フォローアップタスクが存在する場合は、関連するデータベースでタスクを作成してリンクします。

参考資料と例

• reference/ — データベーススキーマとテンプレート（例：team-wiki-database.md、how-to-guide-database.md、faq-database.md、decision-log-database.md、documentation-database.md、learning-database.md、database-best-practices.md）。
• examples/ — 実践中のキャプチャパターン（例：decision-capture.md、how-to-guide.md、conversation-to-faq.md）。