notion-knowledge-capture

notion-knowledge-capture 技能概览

notion-knowledge-capture 是一个面向 Notion 的知识采集工作流，用来把零散的对话、笔记和决策整理成可搜索、可关联、可复用的结构化页面。它最适合那些已经确定“目标要落到 Notion 里”，但还需要在动笔前判断该用哪种页面类型、以及页面应该长成什么样的人。

当任务不是“总结这段聊天”，而是“把内容保存到合适的 Notion 结构里”时，就该使用 notion-knowledge-capture 技能。它的核心价值在于，能把内容分流到团队 wiki、操作指南、FAQ、决策记录或学习笔记里，而不是全部塞进一页通用摘要。

notion-knowledge-capture 最擅长什么

当源材料本身带有足够上下文、能保留原意时，notion-knowledge-capture 技能最强：比如带有取舍的决策、包含步骤和坑点的流程，或者应该沉淀为可复用 FAQ 的问答串。它更偏向知识系统里的编辑封装，而不是创意写作。

什么时候适合使用 notion-knowledge-capture

如果你需要一篇可以从相关记录里链接出来、由团队拥有、并且能长期维护更新的 Notion 页面，就选 notion-knowledge-capture。对于 Knowledge Capture 工作流来说，它非常适合输出结构化内容，而不只是“能读”。

需要先知道的主要取舍

这个技能依赖于正确选择内容类型和目标位置。如果源内容本身很模糊，结果也可能过于笼统。反过来，如果你已经知道受众、用途和目标数据库，输出就会比一次性 prompt 有用得多。

如何使用 notion-knowledge-capture 技能

安装 notion-knowledge-capture

要进行 notion-knowledge-capture 安装，请从 OpenAI skills collection 中添加该技能：

npx skills add openai/skills --skill notion-knowledge-capture

如果工作流会涉及 Notion，请先确保 Notion MCP server 可用。这个技能默认 Notion 工具链已经连通，这样它才能在正确的位置搜索、获取、创建和更新页面。

先读这些文件

先看 SKILL.md，理解采集流程；然后再检查那些把内容类型映射到数据库结构的参考文件。最值得优先阅读的是 reference/team-wiki-database.md、reference/how-to-guide-database.md、reference/faq-database.md、reference/decision-log-database.md 和 reference/documentation-database.md。

如果你想知道“什么算好”，可以读 examples/decision-capture.md、examples/how-to-guide.md 和 examples/conversation-to-faq.md。如果你关心预期行为，evaluations/conversation-to-wiki.json 和 evaluations/decision-record.json 特别有参考价值。

在调用前先把需求整理好

最好的结果来自清晰的采集简报，而不是直接丢一段原始 transcript。建议包含：

• 内容类型：决策、how-to、FAQ、学习笔记，还是文档
• 受众：团队、新人、工程师、客服等
• 目标位置：已有数据库、hub page，或者让技能去查找
• 源上下文：摘录前发生了什么、哪些信息重要、哪些内容要保留
• 约束：保留名称、日期、命令或链接；如有需要，省略敏感信息

一个更强的 prompt 可以像这样：“把这段部署讨论整理成工程 wiki 里的 how-to guide。保留所有精确命令，补上前置条件和 troubleshooting，如果已有合适页面，就链接到 team wiki。”

notion-knowledge-capture 技能常见问题

notion-knowledge-capture 只适用于 Notion 吗？

是的，它就是围绕 Notion 这个存储和关联层设计的。如果你只想要纯文本摘要、通用 markdown 笔记，或者非 Notion 文档，这个技能大概率是大材小用。

它和普通 prompt 有什么不同？

普通 prompt 可能只是总结内容，而 notion-knowledge-capture 的目标是做成一个能长期使用的知识资产。notion-knowledge-capture guide 会帮助你选对页面类型、保留源上下文，并把结果放到后来别人找得到的位置。

我需要很专业才能用吗？

不需要，但你需要知道最终想要什么。新手最适合先回答两个问题：“这篇内容应该变成哪种页面？”以及“它在 Notion 里应该放在哪儿？”如果暂时答不上来，也可以让技能根据对话去推断。

什么情况下不该用它？

不要把 notion-knowledge-capture 用在轻量头脑风暴、一次性的聊天清理，或者不会被复用的内容上。如果源材料太少，不足以支撑结构化页面，它也不合适，因为最后的 Notion 输出会显得很正式，却没有真正增加价值。

如何改进 notion-knowledge-capture 技能

给技能更完整的源上下文

质量提升最大的地方，是补足对话前后的上下文。告诉它正在做什么决策、在记录什么流程，或者用户在问什么 FAQ。对于 Knowledge Capture 场景来说，正是这些上下文让页面不至于变成一份泛泛的复述。

明确目标结构

如果你知道目标数据库，就直接说出来。“放进 decision log”或“使用 team wiki database”这类指令，能帮助技能匹配正确的 schema 和措辞。如果你还不确定，就先让它搜索 Notion，再决定最合适的 parent page 或 database。

注意这些常见失败模式

最常见的问题包括页面类型选错、缺少源链接，以及技术细节被过度抹平。如果第一次输出范围太宽，就要求更紧凑的 headings、保留命令、写清 owner，或者增加更明确的 rationale 部分。如果内容太稀疏，就不要只给摘要，直接提供原始 transcript 或笔记。

用具体修改不断迭代

第一页草稿出来后，可以通过明确的修改请求来继续优化 notion-knowledge-capture 的使用：补充 troubleshooting、拆分 action items、链接相关文档，或者把 overview 改写成面向不同受众的版本。这个技能最擅长的不是换个说法，而是通过第二轮把结构和完整度打磨到位。