| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.4 KB |
| common.skill.md | markdown | 7.8 KB |
| design.skill.md | markdown | 9.9 KB |
| directive.skill.md | markdown | 6.0 KB |
| hooks.skill.md | markdown | 5.9 KB |
| i18n-workflow.skill.md | markdown | 9.9 KB |
| icon.skill.md | markdown | 1.3 KB |
| renderless.skill.md | markdown | 9.4 KB |
| testing-guide.skill.md | markdown | 11.2 KB |
| theme.skill.md | markdown | 11.5 KB |
| utils.skill.md | markdown | 5.7 KB |
| vue.skill.md | markdown | 9.1 KB |
SKILL.md
View on GitHub---
name: tinyvue-develop-spec
description: tinyvue组件库开发规范
---
## 使用时机
在当前仓库进行组件的开发,主题开发,国际化开发,测试脚本开发时,必须遵守以下规范。
## 适用场景
- 新增 UI 组件
- 修改现有组件逻辑
- 重构组件架构
- 理解 Renderless 模式
### 重要术语
1. 跨端模板: tiny vue组件库中,同一个组件可以有2种组件模板, 其中`pc.vue` 面向家用PC浏览器的场景, `mobile-first.vue`是移动优先的浏览器场景(可以兼容用户使用手机或PC浏览器)。
2. 无渲染逻辑层: tiny vue组件库遵从模板和逻辑分离的原则进行开发。模板层只负责绑定变量和函数,所有的业务逻辑(data 处理、状态计算等)都要放在无渲染逻辑层 `packages/renderless` 目录
## 组件库的架构
| 模块名称 | 代码目录 | 参考规范 | 说明 |
| --------------- | ----------------------------------------------------------------------------- | -------------------------- | -------------------------------------------- |
| 模板层 | `packages/vue` | `./vue.skill.md` | 每个组件的模板,必须在相应的组件目录 |
| 无渲染逻辑层 | `packages/renderless` | `./renderless.skill.md` | 每个组件的逻辑,必须在相应的组件目录 |
| 样式层 | `packages/theme` | `./theme.skill.md` | 每个组件的样式,必须在相应的组件目录 |
| 设计规范层 | `packages/design` | `./design.skill.md` | 交互规范、默认 props、图标与 renderless 扩展 |
| 适配Vue2/Vue3层 | `packages/vue-common` | `./common.skill.md` | 非必要不修改适配层代码 |
| 图标库 | `packages/vue-icon` | `./icon.skill.md` | 图标库 |
| 国际化层 | `packages/vue-locale` | `./i18n-workflow.skill.md` | 组件的国际化 |
| 公用hooks | `packages/vue-hooks` | `./hooks.skill.md` | 跨组件可以复用的hooks函数 |
| 公用指令 | `packages/vue-directive` | `./directive.skill.md` | 跨组件可以复用的指令 |
| utils | `packages/utils` | `./utils.skill.md` | 公用函数 |
| 组件测试 | `examples/sites/demos/pc/app/**/*.spec.ts` 或 `packages/vue/src/**/__tests__` | `./testing-guide.skill.md` | e2e测试和单元测试 |
| 文档开发 | `examples/sites/demos/pc/app/**` | `./vue.skill.md` | 每一个组件的 api 和 demo 的开发 |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |