notion-knowledge-capture

notion-knowledge-capture 技能概览

notion-knowledge-capture 帮助代理把对话上下文整理成结构化的 Notion 内容，而不是把原始笔记随手丢进不合适的位置。它最适合需要把 知识捕获 这一步做扎实的人：判断输入应该变成 wiki 页面、FAQ、操作指南、决策记录，还是其他可复用的资料。

这个技能适合做什么

当任务是把有价值的聊天输出保存到团队知识库，而不只是做个总结时，就该使用 notion-knowledge-capture 技能。它专为捕获决策、流程、解释和经验教训而设计，并会把内容整理成别人以后能找到、能复用的格式。

为什么值得安装

它的核心价值在于工作流纪律：它会推动代理识别正确的内容类型，把内容放到合适的 Notion 位置，并通过链接或数据库归档保持可发现性。相比泛泛的提示词，这一点更重要，因为这个技能已经把捕获模式和预期结构内置好了。

最适合的使用场景

这个技能适合维护 Notion wiki、FAQ、决策日志或文档数据库的团队，并且希望把聊天里产生的知识稳定、统一地沉淀下来。对于 notion-knowledge-capture for Knowledge Base Writing 来说，当源材料是一段包含真实操作细节的对话，而不是一份已经润色好的草稿时，它尤其匹配。

如何使用 notion-knowledge-capture 技能

安装并查看正确的文件

先按你的 skills 工作流完成安装，然后优先阅读 skills/claude/knowledge-capture/SKILL.md。之后再查看展示预期输出形态的示例和参考文件：examples/conversation-to-faq.md、examples/decision-capture.md、examples/how-to-guide.md，以及 reference/*.md。

提供正确类型的输入

这个技能在你同时提供对话内容和明确的捕获意图时效果最好，比如“把这个保存成决策记录”或“放进团队 wiki”。如果你已经知道页面该放哪里，要想获得更好的 notion-knowledge-capture usage，就把主题、受众，以及页面所在位置一并说明。

把粗略需求改写成可用提示词

一个弱需求是：“把这个存到 Notion。” 更好的写法是：“把这段部署讨论整理成工程 wiki 的操作指南。请包含前置条件、步骤、验证和故障排查。如果已经有现有的部署页面，就链接到它，或者把新页面放在它下面。”

补充这些上下文，能帮助技能决定正确的内容类型和结构，而不是仅凭一段简短摘要去猜。

创建页面前先读工作流

仓库里的核心路径是：识别内容 → 分类类型 → 组织页面结构 → 在 Notion 里找到目标位置 → 创建页面 → 让它可被发现。如果你的工作区有特定数据库或枢纽页，使用前先把这些映射清楚，这样技能就能正确搜索或定向，而不是创建彼此孤立的页面。

notion-knowledge-capture 技能 FAQ

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

不是。它的范围比 wiki 页面更广。这个技能支持把内容保存到数据库或独立页面中，具体取决于你的工作区是怎么组织的。只要 Notion 是存储系统，它就同样适合决策日志、FAQ、操作文档和学习笔记。

它和普通提示词有什么区别？

普通提示词可能只是概括一段对话，而 notion-knowledge-capture 的目标是让内容可复用。它会帮助代理选择文档类型、组织内容结构，并把内容放到别人以后能找到的位置上；这正是临时拼凑的提示词最容易出问题的地方。

这个技能适合新手吗？

适合，只要用户能用自然语言说明想要的结果。新手通常在明确目标类型时效果更好，比如 wiki、FAQ 或决策记录，因为这样技能就能把内容匹配到清晰的模板，而不是临场发挥。

什么时候不该用这个技能？

如果你只是需要一个快速摘要、一条私人笔记，或者一个并不打算发布到 Notion 的一次性回答，就不要用它。若你的工作区没有清晰的分类体系，它也不太适合，因为可发现性取决于你是否知道页面应该和哪里关联。

如何改进 notion-knowledge-capture 技能

先把缺失的上下文补齐

最大的质量提升来自提前给出技能无法推断的决策上下文：受众是谁、发生了什么变化、最终决定了什么、页面应该链接到哪里。对于 notion-knowledge-capture install 相关决策，也要注明团队已经在用的 Notion 数据库、父级页面或命名规范。

明确说明你想要的内容类型

当你直接点明目标格式时，这个技能表现会更好：操作指南、FAQ 条目、决策记录、会议摘要，或者参考页面。如果你不说清楚，代理就只能根据对话去推断类型，这很容易导致结构不对，或者漏掉关键部分。

留意常见失误模式

最常见的问题是总结过于泛泛、标题不够准确，以及页面没有和工作区其他内容建立关联。另一种失误是把决策或流程直接当成普通笔记处理；要达到 notion-knowledge-capture guide 级别的质量，输出里应该包含那些能让页面便于扫描、便于复用的部分。

在第一版基础上继续迭代

第一版生成后，可以再补充示例、精确命令、可选方案名称，或者该决策背后的具体理由来优化它。如果页面是用于知识库写作，就让代理进一步收紧标题、补上相关页面链接，并删掉那些对未来读者做行动、比较或排障没有帮助的内容。