SuperAPI AI 工具集

ryux-frontend

前端与建站

查看项目

更新于 10-20 18:13

技能介绍

ryux-frontend 是 RYUX 技能体系中的前端实现技能,属于工程组(Group Engineering),归于交付门槛中的代码质量领域(RX-2.0),技能等级定义见 ryux-core。它的目标是把设计决策与最终交付的代码连接起来。

用途 该技能在编写或修改前端代码时加载,用于约束实现方式,使代码符合仓库自身的既有约定,并避免虚构业务逻辑。它不负责视觉设计判断(由 ryux-ui 覆盖),也不负责组件复用决策(由 ryux-design-system 覆盖)。

主要能力与规则

  1. 先识别技术栈(RX-FE-01,必需):在写 UI 代码前读取 package.json、路由、样式方案以及两三个邻近组件,沿用项目已有的框架、样式方式和模式,不假设项目使用 React、Tailwind 或某个组件库。
  2. 语义优先:先使用语义化 HTML 与原生控件,再考虑自定义控件。
  3. 组件与状态:按职责拆分组件;状态放在靠近使用它的地方;用派生值代替重复状态。
  4. 样式:使用设计令牌而非魔法数字,不重复定义样式。
  5. 不得发明逻辑(RX-FE-02,必需,硬性门槛):价格、限制、权限和规则须来自数据、配置或 API;未知项标注为假设;不硬编码无人指定的业务规则或 API 行为。
  6. 可操作的错误提示(RX-FE-05,必需):错误消息应说明需要修复什么,面向用户时使用用户语言;不静默吞掉错误,也不向用户展示原始开发者信息。
  7. 注释说明原因(RX-FE-06,推荐):注释解释代码背后的理由,不写只复述字段、类型或函数名的文档注释。
  8. 贴合代码库(RX-FE-07,推荐):遵循周围文件的格式、命名与模式;按内容或行为命名;清理未使用的代码、导入和被注释掉的代码块;不引入新风格,不使用无上下文的 data、temp、helper 等命名,不留下死代码和空 TODO。
  9. 卢比格式化(RX-FE-12,情境性):仅当产品面向印尼市场并展示卢比时适用,使用 id-ID 分组格式并自行前置 “Rp”,不单靠 Intl 货币样式(其会在 Rp 后插入空格);其他市场使用 Intl 与用户所在区域设置,不添加无人要求的市场分支。
  10. 依赖与性能:依赖须明确体现其价值;媒体资源设置尺寸并懒加载;不为小效果引入重型库。

证据来源 仓库本身是主要证据(技术栈、组件、令牌);参考截图影响行为而非代码。若无 ryux MCP,应说明证据仅来自设计和规范。

硬性门槛 无论加载哪些技能,硬性门槛始终适用:不发明数字、人物、紧迫性、业务规则或条款;不把占位内容作为最终产物交付;不遗漏关键状态(详见 ryux-core)。

适用场景 适用于在既有前端仓库中新增或修改 UI 代码、处理错误提示、整理样式与状态、检查硬编码业务规则等场景。

限制 不涉及视觉设计决策与组件复用决策;部分规则为推荐或情境性,需结合具体项目;关于收费、平台支持等信息暂未提供。