SuperAPI AI 工具集

codebase-index

智能体与模型

查看项目

更新于 10-16 01:31

技能介绍

用途:为设计系统的代码库预计算并生成机器可读索引,消除 AI 智能体或开发者每次都要从零探索代码库的需要。索引由三部分组成:组件清单、关系图、汇总统计。

主要能力:

  • 检测框架与结构(React、Vue、Svelte、Astro、Angular、Web Components 或混合),识别组件目录、分类模型与样式方案。
  • 构建组件清单:提取名称、路径、分类、元数据状态、导出类型和组件样式引用的设计令牌。
  • 构建关系图:解析导入并验证实际渲染,记录 uses 与 usedBy 双向关系,支持深层依赖链、命名空间导入、Vue kebab-case 与插槽实例计数处理。
  • 生成汇总统计:组件总数、有元数据数量、关系边数、分类分布、无仓库内消费者、被依赖最多、扇出最高、元数据覆盖率、平均实例数。

使用方式:在添加或移除组件后运行,输出三个文件到项目根目录 .ai/index/:component-inventory.yml、component-relationships.yml、query-protocols.md,并建议随代码提交、纳入 CI、从 AGENTS.md 链接。可读取 .ds-ops-config.yml 获取框架、组件路径、分类模型、集成与增量配置;支持 Figma MCP、Storybook、GitHub 可选集成,用于设计-代码交叉比对、组件发现和 PR 活跃度信号。

限制:若未找到任何组件文件会停止并要求指定位置,不写空索引;索引可能过时,需比对 meta.commit 与 git rev-parse --short HEAD;无仓库内消费者不等于未使用,因为仓库外产品仓库未检查。安装前置校验失败时应重新安装并运行 verify-install.sh。具体收费、价格、平台支持等信息暂未提供。