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>"

这一步可确保知识不会变成“孤立内容”，而是与工作区的导航结构妥善关联。

内容类型

根据内容选择合适的结构：

概念：概述 → 定义 → 特征 → 示例 → 用例 → 相关内容 操作指南：概述 → 前提条件 → 步骤（编号）→ 验证 → 故障排除 → 相关内容 决策：背景 → 决策 → 理由 → 考虑过的选项 → 后果 → 实施 常见问题：简短回答 → 详细说明 → 示例 → 适用场景 → 相关问题 经验总结：发生了什么 → 做得好的地方 → 有待改进之处 → 根本原因 → 经验教训 → 后续行动

保存位置模式

通用 Wiki：独立页面 → 添加到索引 → 添加标签 → 从相关页面添加链接

项目 Wiki：作为项目页面的子页面 → 从项目概述添加链接 → 添加项目名称标签

文档数据库：使用属性（标题、类型、类别、标签、最后更新、负责人）

决策日志数据库：使用属性（决策、日期、状态、领域、决策者、影响）

常见问题数据库：使用属性（问题、类别、标签、上次审核时间、有用次数）

数据库选择指南和各数据库的架构文件请参见 reference/database-best-practices.md。

从对话中提取内容

聊天讨论：要点、结论、资源、行动项、问答

问题解决：问题描述、尝试过的方法、解决方案、成功原因、未来考虑事项

知识分享：概念说明、示例、最佳实践、常见误区、资源

决策讨论：问题、选项、权衡、决策、理由、后续步骤

格式规范

结构：一致地使用 #（标题）、##（章节）、###（小节）

写作：从概述开始，使用项目符号，保持段落简短，并添加示例

链接：链接相关页面，提及相关人员，引用资源，并创建双向链接

元数据：包括日期、作者、标签、状态

可搜索性：标题清晰，关键词自然，使用常见搜索标签，并为图片添加替代文本

索引与组织

Wiki 索引：按章节组织（入门指南、操作指南、参考资料、常见问题、决策），并添加页面链接

类别页面：创建包含概述、文档链接和近期更新的入口页面

标签策略：统一使用技术/工具、主题、受众和状态标签

更新管理

新建：内容较为详尽（超过 2 个段落）、会被多次引用、属于知识库内容，或需要单独查找时

更新现有内容：补充现有主题、修正信息、扩展概念或根据变化更新内容时

版本管理：重大变更时添加更新历史章节（日期、作者、变更内容、原因）

最佳实践

1. 及时记录：趁上下文还清晰时记录
2. 保持结构一致：为类似内容使用模板
3. 广泛链接：关联相关知识
4. 便于发现：使用便于搜索的标题和标签
5. 补充上下文：说明其重要性以及适用场景
6. 添加示例：具体示例有助于理解
7. 持续维护：定期检查并更新
8. 征求反馈：询问文档是否有帮助

高级功能

文档数据库：有关数据库架构模式，请参阅 reference/database-best-practices.md。

常见问题

“不确定保存在哪里”：默认保存到通用知识库，之后可以移动 “内容零散”：将相关片段整理成连贯的文档 “内容已存在”：先搜索；如果合适，更新现有内容 “语气太随意”：润色措辞，同时保留其中的见解

示例

完整工作流请参阅 examples/：

• examples/conversation-to-faq.md - 根据问答整理 FAQ
• examples/decision-capture.md - 决策记录
• examples/how-to-guide.md - 根据讨论编写操作指南