code-style-monorepo

스타0

포크0

업데이트2026년 7월 3일 07:59

TypeScript monorepo 拆包与跨端工程化规范。新建 monorepo、拆分/新建包、设计包边界、决定代码放哪个包时使用，尤其涉及：三维拆包原则（功能域×平台层×抽象层级）、契约包 + 对称多端实现（Electron 双进程/web/mobile）、逻辑包与 -ui 包分离、包标准形态（exports/publishConfig/peerDependencies）、共享 infra 包收敛工程配置、ESLint 架构护栏（禁桶导入/穿透导入/自包导入/facade 隔离）、facade 门面与 preset 套餐分层 API、turbo 任务编排与测试组织。

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

출처

termlnk

termlnk/termlnk-code-style

GitHub 저장소 열기 Creator 저장소 보기

다운로드

通用 Monorepo 拆包与跨端工程化规范

概述

核心心智：包边界即架构边界，命名即依赖方向，工程约束 lint 化。

关键规则速查

拆包三维原则

包边界同时按三维切：

功能域：能被独立开关的特性 = 独立包（sheets-filter、port-forwarding）
平台层（同构分离铁律）：有 UI 的特性拆「逻辑包 + -ui 包」，逻辑包必须能在 Node/Worker 跑，不 import 任何浏览器 API
抽象层级：core → engine → 领域 → 特性 → 特性 UI

命名即架构：<域>-<特性>[-ui|-core|-mobile]，前缀标域、后缀标平台层，肉眼可判依赖方向。

契约包 + 对称多端实现（跨进程/跨端核心模式）

接口 + DI 标识符放运行时无关的契约包；各端（主进程/渲染进程/web/mobile）分别 implements 同一接口、注册同一标识符
❌ 禁止 *ClientService 后缀（泄漏运行时位置）；跨进程方法签名一律 Promise<T> / Observable<T>
平台适配器放 app 的 platform/ 目录经 override 注入，让 *-core 包保持零平台 import

workspace 目录四分法

packages/           可发布/共享库包
packages-internal/  应用私有实现包（不发布）
internal/ (common/) 工程基建（eslint/tsconfig/构建配置，private）
apps/               应用壳：只做组装 + 平台粘合，不写业务

应用 = 插件清单 + override 表

app 入口只做 new Core(config) → 顺序 registerPlugin(XxxPlugin, config) → core.start()。跨端差异 = 换插件清单 + 换 override 实现，不分叉核心逻辑。

ESLint 架构护栏（必配）

no-barrel-import（禁桶导入）、no-penetrating-import（禁穿透导入）、no-self-package-imports（禁自包导入）、facade 隔离双规则。豁免名单 = 技术债清单，禁止新增。

章节索引 — 按需打开

#	主题	文件	何时查阅
1	拆包原则与契约包	`references/01-package-splitting.md`	新建包、划边界、跨进程/端共享时
2	包的标准形态	`references/02-package-anatomy.md`	写 package.json/tsconfig/目录结构时
3	工程基建与护栏	`references/03-infra.md`	配 eslint/turbo/测试/CI 时
4	跨端与多环境	`references/04-cross-platform.md`	desktop/web/mobile/worker 适配时
5	分层 API（facade/preset）	`references/05-api-layering.md`	设计对外 API、做 SDK 时

이 저장소의 다른 Skills

같은 저장소

code-style-architecture

termlnk/termlnk-code-style

DI + RxJS + 命令模式架构的通用编码规范。适用于任何基于依赖注入（redi 或同类容器）、RxJS 响应式、插件化的 TypeScript 项目。编写 Service/Controller/Plugin/Command、DI 注入（createIdentifier/@Inject/@Optional/@DependentOn）、Observable（$ 后缀/Subject 封装）、Disposable 生命周期、拦截器责任链、错误处理与日志、test bed 测试时使用。

2026-07-030

code-style-core

termlnk/termlnk-code-style

通用 TypeScript 代码规范（命名·类型·注释·格式），适用于任何 TS/TSX 项目。编写、审查或重构 .ts/.tsx 文件时使用，尤其涉及文件命名（kebab-case + 角色后缀 / PascalCase.tsx）、标识符命名（I 前缀/_ 前缀/$ 后缀/SCREAMING_SNAKE/is-has-should-can）、interface vs type 选择、Nullable<T>、enum vs 联合类型、class 成员顺序、注释语言与密度、缩进引号分号等格式硬约束时。这是所有 code-style-* 系列 skill 的基础层。

2026-07-030

code-style-react

termlnk/termlnk-code-style

React 组件通用编码规范。编写、审查或重构 React 组件（.tsx）时使用，尤其涉及组件定义（export function + IXxxProps）、design/ui 分层、与 DI/Observable 桥接（useDependency/useObservable/useObservableRef）、自定义 hooks、Tailwind + cva + cn() 样式方案、语义色 token、组件注册插槽（ComponentManager/IUIPartsService/connectInjector）、i18n（LocaleService.t）时。可独立使用；与 code-style-architecture 搭配效果最佳。

2026-07-030

termlnk-code-style

termlnk/termlnk-code-style

Termlnk 仓库专属编码规范（叠加在 code-style-core/architecture/react/monorepo 四个通用 skill 之上的增量层）。编写、审查或重构 Termlnk 仓库（packages/*、packages-internal/*、apps/{desktop,web,mobile}）任何 .ts/.tsx 时使用，尤其涉及：菜单系统（下拉/右键/mergeMenu/triggerContextMenu/commandId）、Base46 主题与颜色（tm: 前缀类/base_30/base_16/IThemeService/xterm 配色/换肤透明度）、插件配置键（config.schema.ts/ConfigRepository 持久化 subKey）、tRPC 双进程契约（rpc-server/rpc-client 对称实现）、目录与包名契约（plugin.ts/@termlnk 包名/*-mobile 后缀）、mobile babel 限制时。新建插件包或 plugin.ts 必读。

2026-07-030

name

code-style-monorepo

description

通用 Monorepo 拆包与跨端工程化规范

概述

核心心智：包边界即架构边界，命名即依赖方向，工程约束 lint 化。

关键规则速查

拆包三维原则

包边界同时按三维切：

功能域：能被独立开关的特性 = 独立包（sheets-filter、port-forwarding）
平台层（同构分离铁律）：有 UI 的特性拆「逻辑包 + -ui 包」，逻辑包必须能在 Node/Worker 跑，不 import 任何浏览器 API
抽象层级：core → engine → 领域 → 特性 → 特性 UI

命名即架构：<域>-<特性>[-ui|-core|-mobile]，前缀标域、后缀标平台层，肉眼可判依赖方向。

契约包 + 对称多端实现（跨进程/跨端核心模式）

接口 + DI 标识符放运行时无关的契约包；各端（主进程/渲染进程/web/mobile）分别 implements 同一接口、注册同一标识符
❌ 禁止 *ClientService 后缀（泄漏运行时位置）；跨进程方法签名一律 Promise<T> / Observable<T>
平台适配器放 app 的 platform/ 目录经 override 注入，让 *-core 包保持零平台 import

workspace 目录四分法

packages/           可发布/共享库包
packages-internal/  应用私有实现包（不发布）
internal/ (common/) 工程基建（eslint/tsconfig/构建配置，private）
apps/               应用壳：只做组装 + 平台粘合，不写业务

应用 = 插件清单 + override 表

app 入口只做 new Core(config) → 顺序 registerPlugin(XxxPlugin, config) → core.start()。跨端差异 = 换插件清单 + 换 override 实现，不分叉核心逻辑。

ESLint 架构护栏（必配）

章节索引 — 按需打开

#	主题	文件	何时查阅
1	拆包原则与契约包	`references/01-package-splitting.md`	新建包、划边界、跨进程/端共享时
2	包的标准形态	`references/02-package-anatomy.md`	写 package.json/tsconfig/目录结构时
3	工程基建与护栏	`references/03-infra.md`	配 eslint/turbo/测试/CI 时
4	跨端与多环境	`references/04-cross-platform.md`	desktop/web/mobile/worker 适配时
5	分层 API（facade/preset）	`references/05-api-layering.md`	设计对外 API、做 SDK 时