LobeHub

本技能按请求范围分阶段开展网页、桌面和移动端界面设计，涵盖业务理解、页面结构、交互流程、视觉与文案优化，以及发布前检查。

• 设计新的管理后台或仪表盘
• 改进现有页面与交互
• 根据截图还原界面

本指南介绍如何添加和整理 SPA 路由，将页面入口放在 `src/routes/`，将领域功能和界面放在 `src/features/`，并协调桌面与移动端路由及加载骨架。

• 为 SPA 添加新页面
• 确定路由与功能的代码位置
• 协调网页、桌面和移动端路由

从当前分支创建拉取请求，通常以 `canary` 为目标；当客户端依赖服务器契约时，按依赖顺序拆分多个请求，并整理验收链接与说明。

• 从当前分支创建拉取请求
• 按顺序拆分服务端和客户端改动
• 梳理请求依赖与合并顺序

本指南介绍如何将代理创建或编辑的资源登记为可追溯的 Work 记录和卡片，涵盖版本历史、去重、技能提供方结果、命令行扫描、文件与任务登记，以及共享会话的访问规则。

• 将代理结果记录为会话卡片
• 检测命令行创建或编辑的资源
• 避免重复登记 Work

定期检查项目中 `.agents/skills/` 下的技能文件，发现重复或职责重叠、过时引用、失效链接及说明与正文不符之处，并附上文件依据和修正建议。

• 检查技能是否重复
• 核对说明与正文是否一致
• 查找过时引用和失效链接

本技能在 macOS 桌面聊天应用中测试机器人频道：打开应用、进入频道或联系人、发送消息、等待回复并截图。支持 Discord、Slack、Telegram、微信、飞书和 QQ；iMessage 使用 BlueBubbles 桥接。

• 检查真实 Discord 频道中的机器人回复
• 测试 Slack 或 Telegram 的对话流程
• 记录 macOS 应用中的操作结果

用于诊断偶发界面故障、陈旧状态、顺序错误和页面跳转问题。沿渲染、客户端状态及服务端边界追踪同一数据，定位结果最早出错的位置。

• 复现偶发的界面故障
• 追查跳转后的陈旧状态
• 定位显示顺序出错的边界

本指南说明代码和测试文件的命名、目录位置与导出约定，介绍单模块测试、集成测试的放置规则，以及如何按功能边界拆分超过 1200 行的文件并保留导入路径和行为。

• 确定新源文件的存放位置
• 统一相关测试的放置方式
• 规划大型文件的拆分结构

用于新增或扩展 LobeHub 内置代理工具，涵盖清单、类型、运行逻辑、前端执行器、聊天界面和注册配置，并说明如何保持这些部分衔接一致。

• 创建新的内置工具包
• 为现有工具添加 API
• 设计执行状态或结果界面

本技能提供使用 Drizzle ORM 定义数据库结构和编写查询的规范，涵盖表与列命名、主外键、索引、时间戳和 JSONB 类型，并介绍显式联接、聚合及 CTE 查询。

• 定义新表或索引
• 编写带联接或聚合的类型化查询
• 按规范检查 Drizzle 结构或查询

维护 `packages/alint` 中由模型判断的代码规则，依据真实代码校准误报、分类检测结果，并根据拉取请求数据决定警告何时升级为错误，同时检查令牌用量。

• 添加模型判断型代码规则
• 用真实代码减少误报
• 制定警告升级为错误的标准

此技能用于为智能体设计事件驱动的后台工作流，划分来源、信号、动作和策略的职责，并处理异步交接、去重、执行范围、完成记录与运行观测。

• 添加事件触发的后台任务
• 将工作移出对话请求
• 防止动作重复执行

本指南说明如何使用仓库中的 LobeHub 实际界面组件和样式，制作可交互的单文件 HTML 原型。内容涵盖运行环境、主题设置和交互检查，便于在正式实现前查看界面状态与操作流程。

• 制作可交互的界面方案
• 用实际界面组件预览设计
• 试用空、加载和错误状态

本指南说明如何为服务器端 tRPC 路由器添加查询和变更过程，包括用 Zod 验证输入、通过中间件传递模型、统一响应与错误处理，以及并行获取详情所需的关联数据。

• 为服务器路由添加查询或更新过程
• 使用 Zod 验证输入值
• 在详情查询中一并返回关联数据

本技能帮助在确定界面布局前厘清要解决的问题和原因。它依据业务事实与用户目标诊断结构问题，并整理建议、证据、范围及待决事项；需要时可为规格说明或原型做好准备。

• 确定新界面要解决的问题
• 梳理含糊的改版需求
• 对照业务实际检查界面结构

此技能帮助你在 Linear 中检查课题正文、图片和子课题，更新状态并记录进展与完成结果；也可将大型工作拆成按顺序组织、依赖关系清晰的子课题树。

• 开始前检查课题内容
• 在 Linear 记录进度和结果
• 按依赖关系拆分子课题

此技能指向 Zustand 数据结构指南，帮助查找列表与详情类型、ID 键映射、reducer 和共享类型的组织方式，也说明使用 local-replica 的领域数据约定。

• 设计 Zustand 列表和详情数据
• 查看 ID 键映射约定
• 查找 reducer 和共享类型指南

追踪应用启动 Claude Code、Codex 等外部 CLI 智能体后的处理流程，检查事件转换、工具结果保存和界面显示，帮助定位会话边界、执行身份及子智能体路由问题。

• 排查 Claude Code 事件处理
• 追踪 Codex 工具结果
• 确认外部智能体启动身份

整理 Drizzle 数据库变更的设计、迁移生成、SQL 审查与发布步骤，涵盖在线建索引、可重试的数据回填、开发中重新生成草稿迁移及 rebase 后处理冲突。

• 规划数据库结构变更
• 为大表添加索引
• 设计既有数据回填

为 React Router 独立微型应用提供拆分、构建和发布指导，涵盖 SSR、SSG、Cloudflare Workers、CDN 资源、网关路由和预览环境，也说明如何控制 Worker 服务端构建包的体积。

• 将大型应用拆分为独立页面
• 配置 React Router 的 SSR 或预生成
• 缩小 Worker 的 SSR 构建包

对本地或远程 Response API 运行官方 OpenResponses 兼容性测试，检查普通响应、流式输出、工具调用、图像输入和多轮对话，并据请求与响应详情排查认证或结构问题。

• 运行 Response API 兼容性测试
• 排查端点结构不匹配
• 重跑指定响应测试

通过实际操作产品验证交付内容，记录用户可查看的证据，并发布验收报告。可检查已有验证计划或创建检查项，选择合适的操作界面，并使用 `lh` CLI 发布结果。

• 实际检查更改后的产品行为
• 收集截图或其他验证证据
• 编写验证计划和报告

通过主要目录和代码层了解 LobeHub 开源仓库，查找界面、路由、状态管理、API、数据库及业务功能占位实现的位置，并掌握开源版与云端实现的边界。

• 查找需要修改的代码层
• 追踪界面到数据库的流程
• 了解主要软件包的职责

审查 Git worktree 和本地分支，按合并、闲置等原因列出可清理项，并标出有修改或未推送提交的项目供检查。确认目标后可执行清理并再次审查结果。

• 整理长期闲置的 worktree
• 检查已合并的分支
• 保护未推送的工作