SuperAPI AI 工具集

apply-yliu-frontend-practices

前端与建站

查看项目

更新于 10-16 05:02

技能介绍

用途:对浏览器端 React、Vue 前端代码应用 Yliu 的个人工程实践,适用于编写、重构和代码审查,不处理服务端模块。

优先级:先满足用户本次明确要求,其次遵循项目已稳定使用的规范、封装和依赖,最后才用本技能默认实践。使用前先检查依赖清单和任务涉及的现有实现,复用项目已有成熟方案,不并行引入功能重复的库,也不为应用本技能迁移无关代码。

按需读取规范:涉及 Axios、API 模块、请求 Hook、业务错误或操作反馈时读 requests-and-feedback.md;涉及 Hook/Composable 抽取、请求执行时机、路由性能、详情页或 Pinia 数据来源时读 hooks-and-routing.md,网络 Hook 同时读请求规范;涉及 Loading、Error、Empty、布局稳定、危险操作、组件库、UnoCSS 或样式时读 ui-states-and-styling.md;涉及新增、调整或审查测试时读 testing.md。不要默认加载全部引用,按任务范围选择。

执行方式:编写或重构时,读取相关引用文件,查看同类代码与依赖确认约定,只做最小改动,保持风格一致并应用默认实践,运行与风险相称的检查。代码审查时读取相关引用,只报告真实可定位的问题,说明影响与最小修复方向,按严重程度排序,不把个人偏好当缺陷;用户未要求修复时不直接改代码。

核心约束:不猜测业务成功状态,优先从项目查找,仍不清晰时询问用户;不让公共抽象隐式启动当前页面不需要的请求;不让详情页依赖上一页内存状态,使用 URL 核心参数请求当前详情;不重复展示请求反馈,也不把失败伪装成成功返回值;不为复用制造万能组件、薄包装 Hook 或新的重复依赖;不测试普通文案和易变展示细节,除非用户明确要求。