1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | arize-annotation(合集仓库 Arize-ai/arize-skills 子技能) |
| 作者/维护者 | Arize AI(官方,LLM 可观测性平台厂商) |
| 来源链接 | https://github.com/Arize-ai/arize-skills/tree/main/skills/arize-annotation |
| 许可证 | MIT(GitHub API 核实) |
| GitHub Stars | 47(整仓库,GitHub API;合集仓库星数不代表本子技能个体热度) |
| Forks | 8(整仓库,GitHub API) |
| 最新版本 | v1.2.0(2026-07-30 发布,整仓库统一版本号);该子技能自身最近一次专属提交为 2026-08-17(GitHub commits API 按路径核实,6 位具名贡献者) |
| 安装方式 | npx skills add / git clone + install.sh / ax CLI(ax skills install)/ Claude Code 插件市场 |
2. 功能介绍与亮点
指导 agent 在 Arize 平台上创建与管理标注配置(annotation configs,即人工反馈的标签模式)与标注队列(annotation queues,即人工审核工作流),并通过 Python SDK 把已有标签批量写回生产 spans。技能覆盖三条主线:标注配置 CRUD——支持分类型(固定选项)、连续型(数值范围)、自由文本型三种模式,创建时需指定优化方向(分数越高越好还是越低越好,用于 UI 趋势展示);标注队列——把 spans 或数据集样本按项目、时间范围或 ID 批量灌入队列,指派审核人邮箱,支持“全部审核”或“随机抽样”两种分配方式,并提供逐条提交标注、批量分配的命令;Python SDK 批量回写——已有外部标注结果(如导出自其他审核工具)可通过 DataFrame 一次性写回多个 spans 的 context.span_id。亮点:正文明确标注“操作不可逆”的边界(删除配置/队列前提示确认,--force 才能跳过);凭据处理专门写明“绝不读取 .env 或搜索文件系统找密钥,只用 ax profiles,绝不要求用户把密钥粘贴进对话”,且历史提交记录里有一条专门的安全修复“fix(skills): keep secrets out of coding agent chat”,说明维护方对这条红线有持续关注;正文明确标出与同仓库 arize-trace(批量标注 spans 的数据来源)、arize-dataset(标注数据集示例)、arize-experiment(标注实验运行结果)的分工衔接。
3. 适用场景
固定分类:工程效率与代码质量。典型场景:已用 Arize 做 LLM 应用评测/可观测性的团队,需要为生产 spans、数据集示例或实验输出建立可复用的人工标注标签体系;需要把人工审核工作流程化——按项目/时间范围批量灌入待审核记录、指派特定审核人、跟踪审核进度;需要把外部标注工具(人工众包平台、内部审核系统)产出的标签结果批量回写进 Arize 追踪数据的场景。
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持——README 明确列出,另提供专门的
/plugin marketplace add Arize-ai/arize-skills安装路径 - Codex:✅ 原生支持——README 明确列为受支持 agent 之一
- OpenClaw:⚠️ 需通过通用安装器——Arize 官方文档未点名 OpenClaw,但推荐的
npx skills add安装器(vercel-labs/skills)官方支持列表明确列出 OpenClaw,会自动放入其skills/目录;技能内容为标准 SKILL.md 格式,不含 Claude 专有依赖 - Hermes Agent:⚠️ 需通过通用安装器——同上,安装器官方列表列出 Hermes Agent(放入
.hermes/skills/),Arize 未单独测试确认
5. 推荐理由
多数“人工审核/标注”类工具要么是通用表单封装,要么与具体的可观测性平台脱节、标完的结果还得手动导回系统。本技能背后是 Arize 平台真实的标注配置与队列基础设施,标注结果直接落在 spans/数据集/实验记录上,与同仓库的追踪导出、数据集、实验技能天然打通——不是孤立的打标签工具,而是“生产追踪 → 人工审核 → 结果回写 → 参与后续评测”闭环里的一环。对已经把 Arize 用作 LLM 应用可观测性平台、且需要人工把关模型输出质量的团队,这是把审核流程从“导出 CSV 手工分发”升级为可追踪、可分配、可回写的现成路径。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 官方 Arize AI(LLM 可观测性平台厂商)出品并持续维护;仓库整体仅 47 星,经 GitHub 与 Web 检索均未发现该子技能自身的独立第三方讨论 |
| 可用性 | 8 | SKILL.md 正文约 13.7KB,另附 2 份共享参考文档(CLI 安装、profile 配置,共约 7.4KB),含完整 CRUD 工作流、DataFrame 字段表、故障排查表;npx skills add 一条命令安装;该子技能最近一次专属提交为 2026-08-17(近日活跃,6 位具名贡献者) |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单:
① shell 命令执行——仅通过 ax CLI 与 Arize 自有 API 交互,无任意 shell 执行;删除操作默认要求交互确认,--force 才能跳过
② 联网外发——仅联系用户自己配置的 Arize 工作区(自有账号数据),无第三方外发
③ 凭据处理——正文明令“绝不读取 .env 或搜索文件系统找密钥,只用 ax profiles,绝不要求用户把密钥粘贴进对话”,API Key 通过环境变量引用、从不内联传参
④ 无可疑指令——通读全文未见混淆代码或隐蔽外发,指令均为正常 CLI 操作说明;提交历史中有专门的“防止密钥泄漏进对话”安全修复记录
⑤ 作者信誉——Arize AI 为知名 LLM 可观测性厂商,通过 SOC 2 Type II、ISO 27001 等认证
⑥ License——MIT,明确
⑦ 最近维护——仓库整体最近推送 2026-08-18;该子技能最近一次专属提交 2026-08-17,来自 6 位具名贡献者的近期迭代记录
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 差异 |
|---|---|---|
| Label Studio(heartexlabs/label-studio) | 独立开源数据标注平台,支持文本/图像/音频/视频多模态标注,本地部署或云托管 | 通用型标注工具,覆盖场景更广但需要独立部署与维护标注平台;本技能标注结果直接落在 Arize 已有的 spans/数据集/实验记录上,不需要额外搭建标注系统,代价是绑定 Arize 平台账号 |
| Braintrust 标注功能 | 商业 LLM 评测平台自带的人工评分功能,与其实验/日志系统集成 | 同为“平台自带标注”路线,但绑定 Braintrust 生态;本技能面向已选择 Arize 作为可观测性平台的团队,标注可与同仓库的追踪导出、数据集构建、实验技能直接串联 |
| Prodigy(explosion/prodigy) | 面向 NLP 模型训练的主动学习标注工具,本地运行、按标注会话收费 | 定位训练数据标注而非生产可观测性场景的人工审核;本技能标注对象是已在生产环境产生的 spans/评测记录,服务于“回顾已发生的模型行为”而非“为训练新模型造数据” |
8. 用户评价
该技能目前在 GitHub Issues/Discussions、Reddit、Hacker News 等第三方平台均未见针对该子技能自身的具名用户评价;所属仓库未开启 GitHub Discussions 功能。
9. 其他补充
同仓库另有 arize-trace(导出生产追踪数据,为批量标注 spans 提供来源)、arize-dataset(标注数据集示例)、arize-experiment(标注实验运行结果)、arize-evaluator(LLM-as-judge 自动打分,可与人工标注互为补充)、arize-link(生成指向标注配置/队列的 Arize UI 深链接)等配套子技能,共同构成“自动评测 + 人工审核”并行的质量把关体系。
10. 安装使用方式
- 推荐:
npx skills add Arize-ai/arize-skills --skill arize-annotation --yes(自动识别当前 agent) - Claude Code 插件市场:
/plugin marketplace add Arize-ai/arize-skills后/plugin install arize-skills@arize-skills - 已装
axCLI(v0.27.0+):ax skills install(交互式选择) - git clone 后运行
./install.sh --project <项目目录>(Windows 对应install.ps1) - 安装后首次使用需先跑
ax profiles show确认已配置 Arize API Key(未配置时技能会引导创建),随后按需触发创建配置、建队列、提交标注等工作流
11. 注意事项
- 删除标注配置为不可逆操作,且会连带移除该配置在队列中的关联(队列本身保留,需在 Arize UI 手动修复关联)
- 标注队列的“更新”操作对列表型字段(如关联的配置/审核人)是全量替换而非追加,遗漏未列出的旧值会被移除
- 通过 Python SDK 批量回写标注仅对提交前 31 天内的 spans 生效,超期数据无法追加标注
- 该子技能是 Arize-ai/arize-skills 合集仓库的一部分,仓库 Star 数(47)由全部 14 个子技能共享,不代表本技能自身热度