Slite 笔记助手

团队知识库的价值不在于存了多少文档，而在于能不能在正确的时间找到正确的那条笔记。Slite 本身是一个协作文档平台，但它的界面和交互是围绕人来设计的；当你要把资料检索、内容整理、归档删除放进自动化流程里，直接点界面就很低效，也容易出错。这个技能的目标就是让程序能够安全地调用 Slite 的核心能力，把笔记操作变成可编排的步骤。

核心能力

这个技能通过 oo CLI 调用 Slite 连接器，一共暴露 8 个动作，按操作性质可以分成三组。

读取类动作是 get_note、list_notes、search_notes 和 get_group、search_groups，它们只做查询，不会改动任何数据，可以直接执行。检索笔记时可以按关键词搜索，也能根据 review、depth、archive 和日期范围做筛选；列表操作支持按 owner、parent 过滤，并使用游标分页。

写入类动作是 create_note 和 update_note，用于创建新笔记或修改已有笔记的标题、正文和 collection 属性。正文可以传 Markdown 或 HTML，这意味着你可以在程序里拼好内容再交给 Slite 渲染。

删除类动作只有 delete_note，它会连同子笔记一起删除，属于破坏性操作，执行前必须确认目标。

工作方式

调用方式很直接：先用 oo connector schema 拿到当前连接器的实时输入输出定义，构造一个匹配的 JSON 作为 --data，然后运行对应动作。不要凭感觉猜参数，schema 是权威来源。

执行成功后返回的数据里，data 是业务结果，meta.executionId 是本次执行的 ID，后续需要排查问题或对账时可以用它。

认证层面不需要你操心 token。OOMOL 在服务端注入凭证，本地命令里不会出现明文密钥。前提是你已经在 OOMOL 账号里完成了 Slite 的 API Key 连接；如果没有连接，命令会报 scopemissing、credentialexpired 之类的错误，这时再去走一次性的连接流程即可。

适用边界

这个技能管的是 Slite 笔记层面的读写，不涉及文档协作里的评论、提醒、分享权限设置。如果你需要做细粒度的权限控制或者团队通知，得结合 Slite 自己的功能来处理。

写入和删除动作会直接改变知识库内容，建议在执行前把 --data 里的参数打印出来跟用户确认一遍，尤其是 delete_note，要明确删除的是哪个 note id，以及它下面挂了哪些子笔记。

另外，连接器返回的是 Slite 的原始结构，正文格式由你在 --data 里指定。传 Markdown 还是 HTML 会影响后续在 Slite 里的渲染效果，做批量迁移或内容同步时值得先小范围验证一遍。

适用场景包括：把散落的会议纪要按模板批量归档到指定 collection、定期搜索并清理过期草稿、从其他系统拉取数据生成 Slite 笔记作为知识库补充。这类操作以前要么手动复制粘贴，要么写一次性脚本对接 API，现在可以包装成稳定的动作调用。