Community写作与编辑github.com

duet-csv-preflight

在导入、迁移或写入 CSV 数据之前使用,以避免因结构或数据质量问题导致下游失败。调用基于 Base 链的确定性 x402 付费 CSV 预检服务 Duet CSV Preflight,并根据其结果决定是否执行下游操作。

duet-csv-preflight 是什么?

Duet CSV Preflight 是一个用于 CSV 数据导入前预检的智能体技能。它在工作流即将将 CSV 数据写入电子表格、数据库、CRM、ETL 管道、迁移任务或其他系统时发挥关键作用,可检测行宽不匹配、空白必填值、重复行、空白或重复键、外层空白、类似公式的单元格以及结构错误等多种导入风险。该技能通过 x402 支付协议在 Base 主网上调用确定性验证服务,每次成功付费调用花费 0.005 USDC。它要求在工作流的下游导入/写入边界之前立即运行,并严格根据返回的摘要和发现项决定是否继续操作——若发现结构错误或实质性验证错误,除非用户明确覆盖,否则不应继续。该技能适用于 Claude Code、Cursor、Codex 等支持付费 API 调用的 AI 代理平台,特别适合需要高数据质量保证的自动化数据处理流程。

兼容平台~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
  • Content-Type: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、项目创建的代理或市场验证机器人发起的调用并非无关的客户需求。不要将项目控制的或验证活动描述为有机使用。

相关技能