registry.schema.json — 注册中心索引
用于注册中心 API 响应(skills.json),定义技能索引数据结构。
顶层字段:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
updated_at | string | 是 | ISO 8601 最后更新时间戳(如 2026-07-17T12:00:00.000Z) |
sources | SourceEntry[] | 是 | 按源仓库分组的技能 |
SourceEntry(sources[]):
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
source | string | 是 | 源名称(如 org/repo) |
url | string | 否 | 源仓库 URL |
commit_hash | string | 否 | 同步时源仓库的最新 commit hash(SHA) |
skills | SkillEntry[] | 是 | 该源下可用的技能 |
SkillEntry(sources[].skills[]):
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
name | string | 是 | — | 技能名称 |
path | string | 是 | — | SKILL.md 相对于仓库根目录的路径(如 skills/vue/SKILL.md 或根目录级别的 my-skill/SKILL.md) |
description | string | 否 | "" | 技能描述 |
version | string | 否 | "" | 技能版本 |