用途：ARD（Agentic Resource Discovery）让 AI 客户端在运行时通过搜索发现智能体、MCP 服务器、技能和 API，而非硬编码。本技能帮助编写、校验、测试和维护两类产物：静态能力清单 ai-catalog.json，以及动态 Agent Registry（索引清单并响应 POST /search）。
核心概念：清单条目中的 identifier 是永久 urn:air: URN（身份），url/data 是可移动端点（位置）；不要把主机名写进 URN，也不要把 URL 当身份。
主要能力与工具（均为 Python 3.8+ 标准库脚本，validate_catalog.py 优先用 jsonschema，缺失时回退内置检查）： scripts/validate_catalog.py <path-or-url> [--json] [--strict] 校验清单；scripts/test_registry.py <base-url> [--query T] [--json] 探测实时注册表的 /search、/agents、/explore；scripts/new_catalog.py --template minimal|enterprise|local-dev [--publisher D] [--host N] --out F 生成清单模板；assets 下含 ai-catalog.schema.json、ard-entry.schema.json 及模板。
使用方式：按任务选择工作流——创建清单用 new_catalog.py 脚手架，为每个资源设置 identifier、displayName、type 及 url 或 data 之一，补充 description、tags、capabilities 和 representativeQueries；校验用 validate_catalog.py，按 ERROR/WARN/INFO 修复；测试注册表用 test_registry.py；维护时保持 URN 稳定，仅改 url/data，更新 version 与 updatedAt。
适用场景：企业或公开命名空间下的资源发布、注册表 API 合规性检查、CI 中校验（--json/--strict）。
限制：score 表示相关性而非信任，安全判断需独立验证 trustManifest；publisher 段须为可验证 FQDN，localhost 与裸词不合规；url 与 data 只能保留其一。具体收费、价格与平台信息暂未提供。