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 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/monorepo/raw/index.md(查看排版版本)