n8n-workflow-automation

リトライ、ログ記録、レビューキューを備えた n8n ワークフロー自動化

目的

堅牢なトリガー、冪等性、エラー処理、ログ記録、リトライ、人間参加型のレビューキューを備えた n8n ワークフロー JSON を設計して出力します。

使用する場面

• トリガー：
  • 毎週月曜日に実行してコンプライアンス概要をメール送信する n8n ワークフローを構築する。
  • このワークフローにエラー処理とリトライを追加し、失敗時のレビューキューも用意する。
  • 実行ごとにログを記録し、トラッカーにステータス行を書き込む Webhook ワークフローを作成する。
  • 再実行時にレコードが重複しないよう、この n8n フローを冪等にする。
  • このワークフローに監査ログと人間による承認ステップを追加する。
• 使用しない場面……
  • n8n を使わないコードのみの自動化が必要な場合（スクリプト／CI スキルを使用してください）。
  • セキュリティ制御を回避したり、監査証跡を隠したりする必要がある場合。
  • 禁止されている商品／サービスの購入や推奨が必要な場合。

入力

• 必須：
  • ワークフローの目的：トリガーの種類＋スケジュール／タイムゾーン＋成功条件。
  • 書き込み先：結果を書き込む場所（メール／Drive／Sheet／DB）と必須フィールド。
• 任意：
  • 変更対象となる既存の n8n ワークフロー JSON。
  • サンプルペイロード／レコード例。
  • 重複排除キーの定義（レコードを一意に識別する条件）。
• 例：
  • Cron：月曜日 08:00 Europe/London、概要メールを送信＋Drive にアップロード
  • Webhook：JSON を受信し、フォルダーに振り分ける

出力

• デフォルト（読み取り専用）：ワークフロー設計仕様（ノード、データ契約、障害モード）。
• 明示的に依頼された場合：workflow.json（n8n にインポート可能な JSON）＋ runbook.md（テンプレートを使用）。 成功条件＝ワークフローが冪等で、実行ごとにログを記録し、安全にリトライし、失敗をレビューキューに振り分けること。

ワークフロー

1. トリガーを明確にする：
   • Cron／Webhook／手動、スケジュール／タイムゾーン、同時実行に関する要件。
2. データ契約を定義する：
   • 入力スキーマ、必須フィールド、検証ルール。
3. 冪等性を設計する：
   • リトライ時の重複を防ぐため、重複排除キーと保存先（DB／Sheet）を選ぶ。
4. 可観測性を追加する：
   • run_id を生成し、開始／終了をログに記録して、ステータス行とエラー詳細を保存する。
5. エラー処理を実装する：
   • ノードごとのエラーブランチ、バックオフ付きリトライ、最終的な失敗通知。
6. 人間参加型（HITL）のレビューキューを追加する：
   • 失敗したアイテムをキュー（Sheet／DB）に書き込み、再処理には承認を必須とする。
7. 「サイレントな失敗を許さない」ゲート：
   • 件数／しきい値の条件を満たさない場合は、ワークフローを停止してアラートを送信する。
8. 出力：
   • JSON を求められた場合：n8n にインポート可能なワークフロー JSON＋runbook を作成する。
9. 次の場合は停止してユーザーに確認する：
   • 書き込み先のシステムが不明な場合、
   • 重複排除キーが存在しない場合、
   • 認証情報の方針（環境変数）が指定されていない場合、
   • まだ承認されていない特権アクセスがワークフローに必要な場合。

出力形式

n8n ワークフロー JSONを出力する場合は、次の形式に従ってください。

{
  "name": "<workflow name>",
  "nodes": [ { "name": "Trigger", "type": "n8n-nodes-base.cron", "parameters": {}, "position": [0,0] } ],
  "connections": {},
  "settings": {},
  "active": false
}

また、assets/runbook-template.md を使用して runbook.md も出力してください。

安全性とエッジケース

• デフォルトは読み取り専用です。明示的に依頼された場合にのみワークフロー JSON を出力してください。
• JSON にシークレットを含めないでください。環境変数／認証情報名のみを参照してください。
• 監査ログと失敗通知を含め、データが気付かれないまま失われる可能性のあるワークフローは避けてください。
• 最小権限を優先してください。必要な API のみを呼び出し、スコープを最小限にしてください。

例

• 入力：「毎週月曜日の Cron でコンプライアンス概要をメール送信し、失敗をリトライする。」
  出力：ノードマップ＋Cron → Fetch → Aggregate → Email の workflow.json。エラーブランチはレビューキューに接続します。

• 入力：「実行をログに記録し、ステータス行を書き込む Webhook。」
  出力：Webhook → Validate → Process → Append status row。エラー時はログ記録＋通知＋キューへの登録。