SuperAPI AI 工具集

regulationsgov-comment-detail-fetch

通用与其它

查看项目

更新于 10-16 04:57

技能介绍

用途:该技能用于按评论 ID 从 Regulations.gov v4 的 GET /comments/{commentId} 拉取评论详情资源。ID 可从命令行传入,也可从 txt、json、jsonl 文件读取,并可选用 include=attachments。结果以机器可读 JSON 返回,可选保存 JSONL 产物,并用结构化日志(可选日志文件)记录执行过程。

主要能力:支持 check-config 校验生效配置;dry-run 预演输入解析与请求计划;支持从上游 comments JSONL 输出批量取详情。内置健壮性包括:对 429/500/502/503/504 等瞬时失败做指数退避重试,遵循 Retry-After 并在超过配置上限时快速失败,对请求间隔限流,按 REGGOV_MAX_COMMENT_IDS_PER_RUN 限制单次 ID 硬上限。还做传输与结构校验:状态码、content-type、UTF-8、JSON 检查,详情资源形状检查(data.id、data.type、attributes),关键时间字段的日期时间格式检查。支持问题隔离目录和批量部分失败模式。

使用方式:先配置环境变量,可从 assets/config.example.env 开始,运行前用 set -a; source assets/config.example.env; set +a 加载。随后可执行 check-config;或用 fetch 加 --comment-id、--comment-ids-file、--max-comments、--include、--dry-run、--output-dir、--quarantine-dir、--no-fail-on-item-error、--log-level、--log-file、--pretty 等参数。严格校验时可用 --fail-on-item-error、--fail-on-validation-error,并检查 failure_count 与 validation_issue_count。命令示例保持资料中的写法。

适用场景与限制:适合作为 OpenClaw 技能调用,触发名称为 $regulationsgov-comment-detail-fetch,单次调用消费一组 ID,上游编排可由 $regulationsgov-comments-fetch 提供 ID。该技能只做按评论 ID 的详情抓取这一原子操作,不包含评论列表发现逻辑,不包含内部调度或轮询循环。其他细节如具体环境变量含义、API 说明和限制见资料所列 references 文件。