【免费下载链接】vibe-coding-toolkitA curated, battle-tested AI-coding toolkit: Claude Code plugins, subagent orchestration, quality gates, and ready-to-copy prompts, extracted from real production use.项目地址https://gitcode.com/gh_mirrors/vi/vibe-coding-toolkit点击查看免费下载vibe-coding-toolkit 是一个经过实战检验的 AI 编程工具包其中内置了一套可直接复制到项目的 Next.js 服务端架构模板用 Drizzle 管理数据库连接、用 Zod 校验环境变量、用 Pino 输出脱敏后的结构化日志。本文带你逐层解析这套模板的设计思路帮你在 AI 辅助编程Vibe Coding场景中快速搭起一个规范、安全、可测试的服务端骨架。为什么需要现成的服务端架构模板很多新手用 AI 写 Next.js 项目时会遇到这些反复出现的坑环境变量不校验DATABASE_URL拼错要到运行时才发现数据库连接每次请求都新建连接池泄漏日志里不小心把密码、token 打了出来AI 生成的代码直接console.log页面和数据库耦合混乱。vibe-coding-toolkit 的答案是把这些生产级细节沉淀为可复制的模板而不是让 AI 每次重新发明。模板位于 templates/next/官方使用顺序和决策依据记录在 docs/06-project-defaults.md 中。模板目录总览一次看懂服务端分层整套模板的文件组织非常克制核心就三个目录加两个配置文件templates/next/ ├── drizzle.config.ts.example # Drizzle 迁移工具配置 ├── vitest.config.mts.example # Vitest 测试配置 └── src/ ├── db/ │ ├── index.ts.example # 数据库连接池唯一入口 │ ├── index.test.ts.example # 连接池生命周期测试 │ └── schema/index.ts.example # 表结构留空按需补充 └── lib/ ├── env-schema.ts.example # Zod 校验规则 ├── env.ts.example # 环境变量的唯一读取入口 ├── logger.ts.example # Pino 日志器 └── utils.ts.example # cn 类名合并工具每一块都配套了测试文件——这是这套模板最值得学习的点架构不只是代码还包括如何证明它是对的。Zod 落地实践环境变量先验证再使用环境变量的校验逻辑集中在 env-schema.ts.example。它做了两件很实用的事定义校验规则databaseUrlSchema要求连接串必须是postgres:或postgresql:协议且带主机名logLevelSchema则限定日志等级只能是trace到silent七种取值之一。统一的读取函数parseEnv校验失败时只抛出Invalid or missing environment variable: 变量名这样的错误不会把变量里可能包含的密码带进报错信息。随后 env.ts.example 只暴露getDatabaseUrl()和getLogLevel()两个函数文件首行是import server-only——从物理上阻止这段代码被打进浏览器端密钥永远不会出现在客户端 bundle 里。对应的测试 env.test.ts.example 甚至专门验证了错误协议 URL 被拒绝时测试用的敏感值不会出现在异常消息里把安全细节变成了可回归的检查项。Drizzle 落地实践一个有边界的连接池数据库访问的唯一入口是 db/index.ts.example 里的getDb()它的实现包含几个新手容易忽略的工程细节按需创建getDb()被调用时才创建连接池所以项目首次 build、lint、跑无 I/O 的测试都不需要真实数据库池化且有上限max: 5、5 秒连接超时、30 秒空闲回收避免连接无限增长缓存复用池实例挂在globalThis上开发时热更新HMR不会反复建池静默错误空闲连接出错时只记录错误码不打出完整连接串。drizzle.config.ts.example 则配置了 drizzle-kit方言为 PostgreSQLschema 指向src/db/schema/index.ts并支持DATABASE_URL_UNPOOLED直连地址部分云厂商跑迁移要求直连。一个容易被忽略的约定写在 schema/index.ts.example 里——schema 默认是空的注释明确要求只添加从产品描述派生出来的表不要内置虚构的业务数据。这防止了 AI 生成项目时塞进一堆假表。迁移流程遵循生成 SQL → 人工审阅 diff → 在受控目标执行相关规则详见 docs/06-project-defaults.md 的银行和架构章节。Pino 落地实践结构化日志与敏感信息脱敏日志模块 logger.ts.example 基于 Pino 构建核心是redact配置redact: { paths: [password, token, secret, authorization, cookie, DATABASE_URL, req.headers.authorization, ...], remove: true, },意思是无论日志对象里出现password、token、cookie还是完整请求头Pino 都会直接删除这些字段而不是打码。日志等级由前面介绍过的LOG_LEVEL环境变量控制缺省为info。测试文件 logger.test.ts.example 模拟了一次带满敏感信息的请求日志断言输出中不含任何密钥值、同时保留了requestId这类排查需要的上下文——脱敏和可用性必须同时成立。质量护栏ESLint 与 Vitest 如何守住架构光有模板还不够vibe-coding-toolkit 用 lint 规则强制架构不变形。完整版配置见 next-app.config.mjs.example它包含几条针对本架构的关键规则规则守护的边界quality/no-direct-console服务端日志必须走 Pino禁止console.logquality/no-direct-data-access页面app/和组件components/层禁止直接引用/db数据访问只能在专门的层drizzle/enforce-delete-with-where/enforce-update-with-where没有where条件的delete/update直接报错防止误清空表quality/max-lines350 行控制单文件复杂度测试方面vitest.config.mts.example 采用 Node 环境、别名指向src/。db/index.test.ts.example 用 mock 验证了缺配置时不建池多次调用只建一个池空闲错误不泄漏连接串三条核心行为。所有测试都不依赖真实数据库跑一遍vitest run即可验证架构完整。如何把模板用到自己的项目落地步骤很简单按 templates/README.md 的说明把templates/next/整棵目录复制到你的应用去掉.example后缀但保留.env.example安装依赖Drizzle、Zod、Pino、Vitest 等脚本示例见 docs/04-project-bootstrap.md 第 3 步在.env.local中配置DATABASE_URL和LOG_LEVEL.env.example只放变量名不放真实凭据运行drizzle-kit generate生成 SQL人工审阅后再执行迁移用lint typecheck test build组成的检查链验证全部命令可在 bootstrap 指南的脚本参考中找到。 提示模板里的 schema 是刻意留空的请先根据你的产品需求定义真实的表结构再执行迁移。小结这套 Next.js 服务端架构模板的价值不在代码量而在把三类高频问题标准化了Zod 管住输入、Pino 管住输出、Drizzle 管住数据再叠加 ESLint 边界规则和 Vitest 回归测试。无论是让 AI 从零搭项目还是给现有项目补规范这套模板都是可以直接复用的起点——完整决策依据请查阅 docs/06-project-defaults.md执行流程请查阅 docs/04-project-bootstrap.md。赞分享【免费下载链接】vibe-coding-toolkitA curated, battle-tested AI-coding toolkit: Claude Code plugins, subagent orchestration, quality gates, and ready-to-copy prompts, extracted from real production use.项目地址https://gitcode.com/gh_mirrors/vi/vibe-coding-toolkit点击查看免费下载相关推荐前后端分离架构实战从职责划分到 Next.js 全栈落地vibe-vibe 教程前后端分离架构实战从职责划分到 Next.js 全栈落地vibe vibe 教程 前后端分离是 Web 应用开发中最核心的架构思想之一前端负责呈现文档教程Vibe Coding示例工程vibe-vibe 心法实战6 个真实案例拆解思维模型如何落地 Vibe Codingvibe vibe 心法实战6 个真实案例拆解思维模型如何落地 Vibe Coding 本文基于 vibe vibe 开源教程 第二章「心法」的扩展案例库 h文档教程Vibe Coding示例工程SunnyUI基于C WinForm的终极开源控件库完全指南SunnyUI基于C WinForm的终极开源控件库完全指南 SunnyUI.NET是一款基于.NET Framework 4.0、.NET6、.NET8、UI组件桌面应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
