notion-knowledge-capture

ナレッジの記録

会話やメモを、再利用しやすい構造化されたリンク可能な Notion ページに変換します。

クイックスタート

1. 記録する内容（決定事項、手順、FAQ、学習内容、ドキュメント）と対象読者を明確にします。
2. reference/ から適切なデータベース／テンプレート（チーム Wiki、手順、FAQ、決定事項ログ、学習内容、ドキュメント）を特定します。
3. Notion から以前のコンテキストを取得します：Notion:notion-search → Notion:notion-fetch（更新／リンクする既存ページ）。
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、概念／Wiki エントリ、学習内容／メモ、ドキュメントページ。

2) 保存先を特定する

• reference/*-database.md のガイドを使って適切なデータベースを選び、必須プロパティ（タイトル、タグ、担当者、ステータス、日付、関連）を確認します。
• 候補となるデータベースが複数ある場合は、どれを使うかユーザーに尋ねます。そうでなければ、主要な Wiki／ドキュメント DB に作成します。

3) 抽出して構成する

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

4) Notion で作成／更新する

• 適切な data_source_id を指定して Notion:notion-create-pages を使用し、プロパティ（タイトル、タグ、担当者、ステータス、日付、関連）を設定します。
• コンテンツの構成には 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）。