用途:创建或更新 releases.json 清单,向注册表与智能体声明公司或项目在何处发布更新说明,如 changelog、更新页、RSS/Atom、GitHub Releases、App Store 列表或托管的 CHANGELOG 文件。信任取决于文件所在位置:域名下 /.well-known/releases.json 代表整个公司,仓库根目录的文件仅代表该仓库。
主要能力与用法:选择作用域(默认域名作用域;仓库作用域需绑定产品)。发现真实发布位置并逐一验证可访问,无法验证的不要写入。支持定位键 url、feed、github、appstore、file,以及 publish: "push" 配合 path 用于推送式发布。products[] 可选,仅当产品有独立发布流时才拆分。
必要命令:node <skill-dir>/scripts/validate.mjs path/to/releases.json;curl -fsSL https://{domain}/.well-known/releases.json | node <skill-dir>/scripts/validate.mjs /dev/stdin;curl -fsS -X POST https://api.releases.sh/v1/listing/validate -H 'content-type: application/json' -d '{"domain":"{domain}"}'。
限制:version 2 必需;url/feed/appstore/file/avatar 须为 https;每个发布条目至少一个定位键;最多 24 个产品、每产品 8 个位置、每文件 32 个位置;至多一个 canonical;产品字段集严格。发布需在 https://{domain}/.well-known/releases.json 以 application/json 提供,无认证墙或重定向;v1 文件不再读取。