monorepo

一个集成了后端、前端、数据分析与基础设施的TypeScript单体仓库开发框架。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:monorepo。
它的用途是:一个集成了后端、前端、数据分析与基础设施的TypeScript单体仓库开发框架。
完整的 Skill 内容见:https://321skill.com/skills/monorepo/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“我需要基于这个monorepo模板创建一个新服务,包含API和数据库表。”,AI可以引导你使用仓库内置的 `node scripts/create-repository-service.mjs` 脚手架脚本,自动生成服务模板、Zod模式、CDK配置以及对应的开发检查清单。或者,当你说“帮我部署开发环境的后端”,AI可以指导你运行对应的CDKTF部署命令,并解释资产打包和分发的步骤。

介绍

这个Skill提供了一个高度集成的TypeScript单体仓库(Monorepo)解决方案,旨在解决全栈开发中服务分散、环境配置复杂和部署流程繁琐的问题。它预置了Express 5后端、Next 16营销网站、基于EventBridge/DynamoDB的数据分析处理流水线,并使用CDK for Terraform(CDKTF)统一管理基础设施,让开发者可以快速启动一个包含前后端和云资源的完整项目。

使用上,开发者通过简单的npm命令即可安装依赖、生成开发环境所需的基础设施配置(如数据库表名),并同时启动后端和前端开发服务器。仓库内置了dotenvx进行加密环境变量管理,并通过工作区(workspace)脚本封装了构建、部署等复杂操作。

它非常适合全栈开发、运维开发或智能体开发者,他们需要在一个统一的代码库中管理多个相互关联的应用和服务,并希望基础设施即代码(IaC)与业务逻辑紧密集成。对于需要快速原型验证或构建内部工具平台的团队,这个结构清晰的仓库也能节省大量脚手架搭建时间。

需要注意的是,该项目明确标注为“进行中”(WIP),尚未达到生产就绪状态。因此,建议将其用于学习、实验或作为内部项目的起点,而非直接用于关键生产环境。初次使用时,需要按照指引处理加密的环境变量示例文件。

核心特点

与常见的单体仓库模板相比,它深度集成了CDKTF进行基础设施管理,并原生内置了面向AI Agent的工作流支持和Memory Bank文档体系,将开发、部署与智能体协作工具链统一在同一个仓库中。

注意事项

该项目尚处于开发阶段(WIP),不适用于对稳定性要求极高的生产环境。

常见问题

如何快速启动所有开发服务?

依次运行:1. npm install 安装依赖;2. 为API、Analytics、Client-Website三个栈生成CDK开发输出;3. 分别运行 npm -w node-server run dev 和 npm -w client-website run dev 启动后端和前端。

加密的环境变量文件如何处理?

仓库提供的 .env.dev 等是加密示例。若无对应私钥,应删除它们并创建自己的.env文件,使用各工作区内的 decrypt-envs/encrypt-envs 脚本管理,切勿提交解密后的文件。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/monorepo/raw/index.md 读取 monorepo 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。