| name | project-code-standards |
| description | Enforces project code conventions for Vue/Nuxt, TypeScript, styling (UnoCSS/SCSS), icons, composables, and commits. Use when writing or reviewing code in this repo, adding components, hooks, or styles, or when asked about project coding standards. |
项目代码规范
本 Skill 约定本仓库的编码方式、Vue 组件、样式、图标、Composables 与类型、Commit 等规范。Agent 在编写或审查本仓库代码时应遵循并引用对应子文档。
规范文档索引
快速检查清单
- 编码：2 空格、双引号、分号；Vue 用
PascalCase.vue，composables 用 useXxx.ts；提交前 pnpm run lint:fix。
- 组件：模板中组件名按 Nuxt 路径（如
CommonIconTip）；Props 解构+默认值，类型放单独 <script lang="ts">；el-tooltip 不同时用 :content 与 #content。
- 样式：尺寸用 rem；优先
uno.config.ts shortcuts；scoped SCSS 里用 --at-apply，不用裸 @apply。
- 图标：统一
i-{collection}:{icon-name}（如 i-solar:settings-linear、i-ri:user-line）。
- Composables/类型：API 返回
Result<T>，通用类型放 app/types/。
- Commit：Conventional Commits；禁止在未获用户明确要求时执行
git commit。
何时查阅子文档
- 新增或修改 Vue 组件 → vue-components.md
- 写 样式/SCSS 或改 UnoCSS → styling.md、scss.md
- 使用或新增 图标 → icons.md
- 新增 composable、API、类型 → composables-types.md
- 提交信息 或 Git 行为 → coding-style.md
- 新增 页面/路由 或设 layout → routing-pages.md
- 测试、构建、Tauri/依赖问题 → testing-tooling.md
- 查 目录结构或关键文件路径 → architecture.md
