用途:当新增或移除 Reverie 域 schema、reverie-inventory CI 检查失败、想核对清单与 schema 注册表是否一致、修改已有 schema 字段数、增删 atmosphere 条目时,使用本技能更新清单。
涉及文件包括:.github/reverie-inventory.json(schema 计数与元数据的事实来源)、libs/engine/src/lib/reverie/index.ts(schema 注册表与域目录)、types.ts(DomainId 联合类型)、atmosphere.ts(atmosphere 流形条目)、schemas/**/*.ts(各域 schema 文件)以及 docs/specs/reverie-spec.md。
主要能力与流程:统计 schema .ts 文件数、各 schema 字段数与 atmosphere 条目数;用 jq 读取当前清单总量并对比;识别新增/移除 schema、字段数变化、DomainId 缺失、SCHEMA_REGISTRY 缺失、DOMAIN_CATALOG 缺失等差异;随后更新 .github/reverie-inventory.json 中的 schemas、fields、atmospheres、domains 及 lastUpdated、lastAuditedBy,必要时同步更新 DomainId 类型、注册表与目录,最后提交变更。
常用命令示例:find libs/engine/src/lib/reverie/schemas -name "*.ts" -type f | wc -l;grep -c "keyword:" libs/engine/src/lib/reverie/atmosphere.ts;jq '.schemas.total, .schemas.implemented, .fields.total, .atmospheres.total' .github/reverie-inventory.json;git add .github/reverie-inventory.json libs/engine/src/lib/reverie/。
适用场景与限制:适合维护 Reverie schema 清单一致性;新增域时按检查表逐项核对文件数、domains 数组、DomainId、SCHEMA_REGISTRY、DOMAIN_CATALOG、字段数、分组与阶段合计、atmosphere 数量及 lastUpdated。CI 工作流 reverie-inventory.yml 在涉及 libs/engine/src/lib/reverie/** 的 PR 上运行并在不匹配时评论,周五定时运行发现漂移时创建 issue。具体命令、路径与字段名称均以资料为准;未提供额外收费、平台或效果信息。