← Back to Skills Marketplace
32
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install data-query-integrity
Description
数据查询完整性强制检查。API查询/汇总/统计任务必执行。校验has_more、分页完整性、禁止脑补。
README (SKILL.md)
数据查询完整性强制检查
触发条件
当任务涉及以下任一场景时,必须执行本 Skill 的全部流程:
- 调用飞书日历、文档、多维表格等 API 查询数据
- 对查询结果进行汇总、统计、分类
- 向用户输出基于 API 返回的数据列表
强制流程(不可跳过)
Step 1: 查询前 — 拆分范围
- 日历查询超过 3 天:按天分段,每天独立查询
- 列表类查询预估可能超上限:主动分页
- 记录计划查询的时间段和分段策略
Step 2: 查询后 — 完整性校验(每次查询后立即执行)
逐条检查以下项目,全部通过才能使用数据:
-
has_more 检查
has_more: false→ ✅ 数据完整has_more: true→ ❌ 必须用 page_token 继续分页,直到has_more: false- 响应中无
has_more字段 → ⚠️ 数据可能被截断,缩小范围重查
-
error 检查
- 响应包含
error字段 → ❌ 查询失败,告知用户并重试 - 超时/网关错误 → 缩小范围重试,不得用部分数据凑数
- 响应包含
-
数据量合理性检查
- 返回条数为 0 → 确认查询条件是否正确
- 返回条数异常少(相比预期)→ 标记"数据可能不完整"
Step 3: 输出前 — 逐条溯源
对将要输出的每一条记录:
- 确认该记录的每个关键字段(人名、职位、时间等)能在原始 API 返回中找到精确匹配
- 找不到 → 不输出该条,不得推测补全
- 如果任何字段是推断/补全的 → 标记为"[数据缺失]"
Step 4: 输出时 — 声明数据来源
在汇总结果开头或结尾,必须包含:
- 执行了几次 API 查询
- 每次查询的
has_more状态 - 如有任何数据不完整,明确告知用户"以下数据可能不完整"及缺失范围
绝对禁止
- ❌ 在 API 返回中找不到的人名/职位/数据,不得出现在输出中
- ❌ 不得因为"看起来应该有"而补全数据
- ❌ 不得用推测填充截断后的数据空白
- ❌ 不得在
has_more: true时停止分页就直接输出
违规自检
输出前问自己:
"这条记录的每个字段,我都能在 API 返回的 JSON 中找到原文吗?"
如果有任何一条回答"不能" → 删除该条,不得输出。
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install data-query-integrity - After installation, invoke the skill by name or use
/data-query-integrity - Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Frequently Asked Questions
What is Data Query Integrity?
数据查询完整性强制检查。API查询/汇总/统计任务必执行。校验has_more、分页完整性、禁止脑补。 It is an AI Agent Skill for Claude Code / OpenClaw, with 32 downloads so far.
How do I install Data Query Integrity?
Run "/install data-query-integrity" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Data Query Integrity free?
Yes, Data Query Integrity is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Data Query Integrity support?
Data Query Integrity is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Data Query Integrity?
It is built and maintained by Irving (@xiyinli811-crypto); the current version is v1.0.0.
More Skills