前端 AI 编码双规范

5 阅读3分钟

一、项目核心 Skills(两套标准,各司其职)

1)vue-best-practices

下载地址:npx skills add https://github.com/hyf0/vue-skills --skill vue-best-practices

负责:组件结构与逻辑正确性适用范围:

  • .vue 组件、页面
  • Vue Router / Pinia / 组合式逻辑
  • 组件拆分、数据流、状态管理

关键约束:

  • 统一使用 Vue 3 + Composition API
  • 遵循 Props Down / Events Up 单向数据流
  • 状态最小化,优先 computed 派生
  • 复杂逻辑抽离为 useXxx Composable
  • 先保证功能正确,再做性能优化

2)scss-layout-best-practices

负责:多端布局一致性适用范围:

  • uni-app 页面 / 组件样式
  • 小程序、Android、iOS 多端兼容

关键约束:

  • 布局单位优先使用 rpx
  • 主布局优先 flex
  • 控制选择器嵌套深度,提升可维护性
  • 颜色 / 间距 / 字号统一变量,禁止硬编码
  • 动效优先 transform/opacity,降低性能损耗

二、为什么必须显式使用 Skills

传统 “想到哪改到哪” 的痛点:

  • 组件持续膨胀,职责边界模糊
  • 样式临时修补,多端表现不一致
  • AI 每次重新理解项目,输出风格漂移
  • Code Review 大量消耗在规范而非业务

Skills 的价值:把经验变成规则

  • AI 按统一标准输出,不再随机发挥
  • 新需求复用同一套决策路径
  • 评审聚焦业务,规范问题前置解决

三、实战流程:如何在项目中落地

1)先定任务边界,再匹配 Skill

  • 页面逻辑 / 状态 / 组件拆分 → 用 vue-best-practices
  • 布局 / 样式 / 多端兼容 → 用 scss-layout-best-practices
  • 逻辑 + 样式同时修改 → 先逻辑后样式,两套并用

2)按固定顺序执行改动

Vue 任务执行顺序

  1. 划分组件职责(状态 vs 展示)
  2. 定义 props /emits 接口契约
  3. 复杂逻辑抽离 Composable
  4. 保证行为与功能正确
  5. 最后优化渲染与性能

SCSS 任务执行顺序

  1. 保持交互与功能不变
  2. 统一布局(flex /rpx)
  3. 抽取变量与公共样式
  4. 检查层级、滚动性能
  5. 多端验证(小程序 / Android /iOS)

3)每次输出固定交付物

每个任务必须包含:

  1. 改动清单(按文件说明改了什么)
  2. 风险点(端差异、状态流、性能)
  3. 验证步骤(最小可复现检查点)

确保开发者、AI、评审者使用同一套标准。


四、项目内通用提示词模板

请完成指定任务,并严格遵循项目 Skills:
- Vue 相关:遵循 vue-best-practices
- 样式相关:遵循 scss-layout-best-practices
- 不做无关重构,不修改无关文件

输出格式:
1. 改动点(按文件)
2. 风险点(多端兼容/状态/性能)
3. 验证步骤(小程序 / Android / iOS)

五、落地收益

  • AI 输出更稳定:不再上下文漂移、风格失控
  • 代码更易维护:组件边界清晰,样式策略统一
  • 多端更可靠:提前规避多端差异兼容问题
  • 协作更高效:任务交接、Code Review 更快更清晰