본문으로 건너뛰기
cccskills
무료GitHub에 공개

trailsnap-ui-design

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

연동 도구Playwright
설치 방법 보기

포함된 파일(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,登录失败向用户询问,不创建账号。未实际运行或截图验收时如实说明。

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

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

LC044/TrailSnap7932026년 10월 20일 업데이트

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

LC044/TrailSnap7932026년 10월 20일 업데이트

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

LC044/TrailSnap7932026년 10월 20일 업데이트

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

LC044/TrailSnap7932026년 10월 20일 업데이트

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

LC044/TrailSnap7932026년 10월 20일 업데이트

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

LC044/TrailSnap7932026년 10월 20일 업데이트

LC044의 스킬 모두 보기

이 스킬의 문제 신고