notion-knowledge-capture

知识捕获

将对话和笔记转换为结构化、可互相链接的 Notion 页面，方便重复使用。

快速开始

1. 明确要捕获的内容（决策、操作指南、常见问题、学习内容、文档）和目标受众。
2. 在 reference/ 中找到合适的数据库/模板（团队 Wiki、操作指南、常见问题、决策日志、学习内容、文档）。
3. 使用 Notion:notion-search → Notion:notion-fetch 从 Notion 中提取以往上下文（需要更新/链接的现有页面）。
4. 使用 Notion:notion-create-pages，根据数据库架构起草页面；包含摘要、上下文、来源链接以及标签/负责人。
5. 从中心页面和相关记录添加链接；随着来源内容变化，使用 Notion:notion-update-page 更新状态/负责人。

工作流

0) 如果任何 MCP 调用因 Notion 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) 定义捕获内容

• 询问目的、受众、时效性，以及这是新建内容还是更新内容。
• 确定内容类型：决策、操作指南、常见问题、概念/Wiki 条目、学习内容/笔记、文档页面。

2) 确定目标位置

• 根据 reference/*-database.md 指南选择正确的数据库；确认必需属性（标题、标签、负责人、状态、日期、关联）。
• 如果有多个候选数据库，请询问用户要使用哪一个；否则，在主要的 Wiki/文档数据库中创建。

3) 提取并整理

• 从对话中提取事实、决策、行动和理由。
• 对于决策，记录备选方案、理由和结果。
• 对于操作指南/文档，记录步骤、前置条件、资源/代码链接和边缘情况。
• 对于常见问题，整理成问答形式，提供简洁的答案和指向更深入文档的链接。

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）。