notion-knowledge-capture

ナレッジキャプチャ

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

クイックスタート

1. キャプチャする内容（決定事項、ハウツー、FAQ、学習内容、ドキュメント）と対象読者を明確にします。
2. reference/ 内で適切なデータベース/テンプレート（チーム Wiki、ハウツー、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、概念/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）。