企业级前端开发规范
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_853f1b5d/11-new。
技能介绍
团队里「各写各的」从哪来
多人协作的前端项目,常见问题不是缺文档,而是规范散落在 Wiki、口头约定和某次 Code Review 的截图里:目录一会儿 pages 一会儿 views,组件命名和 Git commit 各有一套,ESLint 配了但没人按同一套解释执行。中后台、移动端和通用 Web 应用在工程化细节上又容易混用,新人 onboarding 成本高,老代码也难以统一重构。
技能如何组织答案
本技能把可落地、团队统一的前端约定收成一套问答式知识库,你可以直接问具体问题,例如:
- 前端项目目录怎么设计?
src下api、components、composables、pages等如何划分 - JS/TS 变量与文件命名、Vue/React 组件写法、Git
type(scope): content提交格式 - HTML 语义化与
alt、CSS/SCSS 嵌套与 BEM、ESLint + Prettier 的缩进与引号规则 - 路由懒加载、虚拟列表、防抖节流,以及 XSS/CSRF、敏感信息存储等安全边界
内容按模块展开(结构、命名、HTML/CSS、JS/TS、框架、Git、工具链、性能、安全),每条偏向「团队默认选项」而不是概念科普,适合作为评审清单或 onboarding 对照表。
适用边界
这是规范与最佳实践指引,不会替你生成完整项目的脚手架配置或仓库级 ESLint 配置文件;具体技术栈版本、Monorepo 策略需结合你们现有基建调整。React 与 Vue 章节并存,实际项目通常只采纳其中一套框架约定。
使用场景
- 接手中后台项目时,需要把现有仓库目录对齐为团队约定的 `src/api`、`components`、`pages` 等分层结构。
- PR 评审中要核对 Vue 组件多单词命名、`props` 类型与默认值,以及 `feat(scope):` 式 Git 提交是否一致。
- 为新人 onboarding 整理对照表,涵盖文件短横线命名、2 空格缩进、生产环境禁用 `console` 等 ESLint 约定。
- 发版前按清单自查:路由与图片懒加载、大数据列表虚拟滚动,以及 XSS 过滤与敏感信息不入 `localStorage`。
适合人员
- 负责中后台前端工程化、需要把目录、命名与 Git 规范写成团队默认可执行文档的技术负责人。
- 日常审 PR、要按统一标准检查 Vue/React 写法、嵌套深度与 commit 类型的资深前端工程师。
- 刚加入多人在研项目、需要把个人习惯对齐 TypeScript 禁 `any` 与 Prettier 单引号规则的新成员。
- 维护移动端或 Web 应用、要在性能与安全章节对照防抖节流与 CSRF token 校验的前端开发者。