notion-knowledge-capture

知识捕获

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

快速开始

1. 明确要捕获的内容（决策、操作指南、FAQ、学习笔记、文档）以及目标受众。
2. 在 reference/ 中确定合适的数据库/模板（团队 wiki、操作指南、FAQ、决策日志、学习笔记、文档）。
3. 使用 Notion:notion-search → Notion:notion-fetch 从 Notion 中拉取已有的相关上下文（需要更新/链接的现有页面）。
4. 使用 Notion:notion-create-pages 按照数据库的 schema 起草页面；包含摘要、上下文、来源链接以及标签/负责人。
5. 从 hub 页面和相关记录添加链接；随着来源的演变，使用 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/文档数据库中创建。

3) 提取并结构化

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

4) 在 Notion 中创建/更新

• 使用正确的 data_source_id 调用 Notion:notion-create-pages；设置属性（标题、标签、负责人、状态、日期、关联关系）。
• 使用 reference/ 中的模板来组织内容（章节标题、检查清单）。
• 如果要更新现有页面，先获取再通过 Notion:notion-update-page 进行编辑。

5) 链接与呈现

• 添加到 hub 页面、相关规范/文档和团队的关联关系/反向链接。
• 为将来的读者添加简短的摘要/变更日志。
• 如果存在后续任务，在相关数据库中创建任务并链接它们。

参考资料与示例

• reference/ — 数据库 schema 和模板（例如 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）。