ua1-validator-agent

TotalClaw 作者 totalclaw

使用来自 AI 编码代理（OpenClaw、Claude Code、Codex、OpenCode）的 ua1.dev 或 api.ua1.dev 根据 PDF/UA-1 验证 PDF。当代理需要确定性可访问性检查、紧凑的机器可读判决、CI 门控或 PDF 文件的结构化修复循环时使用。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw skills install shop:totalclaw:totalclaw~hajekt2-ua1-validator-agent

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~hajekt2-ua1-validator-agent/file -o hajekt2-ua1-validator-agent.md

## 概述（中文）

使用来自 AI 编码代理（OpenClaw、Claude Code、Codex、OpenCode）的 ua1.dev 或 api.ua1.dev 根据 PDF/UA-1 验证 PDF。当代理需要确定性可访问性检查、紧凑的机器可读判决、CI 门控或 PDF 文件的结构化修复循环时使用。

## 原文

# UA1 Validator Agent Skill

Use this skill to run deterministic PDF/UA-1 checks from an agent workflow.

## Endpoints

- Health: `GET https://api.ua1.dev/api/health`
- Validate: `POST https://api.ua1.dev/api/validate`
- Compact mode: `POST https://api.ua1.dev/api/validate?format=compact`
- Metrics: `GET https://api.ua1.dev/api/metrics`

## Required contract

Send multipart form-data with field name `file`.

- Accepted: `.pdf`
- Typical outcomes:
  - `200` validation response
  - `415` unsupported type
  - `413` file too large
  - `429` rate-limited

## Minimal workflow for agents

1. Run health check once before batch validation.
2. Validate each PDF using compact mode for deterministic parsing.
3. If verdict is `fail`, capture findings and group by `rule_id`.
4. Produce remediation plan sorted by rule frequency.
5. Re-run validation after fixes and compare counts.

## Use script

Run:

```bash
bash scripts/validate_pdf.sh /absolute/or/relative/path/to/file.pdf
```

Optional env:

- `UA1_API_BASE` (default: `https://api.ua1.dev`)
- `UA1_FORMAT` (`compact` by default; set `full` for full payload)

## CI gate pattern

Treat non-pass verdict as a failed quality gate.

- Exit `0` only when verdict is `pass`
- Exit `2` when verdict is `fail`
- Exit `1` for transport/API errors

Use the script’s exit codes directly in pipelines.