SuperAPI AI 工具集

monorepo-and-tooling

通用与其它

查看项目

更新于 10-16 02:36

技能介绍

用途:为 monorepo 项目提供结构约定与工具链规范,统一代码组织、命令执行和密钥管理,减少跨包构建与协作问题。

主要能力与约定:共享代码放在 packages/ 目录,应用专属代码放在 app/;用 Taskfile.yml 命令执行开发、测试和部署任务;环境变量与敏感数据不写入代码,通过 .env 等配置访问,用 .env.example 做文档示例,密钥在运行时经 CI/CD 或 gitignore 的 .env.local 注入。

依据资料中的“铁律”:始终将共享代码放 packages/、应用入口放 app/;绝不提交 .env 或密钥;始终用 Taskfile.yml 命令做开发、测试、部署;不绕过工作区运行器直接运行构建工具;依赖安装限定在所属工作区包内。

反模式提示:扁平根目录混放应用与共享代码会破坏依赖图与缓存;提交 .env 会让密钥永久留在历史中;临时 shell 命令难以维护且导致本地与 CI 不一致;绕过工作区直接构建会跳过缓存失效图;在非属主包安装依赖会造成重复与版本冲突。正确做法包括用导入规则约束目录、把 .env* 加入 .gitignore、在 Taskfile.yml 定义命令并用 task <name> 执行、使用工作区级命令(pnpm -w build、nx run、turbo run)、用 pnpm add --filter @scope/pkg dep 安装到指定包。

记忆协议(强制):开始前执行 cat .claude/context/memory/learnings.md;完成后记录新发现的模式或例外;假定中断,上下文可能重置,未写入记忆即视为未发生。

限制:资料未提供具体 Taskfile.yml 示例、支持的包管理器细节、Turborepo/Nx 版本要求与完整配置;仅适用于采用 monorepo 结构的项目。