notion-knowledge-capture

ナレッジの記録

会話、議論、知見を、Notion ワークスペース内の構造化されたドキュメントに変換します。チャットのコンテキストから知識を取り込み、適切な形式に整えて、整理やリンクを適切に行ったうえで正しい場所に保存します。

クイックスタート

Notion に情報を保存するよう依頼された場合：

1. コンテンツを抽出する：会話のコンテキストから重要な情報を特定します
2. 情報を構成する：適切なドキュメント形式に整理します
3. 保存先を決める：Notion:notion-search を使って、適切な Wiki ページまたはデータベースを探します
4. ページを作成する：Notion:notion-create-pages を使ってコンテンツを保存します
5. 見つけやすくする：関連するハブページからリンクし、データベースに追加するか、Wiki のナビゲーションを更新して、ほかの人が見つけられるようにします

ナレッジ記録のワークフロー

ステップ 1：記録するコンテンツを特定する

From conversation context, extract:
- Key concepts and definitions
- Decisions made and rationale
- How-to information and procedures
- Important insights or learnings
- Q&A pairs
- Examples and use cases

ステップ 2：コンテンツの種類を決める

Classify the knowledge:
- Concept/Definition
- How-to Guide
- Decision Record
- FAQ Entry
- Meeting Summary
- Learning/Post-mortem
- Reference Documentation

ステップ 3：コンテンツを構成する

Format appropriately based on content type:
- Use templates for consistency
- Add clear headings and sections
- Include examples where helpful
- Add relevant metadata
- Link to related pages

ステップ 4：保存先を決める

Where to save:
- Wiki page (general knowledge base)
- Specific project page (project-specific knowledge)
- Documentation database (structured docs)
- FAQ database (questions and answers)
- Decision log (architecture/product decisions)
- Team wiki (team-specific knowledge)

ステップ 5：ページを作成する

Use Notion:notion-create-pages:
- Set appropriate title
- Use structured content from template
- Set properties if in database
- Add tags/categories
- Link to related pages

ステップ 6：コンテンツを見つけやすくする

Link the new page so others can find it:

1. Update hub/index pages:
   - Add link to wiki table of contents page
   - Add link from relevant project page
   - Add link from category/topic page (e.g., "Engineering Docs")
   
2. If page is in a database:
   - Set appropriate tags/categories
   - Set status (e.g., "Published")
   - Add to relevant views
   
3. Optionally update parent page:
   - If saved under a project, add to project's "Documentation" section
   - If in team wiki, ensure it's linked from team homepage

Example:
Notion:notion-update-page
page_id: "team-wiki-homepage-id"
command: "insert_content_after"
selection_with_ellipsis: "## How-To Guides..."
new_str: "- <mention-page url='...'>How to Deploy to Production</mention-page>"

このステップにより、ナレッジが「孤立」せず、ワークスペースのナビゲーション構造に適切に結び付けられます。

コンテンツの種類

コンテンツに合わせて、適切な構成を選びます。

コンセプト：概要 → 定義 → 特徴 → 例 → ユースケース → 関連情報 ハウツー：概要 → 前提条件 → 手順（番号付き） → 検証 → トラブルシューティング → 関連情報 意思決定：背景 → 決定事項 → 根拠 → 検討した選択肢 → 結果 → 実装 FAQ：簡潔な回答 → 詳細な説明 → 例 → 使用する場面 → 関連する質問 学び：起きたこと → うまくいったこと → うまくいかなかったこと → 根本原因 → 学び → アクション

保存先のパターン

一般的な Wiki：独立したページ → インデックスに追加 → タグ付け → 関連ページからリンク

プロジェクト Wiki：プロジェクトページの子ページ → プロジェクト概要からリンク → プロジェクト名でタグ付け

ドキュメントデータベース：プロパティを使用（タイトル、種類、カテゴリ、タグ、最終更新日、担当者）

意思決定ログデータベース：プロパティを使用（決定事項、日付、ステータス、分野、決定者、影響）

FAQ データベース：プロパティを使用（質問、カテゴリ、タグ、最終レビュー日、役立った回数）

データベースの選択ガイドと個別のスキーマファイルについては、reference/database-best-practices.md を参照してください。

会話からのコンテンツ抽出

チャットでの議論：重要なポイント、結論、リソース、アクション項目、質疑応答

問題解決：問題の説明、試したアプローチ、解決策、うまくいった理由、今後の考慮事項

ナレッジの共有：説明したコンセプト、例、ベストプラクティス、よくある落とし穴、リソース

意思決定の議論：質問、選択肢、トレードオフ、決定事項、根拠、次のステップ

書式設定のベストプラクティス

構成：#（タイトル）、##（セクション）、###（サブセクション）を一貫して使用します

文章：概要から始め、箇条書きを使い、段落を短く保ち、例を追加します

リンク：関連ページにリンクし、人に言及し、リソースを参照し、双方向リンクを作成します

メタデータ：日付、作成者、タグ、ステータスを含めます

検索性：わかりやすいタイトル、自然なキーワード、一般的な検索タグ、画像の代替テキストを使用します

インデックス作成と整理

Wiki インデックス：セクション（はじめに、ハウツーガイド、リファレンス、FAQ、意思決定）ごとに整理し、ページへのリンクを追加します

カテゴリページ：概要、ドキュメントへのリンク、最近の更新を含むランディングページを作成します

タグ付け方針：テクノロジー／ツール、トピック、対象者、ステータスに一貫したタグを使用します

更新管理

新規作成：コンテンツに十分な内容があり（2 段落を超える）、複数回参照される見込みがあり、ナレッジベースの一部で、独立して見つけられる必要がある場合

既存ページを更新：既存のトピックに情報を追加する場合、情報を修正する場合、コンセプトを詳しく説明する場合、変更に合わせて更新する場合

バージョン管理：重要な変更については、更新履歴セクションを追加します（日付、作成者、変更内容、理由）

ベストプラクティス

1. すぐに記録する：状況を覚えているうちに文書化します
2. 一貫した構成にする：類似した内容にはテンプレートを使用します
3. 広くリンクする：関連する知識をつなげます
4. 見つけやすく書く：検索しやすいタイトルとタグを使用します
5. 背景を含める：なぜ重要なのか、いつ使用するのかを記載します
6. 例を追加する：具体例は理解に役立ちます
7. メンテナンスする：定期的に見直して更新します
8. フィードバックを得る：ドキュメントが役に立つか確認します

高度な機能

ドキュメント用データベース：データベーススキーマのパターンについては、reference/database-best-practices.mdを参照してください。

よくある問題

「どこに保存すればよいかわからない」：まずは汎用 wiki に保存し、後から移動できます 「内容が断片的である」：関連する断片をまとめて、一貫性のあるドキュメントにします 「すでに存在する」：まず検索し、適切であれば既存の内容を更新します 「くだけすぎている」：知見を保ちながら、表現を整えます

例

一連のワークフローについては、examples/を参照してください：

• examples/conversation-to-faq.md - Q&A から作成する FAQ
• examples/decision-capture.md - 意思決定の記録
• examples/how-to-guide.md - 議論から作成するハウツーガイド