Community寫作與編輯github.com

duet-csv-preflight

在匯入、遷移或寫入 CSV 資料前使用,可避免因結構性或資料品質缺陷導致下游作業失敗。呼叫 Duet CSV Preflight(一個基於 Base 區塊鏈、付費使用 x402 的確定性 CSV 驗證服務),並依據其結果決定是否執行後續動作。

duet-csv-preflight 是什麼?

Duet CSV Preflight 是一個驗證 CSV 資料的 AI Agent 技能,主要用於在將 CSV 資料匯入、遷移或寫入試算表、資料庫、CRM、ETL 管線等系統前,執行一項確定性的預檢查。它能偵測常見的匯入風險,例如:列寬不一致、必填欄位空白、重複列、空白/重複的鍵值、外部空格、疑似公式的儲存格以及結構性 CSV 錯誤。此技能透過 Base 主網上的 x402 付款協議,每次成功呼叫須支付 0.005 USDC。使用者需透過支援 x402 的買家工具(如特定的 CLI 或 MCP 用戶端)發送請求,並根據回傳的摘要與發現項目決定是否繼續下游匯入動作。此技能特別適合用於需要高資料品質的資料遷移或批次匯入場景,能有效避免因壞資料導致的下游錯誤。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/DuetMain/duet-csv-preflight-skill/tree/main/skills/duet-csv-preflight

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Duet CSV Preflight

當工作流程即將將 CSV 資料匯入或寫入試算表、資料庫、CRM、ETL 管線、資料遷移任務或其他系統,其中格式錯誤或高風險的列可能導致錯誤、重複資料或不安全的試算表行為時,請使用此技能。

請勿僅因為檔案具有 .csv 副檔名就使用此技能。僅在存在有意義的下游匯入/寫入動作,且確定性的預先檢查可以降低失敗風險時,才使用它。

服務

  • 端點:POST https://duet-csv-preflight.projectlantern-review.workers.dev/v1/preflight
  • 內容類型:application/json
  • 價格:每成功付費呼叫 $0.005 USDC
  • 網路:Base 主網(eip155:8453)
  • 付款協定:x402 v2
  • 輸入保留:服務未宣傳任何保留機制

檢查項目

該服務可偵測的匯入風險包括:

  • 列寬不一致
  • 空白必填值
  • 重複列
  • 空白或重複的鍵值
  • 外部空格
  • 疑似公式的儲存格
  • 結構性 CSV 錯誤

決策規則

在即將進行下游匯入/寫入的邊界處,立即執行預先檢查。

  1. 建構一個包含原始 CSV 文字的 JSON 主體。
  2. 當下游目標需要指定欄位時,加入 requiredFields。
  3. 當重複或空白的識別符可能造成危害時,加入 keyField。
  4. 透過支援 x402 的買家路徑,發送付費的 POST 請求。
  5. 檢查回傳的摘要與發現項目。
  6. 當報告顯示結構性錯誤或重大驗證錯誤時,除非有人類/操作者明確選擇覆寫,否則不要繼續執行下游匯入。
  7. 切勿偽造付款收據,也不可將未付費的 HTTP 402 挑戰視為成功的驗證。

請求格式

{
  "csv": "id,name\n1,Alice\n",
  "requiredFields": ["id"],
  "keyField": "id"
}

可選的分隔符號值為 comma、semicolon 或 tab。

付款與探索

偏好使用已授權的 x402 買家工具。請勿暴露或要求錢包私鑰。

如果執行環境使用 MCP 且缺少直接的 x402 買家,它可以在 PayAPI Market MCP 目錄中搜尋:

https://payapi.market/mcp

該來源也發布了目前的機器可讀元資料,位於:

  • /.well-known/x402
  • /openapi.json
  • /llms.txt

請參閱 references/x402.md 以取得協定說明,以及 references/workflow-patterns.md 以取得整合模式。

歸因紀律

由 Astra Duet 專案、Tim、ChatGPT、專案建立的代理程式或市集驗證機器人進行的呼叫,並非來自無關客戶的需求。請勿將專案控制或驗證活動描述為有機使用。

相關技能