SuperAPI AI 工具集

notion-local-dev-loop

编程与开发

查看项目

更新于 10-15 23:27

技能介绍

用途:在本地建立可重复的 Notion 开发与调试循环,借助合成夹具(fixtures)、mock 和明确共享的沙箱进行开发,避免接触生产工作区内容。

主要能力:模型化所选 API 版本的契约(分页、错误、新增字段、数据源标识、写语义);通过操作边界包装客户端,仅记录状态与请求 ID 而不记录内容;实现离线单元与契约测试,再补充沙箱冒烟测试。

必要用法:固定 SDK、API 版本、运行时与夹具 schema;创建合成的 page、data-source、block、webhook、limit 与 error 夹具并加入密钥金丝雀;先跑离线测试,再执行一次受限读取;仅在获批后进行可逆沙箱写入。使用 Read、Glob、Grep 查阅文档与夹具,仅用 Write、Edit 修改已批准的仓库产物。调用本身不授权网络访问、凭据使用、内容传输、部署或删除。

适用场景:完全基于合成多页夹具开发数据源查询;在沙箱中执行页面写入并恢复原状。

限制:任何实时调用需沙箱所有者批准,写入、webhook、文件上传或破坏性重置需显式批准;不得将实时响应未经分类与脱敏就记录为夹具;测试不得依赖搜索传播时序;若配置指向生产连接或对象则失败。需返回环境契约、夹具清单、测试命令、沙箱访问图、实时检查回执与清理状态,并标明假设、负责人、过期时间与证据缺口。具体命令与官方文档细节暂未提供。