关于 notis-query
notis-query 是使用 Notis 原生结构化查询访问数据库的技能,可帮助检查架构、获取完整分页结果,并通过版本校验安全处理记录和写入。
主要功能
- 01检查数据库架构与目标
- 02筛选、排序、聚合和分页
- 03查询至所有分页完成
- 04读取关联记录和视图
- 05通过版本校验与回读保障写入
适用场景
- 01查找符合字段条件的记录
- 02计算数量或聚合值
- 03获取数据库查询的全部分页
- 04更新记录并核验结果
MCP 相关
该技能说明如何使用 Notis 原生数据库工具,包括数据库发现、查询和写入操作。托管 MCP 提供相关参考指南。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ mindtheflo/ notis-skills --skill notis-query安装后在 Claude Code 中输入/notis-query确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/database-discovery.mddocuments.mdquery.md详细介绍
原生数据库查询
使用结构化原生查询进行筛选、排序、计数、聚合和分页。使用记忆进行语义发现;使用视图渲染查看页面显示的内容。实时工具 inputSchema 具有权威性。
- 使用
LOCAL_NOTIS_DATABASE_GET_DATABASE发现数据库,并检查其架构、属性描述、关联目标和选项 ID。 - 保留其返回的确切原生
target、架构修订版本和可用操作。每个数据库都位于一个 Space 中;访问失败时不会回退到其他所有者。 - 使用
LOCAL_NOTIS_DATABASE_QUERY,并传入protocol: 1、该target和直接的input。根据实际字段类型和选项构建筛选条件。持续翻页,直到返回的续页标记结束;一页并不代表整个数据库。 - 对于已知记录或视图链接,请遵循读取记录,而不是进行宽泛的发现。视图链接来自写入结果或
LOCAL_NOTIS_FIND_VIEWS;对于敏感或过时的证据,需要重新渲染以获取最新内容。 - 写入时使用已发现的原生工具,并提供当前架构/记录修订版本和稳定的请求 ID。先进行试运行,再读取已提交的状态。缺少视图链接不代表写入失败,也不能据此重复写入。
在编写 Space 代码时,使用 useShown 或已声明的操作,而不是调用账户范围的工具。加载 notis-spaces 以查看 Space 编写指南;其托管版参考文档位于 notis://docs/notis-spaces/references/views.md。
指南
托管版 MCP 会将这些参考文档放在
notis://docs/notis-query/references/<file>.md 下;只加载相关指南。
评论
支持 Markdown