SuperAPI AI 工具集

rails-application-ui-blocks

编程与开发

查看项目

更新于 10-16 03:46

技能介绍

用途:在 Rails 视图(ERB)中选用、改造并集成 templates/application-ui 中的高级 UI 区块,覆盖新建页面与重构现有页面两种场景。

主要能力:先判断模式(new-page 新建功能/页面,refactor-page 重构现有视图或局部模板),再确认约束,包括所需交互(Turbo Frames/Streams、Stimulus targets/actions、表单语义)、无障碍要求(label、键盘流程、ARIA)以及现有组件边界(partials、helpers、共享布局)。随后按 references/selection-playbook.md 与 references/template-catalog.json 挑选候选区块,并以最小改动方式集成:先替换外壳,再分段,最后处理微组件,分步替换并运行相关测试。

选择顺序:新建页面时,从 ui.page-examples.* 确定页面结构,用 ui.application-shells.* 选外壳,用 ui.headings.* 加标题,再加正文区块(ui.forms.、ui.lists.、ui.data-display.、ui.feedback.),最后处理导航与浮层(ui.navigation.、ui.overlays.)。重构时保留现有信息架构与交互契约,逐区域映射到候选区块并一次替换一个区域,复用被证明后才抽取为 partial。

使用方式:作为技能加载后按上述工作流执行。维护时可重新生成目录:python3 .agents/skills/rails-application-ui-blocks/scripts/build_template_catalog.py --root .

限制与护栏:不得在未明确要求时修改 controllers、models 或 policies;不得删除 data-controller、data-action、data-turbo-、aria- 或表单字段名而不提供替代;优先适配项目样式,避免引入冲突的视觉体系;若原生组件已满足需求,不应重复插入同类区块。任务完成时需输出所选 catalog ID、使用的源模板路径、引入的行为/无障碍差异,以及刻意未替换的部分及原因。