本文へ移動
cccskills
無料GitHub で公開

trailsnap-ui-design

基于 TrailSnap(行影集)现有设计系统设计、实现和审查前端 UI。适用于 package/website 的新页面、组件、布局、主题、移动端适配与界面改版;纯后端任务和其他项目不适用。

インストール方法を見る

含まれるファイル(4)

  • SKILL.md4.3 KB
  • agents/openai.yaml293 B
  • references/design-system.md6.6 KB
  • references/page-patterns.md6.4 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

TrailSnap UI 设计

让新增界面自然融入行影集:以照片与回忆为内容中心,中性底色、清晰标题层级、圆角实体内容面板,配合克制的玻璃导航和工具栏。用户明确指定新的视觉方向时按其要求设计,同时保留主题、交互和平台约束。

先确认现有实现

  • 在当前工作区定位 TrailSnap 根目录,读取适用的 AGENTS.md。以下源码路径均相对于根目录,不依赖固定盘符。
  • 修改前阅读 package/website/src/style.css、package/website/src/styles/ui.css 与最接近目标页面的现有组件。以当前源码为准;参考文档中的数值是扫描快照。
  • 设计主题或通用控件时读 设计基础与组件;设计具体页面、媒体浏览或跨端交互时读 页面模式与验收。按任务读取,不全量加载所有页面。
  • 先确定用户主要操作、信息层级、布局归属和内容宽度,再实现界面。只改善当前需求相关范围;扫描到旧样式不等于需要顺带改版。

核心约束

  • Vue 使用 <script setup lang="ts">;状态管理使用 Pinia,HTTP 通过 package/website/src/api/*。沿用 Vue Router、Tailwind CSS 3、Element Plus 与现有组件。
  • 优先复用 package/website/src/components/ui/ 的页面、卡片、按钮和弹层组件。照片浏览优先接入 UnifiedPhotoPage 与现有画廊,避免重复实现虚拟布局、筛选和批量选择。
  • 中性色使用 --ts-color-* 或共享语义类;主题强调色使用 primary-*、--theme-primary 和 --theme-rgb。不要把默认天空蓝写死为品牌色。
  • 每个 text-gray-*、bg-white 及其变体配套相应的 dark: 样式;优先用自动适配明暗的语义 token。Element Plus 继承全局明暗配置,不在实例内覆盖内部颜色。
  • 子组件通过 injectTheme() 使用根组件提供的主题;不要重复 provideTheme() 或创建独立主题状态。图表、Canvas 和动态颜色读取 currentTheme.value.primary / .rgb,随主题变化更新;明暗相关图表也响应 isDarkMode。
  • 玻璃材质用于导航、浮动工具栏、菜单、弹层和照片日期标签;照片本体、普通内容卡片、表单阅读区域保持清晰实体表面。直接复用玻璃类,不叠加多道高光边框或大片模糊装饰。
  • 桌面侧栏与移动底栏由布局负责。遵守已有滚动容器和安全区归属,避免新增页面再次补齐同一段顶部或底部空间。
  • 图标优先使用所在模块已有的 lucide-vue-next,保持同组尺寸一致。图标按钮有可理解的 aria-label;展开和选择状态提供相应 ARIA 属性。交互卡片支持键盘,触屏操作不只依赖 hover。

实施与验收

  1. 选取一个相近页面作为布局参考,确认共享组件的实际 props、slots 和 exports 后再使用;不存在的组件或属性不能靠名称猜测。
  2. 用 token 与共享组件搭建布局,补齐加载、空数据、错误重试、提交中和禁用等与该功能相关的状态。照片标题、数量和地点服从内容层级,长文本不挤走操作按钮。
  3. 检查明暗两种模式和不同主题色;按改动覆盖窄屏、桌面、弹层滚动与必要的软键盘/安全区行为。具体检查见页面模式参考。
  4. 涉及行为改动时,按 tests/README.md 选择相关现有测试,通过 tests/scripts/run-tests.ps1 执行;配置来自 tests/.env.test。只有 Skill 文档变更时验证 Skill 与引用,不启动应用测试。
  5. 有可用本地环境与浏览器工具时,进行截图或交互检查;需要 Playwright CLI 时遵循可用的 playwright 技能。开发环境账号为 trailsnap / trailsnap,登录失败向用户询问,不创建账号。未实际运行或截图验收时如实说明。

交付说明修改结果、复用的设计基础、实际检查及剩余限制。用户只要设计方案时提供可落地的页面/组件方案;用户要求实现时完成代码和适当验证。

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

对照片库或指定相册进行体检,并把结构、时间、地点、AI 元数据与安全清理问题转成可选择、可确认、尽量可撤销的计划。

日本語の概要は準備中です。原文の説明を表示しています。

LC044/TrailSnap7862026年10月13日 更新

安全地把照片整理成正式相册,通过预览、用户确认、执行和撤销完成写操作。

日本語の概要は準備中です。原文の説明を表示しています。

LC044/TrailSnap7862026年10月13日 更新

根据模糊的时间、地点、同行人、画面和文字线索找回可能的照片事件,并在用户确认后生成可追溯的回忆故事。

日本語の概要は準備中です。原文の説明を表示しています。

LC044/TrailSnap7862026年10月13日 更新

为朋友圈九宫格选择质量高、重复少、内容与时空分布丰富的照片。

日本語の概要は準備中です。原文の説明を表示しています。

LC044/TrailSnap7862026年10月13日 更新

按年份和事件整理指定人物出现过的照片,展示共同经历、成长变化、地点与同行人,并可生成可追溯的人物故事。

日本語の概要は準備中です。原文の説明を表示しています。

LC044/TrailSnap7862026年10月13日 更新

发布并验收 TrailSnap 新版本:汇总提交、同步全项目版本号、更新官网日志与客户端更新清单、执行发布前测试、创建 GitHub Release、监控标签 CI、核验 Release 附件,并生成小红书和公众号文案。Use when the user asks to 发布新版本、发版、创建或检查 GitHub Release、总结版本变更、监控发布 CI、检查发布产物,或撰写版本更新帖子。

日本語の概要は準備中です。原文の説明を表示しています。

LC044/TrailSnap7862026年10月13日 更新

LC044 のスキルをすべて見る

このスキルの問題を報告する