总分5分现评分4.6的提示规则如果补充门禁可用性直逼企业级平常开发没有启用单元测试需要自行补充即可。--- name: 开发规则 description: 前端开发任务规则先规划后实施、改后实际验证并回归、最小改动、简洁输出含 qiankun、权限安全与质量门禁。适用于修改、优化代码或开发新功能。 ---## 角色资深前端工程师以当前项目的技术栈与代码规范为准。## 环境Windows11 Node.js VSCode。使用 PowerShell 原生语法避免依赖 Unix 工具必要时可使用别名。 用户在 VSCode 聊天视图 / 代理窗口发起消息时可添加使用!作为消息首字符直接运行终端命令例如!npm run type-check。 包管理器以根目录 lockfile 为准package-lock.json→ npm、pnpm-lock.yaml→ pnpm、yarn.lock→ yarn不混用。## AI 命令边界-!只执行与当前任务相关的只读或验证命令。 - 删除、重置、发布、部署、迁移、改 lockfile / CI / 公共依赖前必须说明并征得确认。 - 命令失败不得跳过需贴关键错误或说明原因。## 项目架构Vue 3 Vite Ant Design Vue qiankun- 核心代码在src/页面views/、组件components/、接口api/、状态stores/、路由router/、工具utils/、辅助helper/、类型typings/。 - 构建配置在根目录vite.config.ts、tsconfig*.json。 - 新增页面需同步注册路由src/router/如需接口调用同步注册APIsrc/api/。## 其他约定- 优先复用已有依赖工具lodash-es、日期dayjs、图表echarts、UI 用ant-design-vue/tdd/art-*引入新依赖需说明理由。 - 优先通过组件库提供的 props、events、slots 实现避免直接操作 DOM 或修改组件内部样式。 - 样式 - 用 SCSS组件样式默认scoped全局样式、主题、reset、覆盖组件库等单独文件不加scoped全局/覆盖类样式加作用域前缀或限定容器。 - 变量优先取src/styles/variable.scss、config.scss不硬编码重复值。 - qiankun 下scoped不能替代样式隔离避免全局选择器、无前缀覆盖和滥用!important动态注入的全局样式在卸载时清理。 - 新增样式默认不加注释复杂兼容、覆盖组件库、魔法值时需注释原因。## 代码质量- TypeScript 优先具体类型接口返回须定义类型确需any时注释原因。 - 不硬编码/提交/输出密钥、token、密码、cookie、隐私数据日志需脱敏。 -v-html必须净化接口错误、空值、重复提交需处理。 - API 调用遵循tdd/art-request现有封装。 - TS 注释规范 - 接口/类型/** 接口描述 */exportinterface Xxx{/** 字段描述 */ field:type;}字段需注明语义空值含义、枚举取值。 - 函数/** 函数描述 */param参数说明returns返回值说明复杂逻辑、边界处理需简要说明原因。 - 避免无意义注释如「设置名称」注释随代码同步更新。 - TS 函数声明规范组件内函数遵循 ESLint / 项目现有风格新代码优先箭头函数const xxx(param:type): returnType{}组件外按需export不必强制导出。## 工作流程1. **理解**读相关文件不做无依据假设。关键字段语义空值含义、枚举取值、数据顺序等不确定时先向用户提问或明确标注为推断不得静默假设。2. **规划**复杂改动先列关键决策点清单。新增文件、公共组件/依赖/构建配置、接口/数据结构、重构、跨模块、影响面大满足其一即视为复杂。先并行分阶段收集事实不擅自扩大范围避免无意义的反复关键权衡需记录。 - **数据契约**字段来源、类型、空值含义须核对真实响应不得仅凭推断无法核对时须标注为推断并提示用户确认。 - **字段映射**接口字段 → 展示的对应关系如状态码 → 文案/颜色。 - **状态分支**加载中 / 有数据 / 无数据 / 失败各显示什么。 - **边界**空值、乱序、包装对象、重复提交。 简单改动改文案、调样式、单点修复可免。 涉及公共组件、store、路由、API 封装、构建配置时先反向检索引用并说明影响面。3. **实施**最小改动复用现有组件与风格只做被要求的事不重构无关代码、不顺手优化。删除文件、改动公共组件/依赖/构建配置等破坏性操作须先向用户确认并给出回滚方式。4. **验证**见「验收标准」。## 验收标准- 本节要求与「效率规则」冲突时以本节为准质量优先于效率。 - 改动后须实际验证按优先级① 跑起来看效果 → ② 核对接口真实返回 → ③ 两者都不可行时明确告知「未做运行时验证」。 - 改动后回归原有功能尤其「优化」「重构」未验证通过前不叠加新改动。 - 完成后按 lockfile 对应包管理器运行类型检查及linttype-check不过不能合并有错误立即修复。type-check只证明能编译不能当功能验收依据。 - 回复需说明改动点、验证方式与结果未做运行时验证必须明确标注禁止伪造验证结论。## 效率规则- 只读与任务相关的文件和代码段涉及公共组件、store、路由、API 封装时必须反向检索引用。 - 不改动无关代码不重排已有格式。 - 回复只讲改动点与原因不贴大段代码、不重复文件内容使用中文回复。用户明确要求时不受此限。
