← 返回 Skills 市场
xiyinli811-crypto

Data Query Integrity

作者 Irving · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ pending
32
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install data-query-integrity
功能描述
数据查询完整性强制检查。API查询/汇总/统计任务必执行。校验has_more、分页完整性、禁止脑补。
使用说明 (SKILL.md)

数据查询完整性强制检查

触发条件

当任务涉及以下任一场景时,必须执行本 Skill 的全部流程:

  • 调用飞书日历、文档、多维表格等 API 查询数据
  • 对查询结果进行汇总、统计、分类
  • 向用户输出基于 API 返回的数据列表

强制流程(不可跳过)

Step 1: 查询前 — 拆分范围

  • 日历查询超过 3 天:按天分段,每天独立查询
  • 列表类查询预估可能超上限:主动分页
  • 记录计划查询的时间段和分段策略

Step 2: 查询后 — 完整性校验(每次查询后立即执行)

逐条检查以下项目,全部通过才能使用数据:

  1. has_more 检查

    • has_more: false → ✅ 数据完整
    • has_more: true → ❌ 必须用 page_token 继续分页,直到 has_more: false
    • 响应中无 has_more 字段 → ⚠️ 数据可能被截断,缩小范围重查
  2. error 检查

    • 响应包含 error 字段 → ❌ 查询失败,告知用户并重试
    • 超时/网关错误 → 缩小范围重试,不得用部分数据凑数
  3. 数据量合理性检查

    • 返回条数为 0 → 确认查询条件是否正确
    • 返回条数异常少(相比预期)→ 标记"数据可能不完整"

Step 3: 输出前 — 逐条溯源

对将要输出的每一条记录:

  • 确认该记录的每个关键字段(人名、职位、时间等)能在原始 API 返回中找到精确匹配
  • 找不到 → 不输出该条,不得推测补全
  • 如果任何字段是推断/补全的 → 标记为"[数据缺失]"

Step 4: 输出时 — 声明数据来源

在汇总结果开头或结尾,必须包含:

  • 执行了几次 API 查询
  • 每次查询的 has_more 状态
  • 如有任何数据不完整,明确告知用户"以下数据可能不完整"及缺失范围

绝对禁止

  • ❌ 在 API 返回中找不到的人名/职位/数据,不得出现在输出中
  • ❌ 不得因为"看起来应该有"而补全数据
  • ❌ 不得用推测填充截断后的数据空白
  • ❌ 不得在 has_more: true 时停止分页就直接输出

违规自检

输出前问自己:

"这条记录的每个字段,我都能在 API 返回的 JSON 中找到原文吗?"

如果有任何一条回答"不能" → 删除该条,不得输出。

如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install data-query-integrity
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /data-query-integrity 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
data-query-integrity v1.0.0 - Initial release enforcing strict data query integrity for API tasks. - Mandatory step-by-step process for API data queries, with segmentation, paging, and completeness checks. - Explicit requirements: has_more check, error and timeout handling, field-level tracing and no speculative output. - Output summaries must disclose query count, has_more status, and any incompleteness to users. - Strict prohibitions on data guessing, unverified filling, and premature output on incomplete pages.
元数据
Slug data-query-integrity
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Data Query Integrity 是什么?

数据查询完整性强制检查。API查询/汇总/统计任务必执行。校验has_more、分页完整性、禁止脑补。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 32 次。

如何安装 Data Query Integrity?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install data-query-integrity」即可一键安装,无需额外配置。

Data Query Integrity 是免费的吗?

是的,Data Query Integrity 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Data Query Integrity 支持哪些平台?

Data Query Integrity 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Data Query Integrity?

由 Irving(@xiyinli811-crypto)开发并维护,当前版本 v1.0.0。

💬 留言讨论