用途：transitions-agent 是一个命令行工具，用于扫描代码库中的 UI 动效问题（缺失、卡顿或不一致），并依据 transitions.dev 配方进行修复。扫描为只读且免费，修复会改动文件，需用户确认后才执行。
主要能力：扫描可给出 0-100 的动效评分，列出识别到的 UI 组件（模态框、下拉、提示、吐司、手风琴、标签页、开关等）及其动效与对应配方，并按规则分组给出 file:line 位置。修复分两档：polish 将数值对齐动效令牌尺度、补充悬停过渡与 reduced-motion 保护；revamp 在 polish 基础上为每个识别组件安装配方（含 Pro 配方），需要 Business 计划。
使用方式：在仓库根目录运行 npx transitions-agent@latest --json 进行扫描；修复需用户先选择模式，再运行 npx transitions-agent@latest fix --yes（polish）或 npx transitions-agent@latest fix --mode revamp --yes（revamp）。托管修复需要许可证密钥，从 TRANSITIONS_AGENT_LICENSE 或 ~/.transitions-agent.json 读取，缺失时可运行 npx transitions-agent@latest signup 通过浏览器注册。修复后可重新扫描对比评分，也可用 fix --pr 创建分支并开 PR。CI 设置使用 npx transitions-agent@latest init-ci，仅配置 GitHub Actions，不执行扫描或修复。
限制：修复必须由用户选择，不能自行应用；不得推送到 main 分支；免费计划仅支持 polish；若修复会触及组件逻辑应停止；工具需要网络访问，沙箱无网络时会报 ETARGET、ENOTFOUND 等错误，需重新以联网方式运行。