Communitygithub.com

ComeOnOliver/skillshub

专用于 Scoop 新闻平台的项目级 UI 重构工作流,位于 /home/bender/classwork/Thesis。适用于更新 Scoop 前端布局、地球仪 UX、研究工作区和品牌文档,同时保留所有功能并强制执行 UI、日志和文档中无表情符号的策略。

skillshub 是什么?

该技能定义了一个专注的 UI 重构工作流,专门针对名为“Scoop”的新闻平台,项目根目录位于 `/home/bender/classwork/Thesis`。其核心目标是优化前端布局(位于 `frontend/app` 和 `frontend/components`),增加信息密度,并改善用户体验,特别是地球仪视图和研究工作区。一个关键且强制性的要求是从 UI 字符串、日志和文档中彻底移除所有表情符号,转而使用图标或纯文本标签。 工作流包括一系列具体步骤:缩小首页布局、为地球仪视图添加清晰的国家聚焦标题、将研究工作区重构为带侧边栏的顶部查询栏,以及实现类似 TikTok 的纵向滚动(snap-scroll)的 feed 视图。对于 snap-scroll 实现,文档详细说明了如何通过 `scrollIntoView` 和动画守卫来管理各章节的全视口滚动,同时确保全局头部始终保持可见,并阻止从第一个/最后一个项目滚动出界。 该技能还包含重要的验证检查,以确保任何现有功能(如视图模式切换、模态框、来源过滤器和收藏夹)在重构后不会退化。此外,还提供了关于 snap-scroll feed 布局问题的近期上下文:使用 `h-screen` 固定高度的章节会裁剪底部内容,建议改用 `flex-1 h-full min-h-0` 父容器配合 `h-full min-h-full snap-start` 子章节,以更好地适应视口高度。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/benderfendor/scoop-ui-refactor

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Scoop UI 重构

范围

  • 项目根目录:/home/bender/classwork/Thesis
  • 前端:frontend/app 和 frontend/components

必需成果

  • 保留所有现有功能(视图模式、筛选器、研究、模态框)。
  • 增加密度并减少空白垂直空间。
  • 使地球仪选择流程清晰且可用。
  • 使网格视图具有 snap 滚动效果。
  • 保持 feed 的 snap-scroll,同时保持全局头部可见。
  • 从 UI、日志和文档中移除表情符号。

工作流程

  1. 审查主要界面
  • frontend/app/page.tsx(首页布局)
  • frontend/components/globe-view.tsx 和 frontend/components/interactive-globe.tsx
  • frontend/app/search/page.tsx(研究 UI)
  • frontend/app/globals.css(主题令牌)
  1. 首页布局重构
  • 将主要报道压缩为标题 + 摘要 + 操作行。
  • 将大的叙述块移入紧凑的摘要卡片中。
  • 将冗长的“联系”部分转换为简短的操作行。
  • 保持视图模式控件和筛选器可见且分离。
  1. 地球仪视图 UX
  • 添加清晰的国家聚焦头部。
  • 显示选中国家的来源数量和热门来源。
  • 保持清晰的“重置”操作可见。
  • 移除所有国家旗帜表情符号和任何表情符号使用。
  1. 研究工作区
  • 使用顶部查询栏。
  • 添加 Brief 和 Flow 模式(Flow 按顺序显示推理步骤)。
  • 将历史记录或聊天列表移动到侧边栏。
  • 确保研究视觉效果与主 feed 样式区分开来。
  1. 无表情符号强制执行
  • 使用 ripgrep 查找表情符号用法并移除。
  • 用图标或标签替换表情符号。
  • 应用于 UI 字符串、日志和文档。
  1. Feed 视图 snap-scroll(TikTok 风格)
  • 在具有 snap-y snap-mandatory scroll-smooth 的滚动容器内使用全视口章节(h-screen、snap-start)。
  • 通过仅在 snap 转换实际发生时调用 event.preventDefault() 来处理滚轮/触摸事件,以保持全局头部可见;当位于第一个/最后一个项目时允许默认滚动。
  • 跟踪 activeIndex 和 isAnimating 守卫;为下一个/上一个章节调用 scrollIntoView,并在短暂超时后清除守卫。
  • 支持滚轮、触摸(deltaY 阈值)和箭头键;防抖处理小 delta 值以避免意外 snap。
  • 保留模态框、书签、点赞和收藏行为;不退化现有的 feed 操作。

检查

  • 确认视图模式仍能正确切换。
  • 确认模态框和来源筛选器仍能正常工作。
  • 确认研究结果仍能渲染并嵌入来源。
  • 确认 feed snap-scroll 在滚轮、触摸和箭头键上仍能正常工作,并且头部在顶级滚动时仍可访问。

近期上下文

  • 如果章节固定为 h-screen 而不考虑周围布局,snap-scroll feed 会裁剪底部内容;更推荐使用 flex 父容器(flex-1 h-full min-h-0)和滚动容器内的逐章节 h-full min-h-full snap-start,以便每篇文章使用可用的视口高度而不隐藏标题。
  • 当前 lint 在前端中存在预先存在的警告/错误(未使用的变量、hook 顺序、显式的 any);修复工作待定,且与 snap-scroll 布局无关。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

相关技能