2026年8月29日

tech-stack 技能——确定性的技术栈选择

tech-stack 技能如何通过将项目类型映射到精确、有主见的技术选择,消除启动新项目时的猜测。

每个新项目都始于一个选择:使用哪些技术。若放任不管,AI 助手会猜测、询问,或默认采用它最近见过的方案。tech-stack 技能通过将项目类型映射到固定、有主见的技术栈来消除这种不确定性——自动完成,无需询问。

该技能涵盖前端、后端、AI/ML、实时、后台任务、事件驱动系统、媒体处理和基础设施。每个类别都有必需的技术栈。这一选择不是建议——每当创建新项目、服务或模块时,它都会被自动应用。

选择如何运作

判定从对项目类型进行分类开始。静态单页站点映射到 HTML、Tailwind CSS 和 Alpine.js——不使用 SPA 框架。微服务 API 映射到 NestJS 搭配 Fastify(强制,绝不使用 Express)、PostgreSQL、Prisma、Redis 和 NATS。Python API 使用 FastAPI、uvicorn、uv 进行依赖管理,以及 ruff 进行代码检查和格式化。实时聊天服务映射到 Node.js 搭配 Socket.IO 或 ws,外加 Redis。

两条工具链规则适用于所有语言。对于 Python:uv 处理依赖,ruff 取代 flake8 和 black,pytest 是测试运行器。对于 Node/TypeScript:pnpm 是包管理器,vitest 用于单元测试,Playwright 处理 E2E。两者都强制执行 pre-commit 钩子。

版本纪律

该技能将版本纪律视为强制要求,而非可选。每个依赖都必须是 latest stable 版本。当新的主版本有破坏性 API 变更时,代码要适配——只有在存在关键、有记录、未解决的 bug 时,降级才可接受。动机很具体:此前发生过一次事件,AI 在 Prisma 7 已是当前稳定版时提议使用 Prisma 6,直到审计时才被发现,并需要返工。

每次安装依赖后,立即运行 pnpm outdated 或其 Python 等价命令。零过时包是通过条件,而非尽力而为的目标。

硬性规则

该技能的禁止清单很明确:落地页不使用 SPA,后端服务必须使用 Docker,依赖版本不得浮动,不得缺少锁文件,适用 Fastify 时不得使用 Express。涉及多个服务时,必须使用 Docker Compose。“一个容器,一个职责”的约束不可协商。具体到服务器备份,restic 搭配 Backblaze B2 是标准化选择——技术栈将其标注为已在多台生产服务器上验证,以避免每次都重新审视该决策。

tech-stack 技能与测试技能(按技术栈指定测试框架)以及系统化调试技能(当所选技术栈中某处出现故障时应用)协同运作。更宏观的图景见什么是 Datarim。