Langfuse 后端开发指南 - tRPC、Prisma、ClickHouse 最佳实践与架构规范

backend-dev-guidelines by langfuse/langfuse

216 周安装量

24,500 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/langfuse/langfuse --skill backend-dev-guidelines

代码规范系统架构 API

🇨🇳中文介绍

后端开发指南

此技能适用于 web/、worker/ 和 packages/shared/ 中的后端和 API 工作。

何时应用

创建或修改 tRPC 路由器和过程
创建或修改公共 API 端点
创建或修改队列处理器、生产者或基于队列的工作流
构建或重构后端服务和存储库
处理后端身份验证、中间件、验证或可观测性
更新 Prisma 或 ClickHouse 访问模式
添加或修复后端测试

如何阅读此技能

当任务涉及多个后端领域或需要端到端检查清单时，请从 AGENTS.md 开始。
当范围较窄时，仅阅读与工作匹配的特定参考文件。

参考映射

主题	何时阅读此文件	文件
架构和包边界	您需要了解 web/worker/shared 划分、请求流或队列生命周期时	references/architecture-overview.md

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

🇺🇸English

Backend Development Guidelines

Use this skill for backend and API work across web/, worker/, and packages/shared/.

When to Apply

Creating or modifying tRPC routers and procedures
Creating or modifying public API endpoints
Creating or modifying queue processors, producers, or queue-backed workflows
Building or refactoring backend services and repositories
Working on backend auth, middleware, validation, or observability
Updating Prisma or ClickHouse access patterns
Adding or fixing backend tests

How to Read This Skill

Start with AGENTS.md when the task spans multiple backend areas or you need the end-to-end checklists.
Read only the specific reference file that matches the work when the scope is narrower.

Reference Map

Topic	Read this when	File
Architecture and package boundaries	You need the web/worker/shared split, request flow, or queue lifecycle	references/architecture-overview.md
Routing and controllers	You are writing tRPC procedures, public API routes, or queue entrypoints	references/routing-and-controllers.md
Middleware and auth	You are changing request auth, permissions, or middleware composition	references/middleware-guide.md
Services and repositories	You are placing business logic, repository code, or DI patterns	references/services-and-repositories.md
Database access	You are touching Prisma, ClickHouse, tenant filters, or query patterns	references/database-patterns.md
Configuration	You are adding env vars, startup config, or runtime toggles

Full Compiled Guide

Read AGENTS.md for the complete backend guide with checklists, directory conventions, imports, architecture, and cross-cutting practices.

Weekly Installs

141

Repository

langfuse/langfuse

GitHub Stars

23.6K

First Seen

Jan 21, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

codex127

opencode125

gemini-cli122

claude-code121

github-copilot121

cursor116