用途:在引擎新增或移除 UI 组件后,保持组件清单、文档与实际源码一致。触发时机包括新增组件、移除或弃用组件、component-inventory CI 检查失败、需要核对文档与真实组件数量、合并增删组件的 PR 之后。
涉及文件:.github/component-inventory.json 为组件数量的事实来源;docs/design-system/COMPONENT-REFERENCE.md 为用户文档;libs/engine/src/lib/ui/components/ 为实际组件源码。清单按 13 个类别统计(如 primitives、nature、ui、typography 等)。
使用方式:先用 find 与 wc 统计各类别 .svelte 文件数量,例如 find libs/engine/src/lib/ui/components/ui -name "*.svelte" | wc -l,或遍历各类别目录批量统计;再读取并对比现有清单,识别新增、移除或迁移的组件;然后更新 component-inventory.json 的各类别数量、总数与 lastUpdated 日期,并同步更新 COMPONENT-REFERENCE.md 的简介行、Quick Links 锚点、各章节标题中的数量、相关组件表格及末尾更新日期;最后 git add 这两个文件并提交说明性信息。
文档约定:Glass 组件始终记入 Other Glass Components 表;通用包装组件记入 Standard Components 表;nature、charts 等类别中重要或有独特属性的组件记入对应章节。CI 工作流在 PR 触及组件目录时比对实际数量与清单,不一致则失败,此时按上述流程修复。
限制:资料未说明该技能的安装方式、适用平台、权限范围与错误恢复细节,也未提供类别之外的特殊规则;具体路径与命令需以实际仓库为准。