用 n8n 表单+Claude Sonnet 自动审计工作流并生成 Notion 文档

上传 n8n 工作流 JSON → 自动审计安全与可靠性 → Claude 生成业务摘要与技术报告 → 写入 Notion 分页

给谁

需要为 n8n 工作流生成审计文档的运营人员或自动化开发者

你会得到

提交工作流 JSON 后，30–60 秒内在 Notion 自动创建带评分、业务摘要和技术审计报告的格式化页面

你需要

n8n · notion

步骤

1. 导入模板并连接凭证

   在 n8n 中导入该工作流模板。将 Anthropic 账户凭证绑定到 Claude Model Interaction 节点；将 Notion 账户凭证绑定到 Create Notion Document 和 Append to Notion Document 两个节点。在 Notion 中打开目标父页面，进入页面设置 → Connections，添加你的集成以授予写入权限。

2. 通过表单提交工作流 JSON

   激活工作流后打开表单 URL。上传导出的 n8n 工作流 JSON 文件（.json），填写 Client Name，粘贴 32 位 Notion 父页面 ID（从页面 URL 获取，不带连字符）。表单字段：Workflow JSON（必填，仅 .json）、Client Name（必填）、Notion Parent Page ID（必填）。

3. 验证 JSON 并执行静态审计

   工作流自动读取上传的 JSON，验证 nodes 数组与 connections 对象存在。随后执行图分析：Kahn 拓扑排序确定执行顺序，检测循环节点与不可达节点；同时扫描硬编码密钥、缺失超时、未认证 Webhook、无错误处理分支等安全问题，生成带评分的审计发现列表。

4. 构建 AI 提示词

   将审计结果组装为结构化提示词，送入 Claude Sonnet。system 指令要求返回仅含两个键的原始 JSON（businessLogic + auditReport），禁止 markdown 代码块。user 内容包含工作流名称、节点数、审计评分、执行顺序、发现列表。

   运行提示词 · 来源原文。Construct AI Prompt 节点的 system 字段

   复制提示词

   You are an automation consultant writing client documentation.
   
   Return ONLY a raw JSON object with two keys — no markdown fences, no preamble:
   {
     "businessLogic": "<150-300 word plain-English summary of what this workflow does, when it runs, and what outcomes it produces. No technical node names.>",
     "auditReport":   "<Developer-facing audit findings in Markdown. Bold each severity label. End with an overall assessment paragraph. If no findings, say so.>"
   }

   运行提示词 · 来源原文。Construct AI Prompt 节点的 user 模板字段

   复制提示词

   Workflow: ${d.workflowName}
   Client: ${d.clientName}
   Nodes: ${d.nodeCount} | Audit Score: ${d.score}/100
   ${d.hasCycles ? 'WARNING: cycles detected in ' + d.cycleNodes.join(', ') : ''}
   
   EXECUTION ORDER:
   ${d.nodeList}
   
   AUDIT FINDINGS:
   ${d.findingsSummary}

5. 生成文档并解析响应

   Claude Sonnet 返回文本后，Interpret AI Response 节点去除 markdown 围栏并解析 JSON，校验 businessLogic 与 auditReport 字段存在。若模型返回空或格式错误，工作流抛出错误进入错误处理分支。

6. 创建 Notion 页面并分批写入

   Formulate Notion Blocks 节点将解析后的内容转换为 Notion block 对象（含评分 callout、业务摘要、技术审计报告、循环/不可达节点警告）。Create Notion Document 在指定父页面下创建新页面，随后通过 Split In Batches 循环分批追加 block，每批间等待约 350 毫秒以规避 Notion 速率限制。来源描述称等待 350 毫秒，但 workflow.json 中 Wait 节点 amount=35 且单位未明示，实际导入后建议核对并调整为 350 ms 或根据 Notion API 限制重新配置。【首次测试安全】首次测试前，改用测试 Notion 工作区/测试父页面，或临时断开创建 Notion 页面的写入节点，确认文档内容无误后再写入正式空间。

你是一个 n8n 工作流审计文档生成器的搭建助手。用户将导入模板并需要完成：1）Anthropic 与 Notion 凭证配置；2）确认表单字段与目标 Notion 父页面 ID；3）了解如何导出 n8n 工作流 JSON。请根据用户提供的凭证状态和页面 ID，给出下一步操作清单。