Agent Skills
› lobehub/lobehub
lobehub/lobehub
GitHub用于在 LobeHub 中集成新的 AI 模型提供商或更新现有提供商配置。涵盖运行时集成、模型卡片创建、认证配置及文档编写，确保 API 兼容性与元数据准确性。
安装全部 Skills
npx skills add lobehub/lobehub --all -g -y
集合内 Skills (58)
按质量分展示前 50 个（共 58 个），完整列表请用安装命令预览或逐个打开详情。
用于在 LobeHub 中集成新的 AI 模型提供商或更新现有提供商配置。涵盖运行时集成、模型卡片创建、认证配置及文档编写，确保 API 兼容性与元数据准确性。
需要添加新的 AI 模型提供商
需要为现有提供商添加新模型
需要更新提供商相关文档
npx skills add lobehub/lobehub --skill add-model-provider -g -y
为新AI提供商添加完整文档的工作流，包括使用指南、环境变量说明、Docker配置更新及镜像资源准备，确保中英双语覆盖且不含真实密钥。
需要为新的AI模型或服务提供商创建官方文档
项目新增第三方AI集成需同步更新环境配置和Docker文件
npx skills add lobehub/lobehub --skill add-provider-doc -g -y
提供在项目中添加服务端环境变量的标准流程，用于配置用户设置的默认值。涵盖环境变量定义、类型更新、服务配置组装及文档维护步骤。
需要新增控制用户设置默认值的服务端环境变量
遵循优先级规则（用户自定义>环境变量>硬编码）配置设置
npx skills add lobehub/lobehub --skill add-setting-env -g -y
提供Agent运行时生命周期钩子机制，支持LLM调用、工具执行、人工干预及上下文压缩等阶段的拦截与观察。
需要监控或拦截Agent执行流程
实现工具调用模拟或结果控制
处理Agent运行时的异常与状态变更
npx skills add lobehub/lobehub --skill agent-runtime-hooks -g -y
用于实现 Agent 的事件驱动后台工作，解耦前台聊天请求。提供源、信号、动作及策略模型，支持同步执行、异步队列和持久化自迭代流程，涵盖架构参考、入口点选择及核心模型定义。
需要实现 Agent 的异步后台任务
设计事件驱动的 Agent 工作流
配置 Agent 的信号处理与策略中间件
npx skills add lobehub/lobehub --skill agent-signal -g -y
用于在Discord、Slack、微信等原生聊天应用中进行Agent端到端验收测试。通过macOS自动化脚本模拟用户操作，验证消息收发与交互表现，补充通用接受测试技能。
需要测试Bot在即时通讯平台上的实际交互效果
执行涉及多端聊天应用的端到端验收测试
npx skills add lobehub/lobehub --skill agent-testing-bot -g -y
Agent Tracing CLI 工具，用于本地开发环境记录 Agent 执行快照到磁盘，并提供命令行接口检查失败工具、参数结果、LLM 调用及上下文等追踪信息，支持远程 Trace 下载。
需要排查 Agent 执行过程中的具体步骤细节
检查 LLM 调用上下文或工具调用的输入输出
分析线上 Trace 数据以定位故障
npx skills add lobehub/lobehub --skill agent-tracing -g -y
管理智能体产出的持久化记录（如PR、文件），提供注册、去重、版本累积及类型适配功能，支持客户端兼容门控与分享访问隔离。
需要注册或查询智能体生成的工作记录
处理工作记录的版本历史与去重逻辑
配置工作类型的客户端可见性
npx skills add lobehub/lobehub --skill agent-work -g -y
管理 LobeHub 模型驱动的代码检查规则集生命周期，包括编写规则、校准误报、根据真实数据决定严重程度及追踪成本。
新增或调整代码检查规则
分类并消除规则发现的误报
提升规则警告等级至错误
运行每周规则集审查
npx skills add lobehub/lobehub --skill alint-ruleset -g -y
提供 LobeHub 内置工具的开发指南，涵盖工具包结构、五大组件（Manifest、Runtime、Executor、UI、注册）的设计与实现规范，适用于创建新工具、扩展 API 或调试渲染问题。
创建新的内置工具包
为现有工具添加 API 方法
构建或修改客户端 UI 界面
将工具接入中央注册表
调试工具未找到或渲染异常错误
npx skills add lobehub/lobehub --skill builtin-tool -g -y
提供跨平台聊天机器人构建SDK，支持Slack、Teams等多平台适配。用于实现Webhook、命令处理、卡片交互及流式响应等核心功能，帮助开发者编写一次逻辑即可部署至多端。
需要构建跨平台聊天机器人
集成Slack或Teams等消息平台
实现聊天机器人事件处理与交互
npx skills add lobehub/lobehub --skill chat-sdk -g -y
用于清理 Git Worktrees 的自动化审计与删除技能。通过脚本对分支进行分类（如过期、已合并等），展示候选列表并获取用户确认后执行破坏性操作，确保工作区整洁且避免误删。
清理过期的 Git worktree
审计并删除已合并或无用的分支
npx skills add lobehub/lobehub --skill cleanup-git-worktrees -g -y
LobeHub CLI 开发指南，涵盖基于 Commander.js 和 TypeScript 的架构、命令注册及认证机制。本次更新主要增强任务验收功能，支持视频章节上传、修复证据覆盖率报告逻辑，并同步上游版本以优化计划轮次的数据处理流程。
需要查看 LobeHub CLI 命令用法或架构说明
排查 CLI 验收（acceptance）相关的报错或数据同步问题
了解 CLI 中 agent、auth 等模块的实现细节
npx skills add lobehub/lobehub --skill cli -g -y
指导将重型领域模块按能力拆分为原子组件，支持下沉状态与按需挂载，避免简单文件分割。
需要拆分重型领域模块为独立能力单元
多宿主环境下需优化模块加载与状态管理
npx skills add lobehub/lobehub --skill compose-atoms -g -y
定义前端数据获取架构，规范从组件到 Service 的调用链路，强制使用 SWR 钩子、Zustand 状态管理及缓存失效策略，优化首屏渲染与持久化缓存。
实现新的 API 数据获取逻辑
重构 useEffect 中的数据请求
处理 SWR 缓存键与失效机制
优化首页或侧边栏的首屏渲染性能
npx skills add lobehub/lobehub --skill data-fetching-architecture -g -y
提供Drizzle数据库迁移指南，涵盖Schema设计规范、避免使用pg枚举以简化扩展、领域常量分离及ID生成策略，旨在优化数据库版本控制与代码维护。
执行数据库模式变更
生成或修复迁移文件
设计新表结构
npx skills add lobehub/lobehub --skill db-migrations -g -y
用于定位前端间歇性UI、状态陈旧及导航等浏览器端Bug。通过边界追踪和回归诊断，在隔离环境中复现症状并对比状态，找出数据出错的首个边界，提供修复指导。
前端界面出现间歇性错误
状态陈旧或数据不同步
导航或渲染顺序异常
仅浏览器环境下的特定缺陷
npx skills add lobehub/lobehub --skill debug-frontend-with-browser -g -y
提供 debug 包的使用指南，涵盖日志格式、命名空间约定及多环境启用方法。
调试日志配置
DEBUG环境变量设置
npx skills add lobehub/lobehub --skill debug-package -g -y
提供多维度代码审查技能，支持Light和Deep两种模式。通过独立第三方审查者、并行维度覆盖及对抗性验证机制，确保审查的广度与精度，避免幻觉和自我批准，适用于PR或分支的代码质量评估。
用户请求对PR、diff或分支进行独立代码审查
明确指定使用deep-review命令
npx skills add lobehub/lobehub --skill deep-review -g -y
生成基于真实 LobeHub UI 6.x 设计系统的单文件交互 HTML 原型，支持完整状态与动效。
需要快速验证 UI 交互效果
创建高保真前端原型
npx skills add lobehub/lobehub --skill design-prototype -g -y
通过GitHub工作流检查和执行桌面客户端的安全策略更新，包括漏洞标记、撤销及强制安全升级，支持多版本通道。
需要检查或标记桌面客户端安全漏洞
需要撤销现有的安全限制
需要发布强制安全更新
npx skills add lobehub/lobehub --skill desktop-security-update -g -y
提供 Electron 桌面应用开发指南，涵盖主渲染进程架构、IPC 通信、控制器创建及窗口菜单管理等核心内容。
Electron 桌面应用开发
主渲染进程架构设计
IPC 通信机制实现
npx skills add lobehub/lobehub --skill desktop -g -y
用于生成网站产品更新日志（docs/changelog/*.mdx），涵盖中英文双语撰写、结构化排版及事实核对，排除 GitHub Release 内容。
用户请求编写或翻译产品更新日志
用户要求生成 docs/changelog 目录下的 MDX 文件
npx skills add lobehub/lobehub --skill docs-changelog -g -y
Drizzle ORM 数据库模式与查询规范，涵盖表、列命名约定、主键策略（禁用自增）、辅助函数及测试要求，确保 PostgreSQL 数据一致性。
定义或修改数据库表结构
编写 Drizzle ORM 查询语句
生成数据库迁移文件
npx skills add lobehub/lobehub --skill drizzle -g -y
用于产品数据全文搜索的技能，涵盖FtsSearchRepo、多后端（pg_search/pg_like/Elasticsearch）切换、映射迁移、投影、Outbox同步及重建索引。
执行产品数据全文搜索查询
进行搜索引擎映射迁移或重建索引
配置或调试搜索后端连接与同步
npx skills add lobehub/lobehub --skill full-text-search -g -y
用于处理外部 CLI 代理（如 Claude Code/Codex）的集成、适配器开发及调试。涵盖 IPC 通信、事件映射、流式 JSON 解析修复、工具调用链持久化及多智能体路由等桌面端与代理间的交互问题排查。
修复 Claude Code 或 Codex 的流式 JSON 解析错误
调试外部代理驱动与 Electron 主进程间的 IPC 通信
修改代理适配器或驱动程序代码
排查工具调用状态漂移或多智能体线程路由问题
npx skills add lobehub/lobehub --skill heterogeneous-agent -g -y
提供前端键盘快捷键的添加指南，涵盖常量定义、注册、国际化及Hook使用，帮助开发者规范实现快捷键功能。
需要添加新的键盘快捷键
配置快捷键的注册与绑定
解决快捷键冲突或作用域问题
npx skills add lobehub/lobehub --skill hotkey -g -y
指导 LobeHub 项目使用 react-i18next 进行国际化，规范键命名与翻译流程。明确仅编辑默认源文件，利用自动工作流处理多语言，并规定修改英文原文时需同步更新或重命名以解决翻译陈旧问题。
添加新的用户界面文本字符串
配置或管理 react-i18next 命名空间
执行 i18n 命令生成或更新翻译文件
修改现有英文原文需触发重新翻译
npx skills add lobehub/lobehub --skill i18n -g -y
管理 Linear 任务全流程，支持问题检索、创建、状态更新及子任务分解。强调读取截图上下文、自动分配给当前用户、添加审计标签及保持对话语言一致性，确保团队协作与 AI 贡献可见性。
查询或更新 Linear 任务状态
创建新的开发任务或子任务树
处理 LOBE-xxx 相关的问题链接
npx skills add lobehub/lobehub --skill linear -g -y
规范业务侧LLM调用的架构边界，涵盖提示词版本管理、场景语义定义及模型策略配置。旨在实现调用可观测性，分离关注点，确保结构化输出与追踪数据准确性。
需要添加新的LLM生成调用
重构现有的AI服务代码
定义新的提示词模板或版本
配置模型选择策略
npx skills add lobehub/lobehub --skill llm-generation -g -y
提供 LobeHub base-ui 命令式 Modal API 使用指南，涵盖 createModal、confirmModal 及 ModalHost 配置与集成方法。
前端弹窗开发
UI 组件迁移
npx skills add lobehub/lobehub --skill modal -g -y
规范模型元数据维护，定义knowledgeCutoff、family和generation字段语义及来源规则，指导单模型或批量更新AI模型卡片信息。
新增或更新AI模型元数据
批量填充模型知识截止时间、家族和代际信息
npx skills add lobehub/lobehub --skill model-bank-metadata -g -y
用于在新功能开发或重构前，明确产品定义、业务模型及用户任务。通过确立商业意义和领域约束，指导后续交互设计与原型构建，确保先解决“做什么”和“为什么做”，再讨论界面细节。
需要定义新产品功能或页面
对现有产品进行重新设计或重构
面对模糊的产品需求需澄清业务目标
npx skills add lobehub/lobehub --skill product-design -g -y
提供 LobeHub 开源项目的整体架构概览，包括技术栈、Monorepo 目录结构及核心模块归属。用于快速定位代码位置、理解项目分层及业务模块边界。
查询项目目录结构
了解技术栈组成
查找特定功能所属包或应用
npx skills add lobehub/lobehub --skill project-overview -g -y
提供React组件编写指南，涵盖样式方案选择、组件库优先级（优先base-ui）、导入规范及性能优化建议，指导开发者高效构建符合项目规范的TSX组件。
创建或修改React组件
选择UI组件库导入路径
处理组件样式实现
npx skills add lobehub/lobehub --skill react -g -y
用于对 Response API 运行 OpenResponses 合规测试套件，验证端点 Schema、基本响应、流式传输及工具调用等功能的正确性。
需要验证 API 合规性
检查端点 Schema 失败
执行 API 测试用例
npx skills add lobehub/lobehub --skill response-compliance -g -y
用于在本地或云端运行及诊断 Harbor/FrontierHarness 评估任务。支持环境配置、凭证管理及故障排查，适用于评估基础设施运维与目标预检，不包含任务创建或产品验收。
需要运行或恢复 Harbor 评估作业
诊断评估失败原因或进行故障排查
配置本地或云端的 LobeHub 评估环境
npx skills add lobehub/lobehub --skill run-eval-harbor -g -y
定期审计技能文件，检测重复、重叠、过时或不一致项，清理无效引用并优化分类边界。
需要检查技能库一致性时
新增或重命名多个技能后
npx skills add lobehub/lobehub --skill skills-audit -g -y
规范前端代码目录结构、文件命名规则（PascalCase/camelCase等）、测试文件放置位置及大文件拆分策略，确保项目结构一致性。
询问文件应放在哪个目录
确定新文件的命名格式
决定如何拆分过大的源文件或测试文件
确认测试文件的存放路径
npx skills add lobehub/lobehub --skill source-layout -g -y
指导单页应用路由与功能模块的架构规范，明确 src/routes 仅含页面片段，src/features 存放业务逻辑与UI，约束组件归属及共享路由器配置。
添加新的 SPA 路由或路由段
重构 src/routes/ 下的布局或页面文件
决定新组件应放在路由文件夹还是功能文件夹
npx skills add lobehub/lobehub --skill spa-routes -g -y
将超过1200行的源文件重构拆分为目录结构下的内聚模块，保持行为不变。通过先锁定测试、再移动提取最后拆分测试的流程实现大文件分解与缩小。
拆分大文件
拆文件
重构大文件
npx skills add lobehub/lobehub --skill split-large-file -g -y
管理独立微应用（workbench/share/auth）的构建部署与路由隔离，涵盖 SSR/SSG、Docker集成、CDN及网关配置，明确区分云端与自托管环境的差异。
需要部署或配置独立微应用
处理微应用的 SSR/SSG 构建流程
解决微应用的路由重写与网关转发问题
npx skills add lobehub/lobehub --skill split-micro-app -g -y
提供 Zustand 状态存储的数据结构指导，涵盖列表、详情类型、Map 及 Reducers。结合 @lobechat/replica 机制，说明域数据如何通过 id-keyed Map 视图和 Replica 记账字段进行组织与同步。
需要定义或优化 Zustand 状态管理数据结构
理解基于 replica 的服务端数据投影模式
开发涉及前端状态持久化或同步的功能
npx skills add lobehub/lobehub --skill store-data-structures -g -y
用于手动验证多种外部CLI代理与官方模型在LobeHub环境下的兼容性矩阵，通过执行实际请求确保交互链路正常。
用户显式调用测试异构代理命令时
需要验证多客户端与官方模型兼容性的场景
npx skills add lobehub/lobehub --skill testing-heterogeneous-agents -g -y
提供LobeHub项目Vitest测试规范，涵盖运行命令、数据库集成测试配置及核心原则。指导编写高质量测试，推荐spyOn，强调行为测试与回归测试，避免盲目mock UI组件。
需要运行或调试Vitest测试
询问测试最佳实践
涉及数据库模型测试
npx skills add lobehub/lobehub --skill testing -g -y
提供 tRPC Router 开发规范，涵盖文件结构、中间件注入模型最佳实践及 Procedure 标准模式，旨在统一服务端 API 端点与过程定义。
创建或修改 tRPC 路由
实现后端 API 查询或变更逻辑
npx skills add lobehub/lobehub --skill trpc-router -g -y
提供 TypeScript 编码规范，涵盖类型安全、异步 IO 最佳实践、导入管理及代码结构，旨在提升代码质量与可维护性。
编写或修改 TypeScript/TSX 代码
进行 TypeScript 代码审查
npx skills add lobehub/lobehub --skill typescript -g -y
提供Upstash Workflow与QStash异步工作流的实现指南，涵盖入口、分页扇出及单任务执行三层架构模式，规范批量处理、干跑预览及幂等重试标准。
实现基于Upstash的异步批量数据处理流程
构建需要持久化步骤和并发控制的后台任务
npx skills add lobehub/lobehub --skill upstash-workflow -g -y
基于设计模式语言和执行清单，对单一界面进行可重复的UX审计。通过静态代码、视觉截图和动态自动化三层检测体验缺陷与模式合规性，输出标准化审查结果。
需要对特定页面或功能模块进行UX合规性检查
发现界面存在可用性问题需系统性评估
npx skills add lobehub/lobehub --skill ux-audit -g -y
提供产品交互行为准则与执行检查清单，涵盖空/加载/错误状态、列表展示、选择器、草稿安全及渐进式披露等动态流程规范，辅助构建和审查面向用户的界面。
设计或实现用户界面交互流程
审查前端页面的动态行为是否符合体验标准
npx skills add lobehub/lobehub --skill ux -g -y
