Agent Skills
› lobehub/lobehub
lobehub/lobehub
GitHub为新AI提供商添加完整文档的工作流，包括使用指南、环境变量说明、Docker配置更新及镜像资源准备，确保中英双语覆盖且不含真实密钥。
Install All Skills
npx skills add lobehub/lobehub --all -g -y
Skills in Collection (47)
为新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执行生命周期钩子机制，支持在步骤前后、工具调用、人工干预、上下文压缩及子代理调用等关键节点进行拦截、观测、Mock或注入逻辑。
需要监控Agent内部执行流程
实现工具调用Mock或测试
集成人工审批流
自定义上下文压缩逻辑
npx skills add lobehub/lobehub --skill agent-runtime-hooks -g -y
构建或扩展 Agent Signal 管道，实现事件驱动的异步后台工作。涵盖信号源、策略、中间件、工作流交接及可观测性，支持同步执行与出队处理。
需要为Agent添加解耦的后台异步任务
配置或开发新的信号源、信号类型或动作处理器
设置Agent信号管道的策略、中间件或去重逻辑
排查Agent信号流程的可观测性或调试问题
npx skills add lobehub/lobehub --skill agent-signal -g -y
为LobeHub项目提供Discord、微信等即时通讯平台的端到端测试能力，通过macOS原生应用驱动验证Bot消息收发。
test bot
bot test
test in discord
test in telegram
test in slack
test in wechat
npx skills add lobehub/lobehub --skill agent-testing-bot -g -y
Agent Tracing CLI 工具，用于本地记录、检查和分析 Agent 执行快照。支持调试 LLM 调用、工具调用及上下文引擎数据，并可拉取远程生产环境 Trace 进行故障排查。
需要检查或调试 Agent 的执行步骤和 LLM 调用细节
分析 Agent 工具调用的参数、结果或可用工具列表
获取并审查线上/生产环境的 Agent 执行轨迹
npx skills add lobehub/lobehub --skill agent-tracing -g -y
Agent工作注册中心，用于持久化记录智能体产生的各类产出物（如PR、文件等），实现去重、版本管理及卡片渲染。支持扩展新技能提供商、CLI扫描器及工作类型，并处理客户端兼容性兼容问题。
需要注册或查询Agent生成的工作成果时
扩展新的工作类型或注册适配器时
npx skills add lobehub/lobehub --skill agent-work -g -y
指导如何构建和集成 LobeHub 内置工具包，涵盖清单定义、执行运行时、前端执行器及 UI 组件开发，并处理注册表配置与调试。
创建新的内置工具包
为现有工具添加 API 方法
构建或修改工具客户端界面
将工具注册到中央注册表
调试工具调用或渲染错误
npx skills add lobehub/lobehub --skill builtin-tool -g -y
用于构建跨平台聊天机器人的 TypeScript SDK，支持 Slack、Teams 等多渠道。提供统一 API 处理事件、消息、卡片及流式响应，实现一次编写多处部署。
需要开发聊天机器人
集成多平台消息通知
npx skills add lobehub/lobehub --skill chat-sdk -g -y
审计并安全清理 Git worktrees 和过期本地分支，通过脚本分类候选项，经用户确认后删除，保护脏数据和当前工作区。
列出或审计 Git worktrees
清理已合并或上游消失的过期分支
整理过期的 worktree 注册信息
npx skills add lobehub/lobehub --skill cleanup-git-worktrees -g -y
LobeHub CLI 开发指南，涵盖基于 Commander.js 和 TypeScript 的架构、命令分组及核心模块（如认证、网关连接、AI 交互等），适用于该命令行工具的维护与二次开发。
需要查看 LobeHub CLI 项目结构
查询特定 CLI 命令的实现逻辑
了解 CLI 认证或网关连接机制
npx skills add lobehub/lobehub --skill cli -g -y
LobeHub数据获取架构指南，规范从组件到Zustand Store、Service层及lambdaClient的调用流程。禁止在组件中直接请求或混用状态管理，确保代码一致性与可维护性。
前端数据获取逻辑实现
迁移useEffect为SWR Hook
创建Service层API封装
定义Store中的SWR Hooks
npx skills add lobehub/lobehub --skill data-fetching-architecture -g -y
提供数据库迁移最佳实践，涵盖Drizzle Schema规范、在线索引创建及数据回填策略。指导如何避免枚举限制、管理领域常量，并处理并发部署与幂等性审查。
生成或编辑数据库迁移文件
处理大表索引创建以避免阻塞
设计可扩展的Schema字段类型
执行数据回填或版本回滚冲突修复
npx skills add lobehub/lobehub --skill db-migrations -g -y
提供 LobeHub 项目 debug 日志库的使用指南，涵盖命名规范、格式符及多环境启用方法，辅助开发者排查问题。
添加调试日志
选择 lobe-* 命名空间
排查 DEBUG 输出
配置 localStorage.debug
调整日志格式
npx skills add lobehub/lobehub --skill debug-package -g -y
提供多维度的代码审查能力，支持对PR、Diff或分支进行深度评估。通过独立子代理并行检查不同维度，结合对抗性验证消除幻觉，确保审查结果的准确性和全面性。
用户请求审查PR或Diff
要求查找代码中的问题或漏洞
粘贴代码片段要求进行正式或非正式审查
npx skills add lobehub/lobehub --skill deep-review -g -y
生成基于 LobeHub 设计系统的单文件 HTML 交互原型，无需构建即可在浏览器中打开。支持完整交互、状态及主题切换，适用于快速验证 UI/UX 或探索重设计方案。
需要交互原型
制作高保真 mockup
出个原型
设计稿 HTML
UI 重构前探索
npx skills add lobehub/lobehub --skill design-prototype -g -y
提供基于 Electron 的桌面应用开发指南，涵盖主渲染进程架构、IPC 通信机制、控制器创建及窗口菜单管理，指导开发者安全高效地实现桌面端新功能。
Electron 桌面应用开发
主渲染进程通信配置
IPC 接口定义与使用
桌面窗口或菜单管理
npx skills add lobehub/lobehub --skill desktop -g -y
用于撰写产品更新日志和版本说明文档，支持中英文双语发布。规范了文件命名、元数据及内容结构，确保事实准确、用户价值优先，并遵循多语言同步与一致性原则。
需要编写或编辑产品更新日志
生成中英文对照的版本发布说明
整理功能改进与修复列表
npx skills add lobehub/lobehub --skill docs-changelog -g -y
提供Drizzle ORM在PostgreSQL中的Schema定义、查询风格及命名规范指南。涵盖配置、辅助函数、主键策略（禁用自增）、表名与字段命名约定，确保代码一致性与迁移安全。
需要创建或修改数据库表结构
编写Drizzle ORM查询语句
定义数据库模型和字段类型
处理PostgreSQL迁移脚本
npx skills add lobehub/lobehub --skill drizzle -g -y
用于开发或调试 LobeHub 异构代理（如 Claude Code/Codex 适配器）。处理外部 CLI 管道、事件映射、IPC 通信、持久化及流式传输 Bug。
修复 Claude Code 或 Codex 的 JSONL/stream-json 解析错误
调试异构代理驱动与适配器的数据映射逻辑
排查 Electron 主进程与渲染进程间的 IPC 通信问题
npx skills add lobehub/lobehub --skill heterogeneous-agent -g -y
指导如何为 LobeHub 应用添加或编辑键盘快捷键，涵盖常量定义、注册、国际化及 Hook 使用。
需要新增自定义快捷键
修改现有快捷键配置
解决快捷键冲突或作用域问题
npx skills add lobehub/lobehub --skill hotkey -g -y
LobeHub i18n 开发指南，基于 react-i18next。规范了键名命名、参数插值及文件编辑路径，定义了从添加键到自动翻译的工作流，并提供常用命名空间列表，确保多语言功能正确集成。
需要添加新的用户界面翻译字符串
配置或修复多语言支持问题
使用 t() 函数进行国际化调用
手动触发本地预览翻译
npx skills add lobehub/lobehub --skill i18n -g -y
管理 Linear 问题，包括检索、创建、更新状态及关联 PR。支持解析图片上下文、处理子任务树，并规范完成评论与语言匹配，确保开发流程闭环。
用户提及 Linear issue ID 或链接
需要创建或更新问题状态
PR 修复了 Linear 问题需添加完成评论
npx skills add lobehub/lobehub --skill linear -g -y
规范业务级 LLM 调用的代码组织，明确提示词版本管理、场景语义、模型策略及可观测性边界。
新增或修改 AI 生成相关的 Prompt
调整结构化输出 Schema 或生成模型配置
涉及 LLM 调用链路追踪与测试
npx skills add lobehub/lobehub --skill llm-generation -g -y
提供 LobeHub 命令式 Modal 开发规范，指导使用 base-ui 的 createModal、ModalHost 及 useModalContext，涵盖文件结构、i18n 处理及关闭逻辑，适用于新建或迁移弹窗组件。
创建新的模态框或对话框
将现有声明式 Modal 迁移至命令式 API
配置 ModalHost 全局挂载
在 Modal 内容中获取上下文
npx skills add lobehub/lobehub --skill modal -g -y
用于维护和回填模型银行元数据（知识截止、家族、代际）。适用于新增模型、修复数据或执行全量元数据扫描，严格依据官方权威来源填充字段。
新增AI模型并补充元数据
修复错误的知识截止或家族信息
对大量模型进行元数据批量扫描与更新
npx skills add lobehub/lobehub --skill model-bank-metadata -g -y
将模糊的产品需求转化为可落地设计，优先确立业务语义与用户任务，再提出界面方案。用于新页面规划、现有功能重构或特性定义，强调在讨论视觉细节前明确构建什么及原因。
规划新页面或功能模块
对现有产品体验不满意需重新设计
需要明确新功能的核心价值与范围
npx skills add lobehub/lobehub --skill product-design -g -y
提供 LobeHub monorepo 架构地图，涵盖技术栈、目录结构及核心模块说明。用于帮助开发者快速理解项目布局、定位代码层级及进行仓库入职引导。
需要了解项目整体架构或目录结构
初次加入仓库需要入职引导
查找特定功能模块（如 agent-runtime）的位置
npx skills add lobehub/lobehub --skill project-overview -g -y
提供 React 组件编写规范，涵盖样式策略、组件库优先级（优先 base-ui）及常用 UI 组件导入方式，指导 TSX 开发。
编辑 TSX 文件
选择 UI 组件库
处理组件样式
npx skills add lobehub/lobehub --skill react -g -y
用于对本地或远程 Response API 端点运行 OpenResponses 官方合规测试套件。支持开发模式、API Key 等多种认证方式，可执行基础响应、流式传输、工具调用等特定测试用例，并输出详细日志或 JSON 格式结果以集成 CI/CD。
需要验证 Response API 是否符合 OpenResponses 标准
进行 API 端点的合规性测试
调试 Response API 的 Schema 或功能
npx skills add lobehub/lobehub --skill response-compliance -g -y
定期审查项目技能库，检测重复、重叠、过时或不一致的技能。通过清单盘点、描述格式标准化及冗余合并，维护技能目录的清晰与一致性。
需要清理或整理技能文件时
新增多个技能后检查一致性
发现技能描述混乱或引用失效时
npx skills add lobehub/lobehub --skill skills-audit -g -y
指导 SPA 路由与功能模块的架构规范，明确 src/routes 仅存放页面片段，业务逻辑与 UI 放入 src/features。适用于新增路由、重构布局或决定组件归属位置等前端开发场景。
新增 SPA 路由或路由段
重构 src/routes/ 下的布局或页面文件
将路由相关组件或逻辑迁移至 src/features/
决定新组件应放在路由文件夹还是功能文件夹
npx skills add lobehub/lobehub --skill spa-routes -g -y
指导将单体应用拆分为独立微前端应用，涵盖 React Router SSR、Cloudflare Workers 部署、CDN/R2 资源上传及 SEO 优化。包含 OSS CI/CD 配置、网关路由设置及 Docker 镜像集成规范。
拆分单体应用到微前端架构
配置 SSR 微应用的构建与部署流程
解决 SSR 包体积过大问题
为微应用添加 SEO 和 OG 元数据
配置网关路由规则以支持新微应用
npx skills add lobehub/lobehub --skill split-micro-app -g -y
规范 LobeHub Zustand Store 数据结构，指导列表与详情分离、Map/Array选型及类型定义，以优化渲染性能、缓存及乐观更新。
设计 Zustand store 状态结构
实现列表页或详情页数据缓存
处理乐观更新逻辑
定义 Store 相关 TypeScript 类型
npx skills add lobehub/lobehub --skill store-data-structures -g -y
Vitest测试指南，提供运行命令、数据库测试配置及核心原则。指导编写和维护测试，修复失败用例，提升覆盖率，调试测试问题及设置Mock，确保类型检查通过并遵循特定测试规范。
编写或更新测试代码
修复失败的测试用例
提升测试覆盖率
调试测试相关问题
设置测试Mock
npx skills add lobehub/lobehub --skill testing -g -y
提供 tRPC Router 开发规范，涵盖文件结构、中间件注入模型及 Procedure 编写模式，指导创建和修改服务端 API 端点。
创建或修改 tRPC router
添加 procedure
实现服务端 API 端点
npx skills add lobehub/lobehub --skill trpc-router -g -y
提供TypeScript代码风格与类型安全指南，涵盖类型定义、异步IO模式及导入规范，用于指导TS/TSX开发中的最佳实践。
编辑TS或TSX文件
修复类型错误
选择interface或type
npx skills add lobehub/lobehub --skill typescript -g -y
Upstash Workflow与QStash异步工作流实现指南，涵盖三层架构及Dry-Run、Fan-Out、单任务执行模式，用于处理高并发、分页及限流场景。
需要实现基于Upstash的异步后台任务
处理大批量数据并行处理或分页逻辑
设计具有幂等性和重试机制的工作流
npx skills add lobehub/lobehub --skill upstash-workflow -g -y
基于设计模式语言和检查清单，对单一界面执行可重复的UX审计。通过静态代码、视觉截图和动态用户旅程三层验证，识别体验缺陷并反馈优化建议。
需要对特定页面或界面进行标准化的用户体验审查
评估界面是否符合设计规范及性能指标
npx skills add lobehub/lobehub --skill ux-audit -g -y
提供 LobeHub 产品交互行为指南，涵盖自然、有意义、确定性与成长性四大设计价值及具体执行清单，用于指导用户界面流程的设计与构建。
设计或构建面向用户的交互流程
审查前端界面体验与交互逻辑
npx skills add lobehub/lobehub --skill ux -g -y
负责版本发布流程管理，包括分支策略、CI触发规则判断及GitHub Release Note撰写。处理Minor和Patch类型发布，协调自动打标签、版本递增及主分支同步，不涉及网站Changelog页面编写。
执行版本发布操作
生成GitHub Release说明
检查PR标题是否符合自动发布条件
npx skills add lobehub/lobehub --skill version-release -g -y
规范 LobeHub Zustand 状态管理，定义 Public/Internal/Dispatch 动作层级、命名约定及 Reducer/set 选择策略。新增 Class-Based Action 迁移模式与类型安全指南，优化前端状态更新流程。
编辑 src/store 目录下的代码
实现或重构 Zustand store slices
处理乐观更新或动作分发逻辑
npx skills add lobehub/lobehub --skill zustand -g -y
提供跨平台端到端测试能力，支持通过CLI验证后端、浏览器验证前端及CDP验证桌面应用。遵循计划-执行-结束三阶段流程，生成可视化证据与结构化报告。
cli test
test with cli
verify with cli
backend test with cli
local test
test in electron
test desktop
manual test
test report
npx skills add lobehub/lobehub --skill agent-testing -g -y
将重型领域功能拆分为可挂载的原子组件，通过模块图分离数据、动作与依赖，实现状态下沉和按需组装，避免上帝组件。
重业务拆分
拆成原子
god component
fat viewer
npx skills add lobehub/lobehub --skill compose-atoms -g -y
基于agent-testing的前端调试技能，用于定位渲染、状态及网络等边界问题。通过症状验证、隔离复现和边界追踪，精准定位数据异常点并提供修复指导。
前端间歇性渲染失败
状态管理或导航异常
浏览器端特定错误诊断
npx skills add lobehub/lobehub --skill debug-frontend-with-browser -g -y
用于创建、提交或拆分跨层叠 PR 的自动化流程，支持自动分支管理、关联 Issue 及生成符合规范的 PR 内容。
创建/提交 PR
拆分跨层分支为叠层 PR
npx skills add lobehub/lobehub --skill pr -g -y
用于交付验证的自证技能，支持发现或创建验收计划，捕获CLI、Web等多端证据并提交报告。
verify the task
collect evidence
prove it works
upload evidence
verify plan
npx skills add lobehub/lobehub --skill acceptance -g -y
