Skip to content

opentiny/tiny-vue / .agents/skills

tinyvue-develop-spec

Verified

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组件的国际化
公用hookspackages/vue-hooks./hooks.skill.md跨组件可以复用的hooks函数
公用指令packages/vue-directive./directive.skill.md跨组件可以复用的指令
utilspackages/utils./utils.skill.md公用函数
组件测试examples/sites/demos/pc/app/**/*.spec.ts 或 packages/vue/src/**/__tests__./testing-guide.skill.mde2e测试和单元测试
文档开发examples/sites/demos/pc/app/**./vue.skill.md每一个组件的 api 和 demo 的开发
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: 196kUpdated Claude CodeCodexVerifiedInstall
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: 192kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 192kUpdated Claude CodeCodexVerifiedInstall
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: 192kUpdated Claude CodeCodexVerifiedInstall