OpenParable
Skip to content
← Back to skills

Project Code Standards

Development
project-code-standards

Project Code Standards is an Agent Skill for development published in the KiWi233333/JiwuChat repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/KiWi233333/JiwuChat/blob/HEAD/.cursor/skills/project-code-standards/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/project-code-standards, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

项目代码规范

本 Skill 约定本仓库的编码方式、Vue 组件、样式、图标、Composables 与类型、Commit 等规范。Agent 在编写或审查本仓库代码时应遵循并引用对应子文档。

规范文档索引

大类文件内容摘要
编码与命名coding-style.md缩进/引号/分号、ESLint、文件与函数命名、Commit 规范、Git 规则
Vue 组件vue-components.mdNuxt 路径即组件名、Props/Emits、类型分离、el-tooltip 坑点
样式styling.mdrem、UnoCSS shortcuts、布局、动态类名、视觉与主题
SCSSscss.md--at-apply、语义类名、避免 BEM、深色模式
图标icons.mdclass 格式 i-{collection}:{icon-name}、常用集合与示例
Composables 与类型composables-types.mdapi/hooks/store/utils 分工、Result<T>、types/ 目录
路由与页面routing-pages.md文件路由、definePageMeta、layout、目录约定
测试与工具testing-tooling.md当前测试策略、常用命令、Tauri/依赖/OAuth 常见问题
架构速查architecture.mdapp 目录、WebSocket/TipTap/Tauri 关键路径、配置与环境

快速检查清单

  • 编码: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