n8n 工作流程需求描述轉規格文件
用途
把業務主管的白話自動化需求轉成可直接交給工程師執行的 n8n 規格文件，包含流程圖、節點設定、資料對應表、錯誤處理與測試清單。
何時用
- 適合：業務主管有想法但不懂技術、顧問需要橋接業務與工程師的時候；新客戶第一次做 n8n 自動化、需要把需求訪談結果轉成開發文件時。
- 不要用：已有規格文件只需要寫程式時，請直接用「Code 節點 JS 轉換」或「AI Agent 設計」提示語；如果需求連白話都說不清楚（「幫我自動化一切」這種），先做需求訪談，不要直接跑這個提示語。
Prompt
text
請把以下業務自動化需求轉成可直接交給 n8n 工程師的規格文件。
白話需求：
{{白話需求——盡量詳細，包含觸發條件、要做什麼、輸出到哪裡、例外情況}}
現有工具：
{{現有工具（如：Gmail、Google Sheets、Notion、LINE、Shopify、自有 API）}}
觸發頻率：
{{觸發頻率（如：即時 Webhook / 每天早上 8 點 / 每小時一次）}}
請輸出：
1. 流程圖文字版（Trigger → 步驟1 → 步驟2 → ... → Output）
2. 各 Node 設定說明（Node 名稱 / 類型 / 主要設定欄位 / 說明）
3. 資料欄位對應表（來源欄位 → 目標欄位，含資料格式轉換說明）
4. 錯誤處理設計（每個可能失敗點 + 處理方式）
5. 測試清單（5 個測試案例，含正常 + 邊界 + 異常）
6. 預估建置時間與難度評估（入門/中級/進階）
格式：Markdown，可直接存成規格文件。範例 / 變體
- 填好變數：白話需求填「每天早上客服收到 Google 表單回覆，自動整理成 Notion 工單並發 LINE 通知給對應客服人員」；工具填「Google Forms、Notion、LINE Messaging API」；頻率填「即時 Webhook（Forms 送出觸發）」。
- 變體（簡版給客戶確認用）：輸出格式只要「流程圖 + 3 個主要步驟說明」，用白話寫，拿去給業務主管確認需求對不對，確認後再跑完整版。
- 變體（含費用估算）：在最後加「根據觸發頻率估算每月 n8n 執行次數與 cloud 費用區間」，幫客戶做預算決策。
🎯 範例輸出（實測）
在 Claude.ai 跑這句、把
{{變數}}填成「白話需求：客服收到 Google 表單回覆，自動建 Notion 工單並發 LINE 通知；工具：Google Forms、Notion、LINE Messaging API；頻率：即時 Webhook」的結果：
點開看 AI 實際輸出
1. 流程圖
text
Webhook Trigger (Google Forms 送出)
→ Code Node (解析表單欄位)
→ Notion Node (建立工單 Page)
→ HTTP Request Node (LINE Messaging API 推送)
→ Respond to Webhook (回覆 Forms 確認)2. 各 Node 設定說明
| Node 名稱 | 類型 | 主要設定 | 說明 |
|---|---|---|---|
| Forms Webhook | Webhook | Method: POST, Path: /forms-inbound | 接收 Google Forms Webhook |
| Parse Form | Code | Run Once for All Items | 取 $json.body，解析姓名/問題/緊急度 |
| Create Notion Page | Notion | Database ID: xxx, Title: {{客戶姓名}} 工單 | 建工單並填入欄位 |
| LINE Push | HTTP Request | POST https://api.line.me/v2/bot/message/push | 推送工單摘要給客服 |
3. 資料欄位對應表
| 來源欄位 | 目標欄位 | 轉換說明 |
|---|---|---|
| body.entry[0].answer | Notion: 客戶姓名 | 字串，無轉換 |
| body.entry[1].answer | Notion: 問題描述 | 字串，截 500 字 |
| body.entry[2].answer | Notion: 緊急度 | 對應 Select：高/中/低 |
| 建立時間戳 | Notion: 建立時間 | new Date().toISOString() |
4. 錯誤處理設計
| 可能失敗點 | 處理方式 |
|---|---|
| Notion API 403 | 記錄 error log，Slack 告警 |
| LINE Token 過期 | IF 節點判斷 401，觸發 Token 刷新 sub-workflow |
| 表單欄位為空 | Code Node 給預設值 "未填寫" |
5. 測試清單（5 個案例）
- 正常送出：姓名＋問題＋緊急度全填，Notion 建立成功、LINE 收到通知
- 問題欄位空白：應建工單但填「未填寫」，不應中斷流程
- 緊急度填非預期值：對應 Select 找不到，應 fallback 為「中」
- Notion API 超時（>5s）：流程應繼續嘗試 LINE，並記錄 Notion 失敗
- LINE Token 失效：應觸發 Token 刷新，不應讓 LINE 靜默失敗
6. 預估建置時間與難度
難度：中級｜預估時間：4-6 小時（含測試）
💡 實測心得：「欄位對應表」是這個 prompt 最有價值的輸出——逼出「緊急度如何對應 Notion Select」這類細節，比口頭確認需求更精準；建議拿著欄位對應表讓業務主管過目一次，能在動工前抓到 80% 的需求誤解。
延伸
你有沒有遇過這種情況？工程師開始建流程了，做到一半才發現業務說的「自動通知」是 Email 還是 LINE 根本沒講清楚，砍掉重練。這個提示語的核心價值就是在開發前把模糊地帶逼出來，讓欄位對應表和錯誤處理在紙上先討論清楚。
規格確認後，下一步是「選擇架構模式」確認節點選型，再交給工程師建置。