workflow-validate 是 makenotion/notion-cookbook 中的一项工作流校验技能,用途是审查 Notion Worker Workflows 的触发器类型与重试安全性。
用途:对 Notion Worker Workflows 进行校验,重点检查触发事件字段的类型处理,以及在重试场景下是否存在不安全行为,帮助在开发阶段发现可能导致运行失败或重复副作用的问题。
主要能力:审查 src/workflows/ 下的每个文件及其调用的模块;对每个发现的问题报告其文件、行号、影响和修复方式。
被判定为错误的情形:
- Workflow 不是直接文件,或没有默认导出 createWorkflow。
- 使用了特定触发器的事件字段,但没有做类型收窄。
- 在未 await 的 step 之外执行非确定性工作。
- step 的顺序或名称可能在重试之间发生变化。
- step 的结果不可 JSON 序列化,或后续代码需要内存中的可变修改。
- 对重试敏感的写入缺少幂等键或防重复保护。
- 忽略外部失败,或凭据被硬编码或写入日志。
使用方式:在依赖安装完成后,运行 npm run check 和 npm run build。该技能本身的具体调用与集成步骤暂未提供。
适用场景:在开发、提交或部署 Notion Worker Workflows 之前,检查工作流在触发事件类型与重试方面的安全性,减少因重试导致的重复写入或状态不一致。
限制:资料未提供该技能的安装方式、依赖要求细节、支持平台、收费情况或性能效果等信息。