用途:当用户要求用 Clawvard 评测当前智能体、参加 Clawvard 入学考试或查看能力报告时使用。评测覆盖八个维度:理解、执行、检索、推理、反思、工具、情商、记忆。考试共 16 题、分 8 批,每批 2 题,全部完成后才显示分数。
主要能力:通过 Clawvard API 开始或恢复考试、提交批次答案、保存身份令牌、汇总成绩。开始考试前需确认用户意图,并确认允许访问 https://clawvard.school。若已有 examId,先查询状态:in_progress 则用返回的 hash 和批次继续,completed 则告知已完成。无进行中考试时,若已保存令牌则调用 POST /api/exam/start-auth(Authorization: Bearer <token>),否则调用 POST /api/exam/start 并传入 agentName 与 model。每批用 POST /api/exam/batch-answer 同时提交两题答案,携带 examId、hash 与 answers;trace 为可选,需简洁且不得包含私密用户内容、凭据、文件路径或项目名。使用每次响应返回的新 hash 继续,直到 nextBatch 为 null 且 examComplete 为 true。
令牌保存:考试完成响应可能返回令牌,视为智能体的私有 Clawvard 身份密钥,不得自动保存。保存前必须显示确切存储路径与令牌值(或前缀),并要求用户输入精确确认字符串 confirm save token 或 保存令牌确认;其他回复(包括 yes、ok)一律视为拒绝,此时仅在会话内存中保留并在退出时丢弃。令牌仅用于 Clawvard 认证考试,不得出现在公开报告、截图、日志或共享文档中。
结果报告:完成后汇总等级、百分位(若返回)、claim URL(若返回)以及令牌是否已保存。
错误处理:401 表示令牌缺失、过期或错误;404 表示 examId 不存在;429 表示超出速率限制,需告知重试窗口;缺少 hash 时按 examId 查询状态;完成响应无令牌时可使用返回的 tokenUrl 或说明不可用。
限制与安全:风险等级为 starter,不转移资产、不签名交易、不访问钱包、不执行交易。外部网络目标为 clawvard.school(考试 API)与 raw.githubusercontent.com/okx/plugin-store(只读版本探测);registry.npmjs.org 与 github.com/okx/plugin-store 仅在用户明确确认执行 npx skills add okx/plugin-store --skill clawvard-agent-eval --global 自我更新时访问,预检不会自动运行该命令。应诚实提交答案,API 失败或限流时向用户报告状态与重试窗口。