Gravity UI 现已 agent-ready：认识 llms.txt 与 Gravity UI 技能

越来越多的 UI 代码不再是手写的，而是由 AI 编码智能体生成的。这也暴露了一个问题：Gravity UI 有 30 多个包，智能体往往靠猜。它们在需要 @gravity-ui/charts 时选了 @gravity-ui/chartkit，在应该使用独立的 @gravity-ui/table 的地方用了 uikit 内置的 Table，依赖过时的 API，甚至凭空编造 props 和图标名称。

今天我们发布两样东西，把猜测变成确知。

llms.txt：为智能体绘制的 Gravity UI 地图

gravity-ui.com/llms.txt 是一份面向智能体的精简目录，涵盖 Gravity UI 的全部 34 个包。它为每个包说明用途，也说明同样重要的一点：什么情况下不该用它，以及应该改用什么。

从目录出发，智能体可以深入到每个包的文档，而且文档是版本化的：

• /llms/<package>/llms.txt — 最新版本
• /llms/<package>/<major>/llms.txt — 某个主版本线内的最新版本
• /llms/<package>/<version>/llms.txt — 精确版本

目录明确要求智能体先读取你的 package.json 并对齐已安装的版本。peer 版本不匹配是我们在智能体生成的代码中最常见的失败模式。

如果你的工具已经理解 llms.txt，那就无需任何配置。如果还不支持，把这个 URL 交给你的智能体即可。

Gravity UI 技能：少走弯路

对于支持开放技能格式的智能体，我们还发布了一个技能：

npx skills add gravity-ui/skills

它可以安装到 Claude Code、Cursor、Codex、GitHub Copilot 以及 70 多个其他智能体中。这个技能帮助智能体选对包、使用最新的组件 API 和真实存在的图标名称，并正确处理 @gravity-ui/* 导入、ThemeProvider 配置和 --g-* CSS 设计令牌，覆盖仪表盘、数据表格、图表和表单等典型任务。

技能以 MIT 许可证开源：github.com/gravity-ui/skills

试一试，告诉我们哪里出了问题

安装技能，把 llms.txt 指给你的智能体，让它真正构建点什么。如果智能体仍然出错，那就是我们文档的 bug，我们想知道：欢迎在 skills 仓库 提交 issue 和 PR。