用途 vaadin-usage-review 用于审查 Vaadin 代码中“官方已有 API 或组件、却仍写了自定义变通或 hack”的地方，尤其针对写代码时未查官方文档、凭记忆实现的情形。该技能只生成问题报告，不修改、不修复、不暂存任何文件。
主要能力
- 组件选用审查：识别用原生 HTML 元素（Div、Span、Input、NativeButton、new Element、Html、.tsx 中的原生标签）或手工样式标记承担 Vaadin 组件职责的情况，例如输入框、按钮、布局、徽章、卡片、对话框、列表、进度条等，并给出官方等价组件。
- 服务端与前端写法审查：核查 executeJs/callJsFunction、直接操作元素属性、内联样式、手工分页/过滤排序、自建线程轮询推送、React 视图中直接 fetch、手工对话框或通知、绕过 Binder 的表单校验、字符串拼接路由、自定义权限判断、使用已废弃 API 等可疑模式，并对照 Vaadin MCP 确认官方替代方案。
- 样式审查：检查 Aura 项目中误用 --lumo-、Lumo 项目中误用 --aura- 等另一主题的 CSS 自定义属性。
- 项目自有 JavaScript/TypeScript 审查：检查对 vaadin-* 组件的 monkey-patching、读写私有成员、轮询等待组件就绪、手工派发合成事件、绕过 Flow 同步等对内部实现的依赖。
使用方式 先调用 get_vaadin_versions 确认 Vaadin MCP 可用；不可用则立即停止并提示启用 MCP 后重跑。然后从仓库确定 Vaadin 版本、开发模型（Flow、Hilla/React 或两者）与主题（Aura 或 Lumo），并在报告开头说明。范围不明确时先询问用户，可基于 git 状态建议“变更文件、已暂存文件、指定文件/包、整个项目”等选项。审查只覆盖与 Vaadin 相关的文件，排除 node_modules、target、build、generated、压缩文件及依赖代码；按每批约 3–6 个文件分批审查，可由子代理并行处理。所有结论必须经 MCP 工具验证并标注来源，验证为正确的模式不写入报告，未经验证的条目归入 Unverified。
适用场景 适用于 Vaadin 新版代码走查、AI 代理生成代码的复核、组件选型评审、主题迁移前的样式检查，以及提交前排查是否存在可被官方 API 替代的自定义实现。
限制 该技能不修改代码，不提出补丁，也不判断官方 API 之外的设计优劣；不审计依赖或生成代码；不评估赋给当前主题自身属性的取值，只发现误用另一主题属性的情况；组件选用审查设置了防误报门槛，裸露的结构性 Div/Span 不报告，只有在官方组件存在且原生写法没有经 MCP 验证的具体优势时才建议替换，商业组件会注明需要订阅，但不提供价格。MCP 不可用时不做任何审查。