Communitygithub.com

lobehub/lobehub

用於撰寫 LobeHub 公開網站文件(docs/**),涵蓋自架、部署、遷移與配置指南。不包含產品更新日誌與原始碼 API 文件。

lobehub 是什麼?

這個技能專門用於撰寫和維護 LobeHub 公開網站的文件,所有文件都存放在 `docs/` 目錄下。它涵蓋了自架、部署、遷移和配置等主題,但不包括產品更新日誌和原始碼 API 文件。該技能要求開發者在撰寫前先閱讀 `../../../DESIGN.md` 中的「語音與內容」章節,並針對 `docs/self-hosting/**` 參考 `references/self-hosting.md` 的目標受眾。它強調驗證目前程式碼中的聲明、預設值、指令、限制與回滾行為,並偏好採用單一規範頁面、推薦路徑、簡短可執行的步驟,以及可見的驗證結果。此外,若發布路徑變更,必須更新內部連結並在落地儲存庫中建立經過測試的永久重新導向,以保留地區前置詞與查詢參數。最後,針對變更的每個頁面執行重點文件檢查。對於 `docs/changelog/**`,則應改用 `../docs-changelog/SKILL.md`。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lobehub/lobehub/tree/HEAD/.agents/skills/write-landing-docs

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

撰寫落地文件

  • 公開網站文件位於 docs/** 目錄下。
  • 草稿前,請先閱讀 ../../../DESIGN.md 中的「語音與內容」章節。
  • 對於 docs/self-hosting/**,請參閱 預設目標受眾。
  • 根據當前程式碼驗證所有聲明、預設值、指令、限制以及回滾行為。
  • 建議採用一個規範頁面、一條推薦路徑、一系列簡短可執行的步驟,以及一個可見的驗證結果。保持英文與簡體中文版本內容一致。
  • 若某個已發布的路徑發生變更,請更新內部連結,並在落地儲存庫中建立一個經過測試的永久重新導向,該重新導向需保留地區前置詞與查詢參數。
  • 針對每個已變更的頁面執行重點文件檢查。

對於 docs/changelog/**,請改用 ../docs-changelog/SKILL.md。

Individual skills in this repo

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

lobehub/add-provider-doc

Add documentation for a new AI provider — usage docs, env vars, Docker config, image resources.

lobehub/add-setting-env

Add server-side environment variables that control default values for user settings.

lobehub/debug

Debug package usage guide. Use when adding debug logging, understanding log namespaces, or implementing debugging features. Triggers on debug logging requests or logging implementation.

lobehub/desktop

Electron desktop development guide — IPC handlers, controllers, preload scripts, window/menu management.

lobehub/drizzle

LobeHub Drizzle ORM schema and query style. Use for pgTable schemas, indexes, joins, inferred types, db.select/db.query, schema fields, foreign keys, junction tables, or postgres query patterns.

lobehub/hotkey

Add or edit LobeHub keyboard shortcuts. Use for HotkeyEnum, HOTKEYS_REGISTRATION, combineKeys, useHotkeyById, tooltip hotkeys, shortcut scope, conflicts, or Cmd/Ctrl key combos.

lobehub/i18n

LobeHub i18n with react-i18next. Use for user-facing strings, locale keys, namespaces, useTranslation, t(), interpolation, zh-CN/en-US previews, hardcoded UI copy, or pnpm i18n.

lobehub/linear

Linear issue management. Use for LOBE-xxx issues, Linear links, PRs referencing Linear, retrieving issues, updating status, completion comments, or sub-issue trees.

lobehub/microcopy

UI copy and microcopy guidelines. Use for user-facing copy, buttons, errors, empty states, onboarding, i18n wording, translation, or copy improvements in Chinese or English.

lobehub/modal

LobeHub imperative modal conventions. Use when creating or migrating modals, dialogs, popups, confirm flows, ModalHost wiring, createModal, confirmModal, useModalContext, or base-ui modal APIs.

lobehub/pr

Create a PR for the current branch (targets `canary` by default), including splitting one cross-layer branch into ordered stacked PRs so a lower layer (db / shared package / server TRPC) merges before its callers (desktop / CLI / UI). Use when the user asks to create / submit a PR, or to split a branch because clients call a server contract that isn't on the trunk yet. Triggers on 'pr', 'create pr', 'submit pr', 'open a PR', 'pull request', 'split this PR', 'stacked PR', 'backend should merge first', '提 PR', '提个 PR', '新建 PR', '拆 PR', '后端先合', '分层合并'.

lobehub/project-overview

LobeHub open-source monorepo architecture map. Use when locating code layers, understanding apps/packages/src layout, business stubs, project structure, or onboarding to the repository.

lobehub/react

LobeHub React component conventions. Use when editing TSX UI, choosing base-ui vs @lobehub/ui vs antd, styling with antd-style, routing, desktop variants, layouts, or component state.

lobehub/store-data-structures

LobeHub Zustand store data-shape patterns. Use when designing store state, list/detail splits, normalized maps, reducers, messagesMap, topicsMap, or choosing shared type sources.

lobehub/testing

Vitest testing guide. Use when writing or updating tests, fixing failing tests, improving coverage, debugging test issues, or setting up mocks.

lobehub/typescript

LobeHub TypeScript style and type-safety guide. Use when editing TS/TSX/MTS, fixing types, choosing interface vs type, avoiding any/object, import type, async flow, or ts-expect-error.

lobehub/upstash-workflow

LobeHub Upstash Workflow and QStash guide. Use for async workflows, process/paginate/execute fan-out, serve handlers, context.run/call/sleep, or workflow triggers.

lobehub/version-release

Version release workflow — release process and GitHub Release notes (not docs/changelog pages).

lobehub/zustand

LobeHub Zustand store conventions. Use when editing src/store, store slices, public/internal actions, dispatch actions, flattenActions, optimistic updates, selectors, maps, or class action migration.

相關技能