菜单
通用 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 的基础层。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | code-style-core |
| description | 通用 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 的基础层。 |
通用 TypeScript 编码规范，不绑定任何框架或架构。配套进阶 skill（按需安装）：
code-style-architecture — DI / 服务化 / 插件化 / 命令模式 / RxJScode-style-react — React 组件规范code-style-monorepo — monorepo 拆包与跨端工程化| 类别 | 规则 | 示例 |
|---|---|---|
| 普通 TS 文件 | kebab-case + 角色后缀 | session.service.ts, create-session.command.ts |
| React 组件文件 | PascalCase.tsx | SessionList.tsx |
| Hook 文件 | use-<name>.ts(x) | use-host-tree.ts |
| 目录 | kebab-case（组件所在目录也是） | terminal-tabs/, views/hooks/ |
| 测试文件 | __tests__/<name>.spec.ts | __tests__/session.service.spec.ts |
| 接口 | I 前缀 | ISessionConfig, ICommandService |
| 私有成员 | _ 前缀（含 protected） | private readonly _sessionMap |
| Observable 属性 | $ 后缀 | sessions$, _currentTheme$ |
| 常量 | SCREAMING_SNAKE | DEFAULT_TERM_TYPES, XXX_PLUGIN_NAME |
| 布尔值 | is/has/should/can 前缀 | isConnected, hasPendingWrites |
| 本地事件处理函数 | handleXxx | handleContextMenu |
| Props 回调 | onXxx | onSelect, onClose |
| 泛型参数 | T 主类型；U/V 次要；K key；P params；R return | Map<K, V> |
| 枚举 | PascalCase 名 + PascalCase 成员 | enum LogLevel { Silent, Error } |
Service 后缀是硬性的（个人偏好，全项目一致）：任何注册进 DI 的服务，接口、实现类、文件名三者都以 Service 结尾，即使职责是 router / bus / manager / registry。
❌ IDeepLinkRouter / DeepLinkRouter / deep-link.router.ts
✅ IDeepLinkRouterService / DeepLinkRouterService / deep-link-router.service.ts
例外：*Controller 与 *Plugin 保留各自后缀；纯协议门面可留 Client 中缀但仍以 Service 结尾（IRPCClientService）。
interface，联合/函数签名/派生用 typetype Status = 'idle' | 'connecting'；需要反查或数值语义才用 enumNullable<T>（项目工具类型），禁止散写 T | null | undefinedreadonlyany 默认避免（lint 至少 warn）；与底层库互操作的目录可局部豁免，但豁免范围要在 lint 配置显式声明async + Promise<T> 返回类型表达(x) => xif 必须用大括号，禁止 if (!v) return; 单行写法（lint 只卡 multi-line，本条按个人偏好从严）// TODO: <说明> 或 // TODO(@author): <说明>@param / @returns / @example；内部实现不写 JSDocheader/header）强制到所有 .ts/.tsx，不靠人工| # | 主题 | 文件 | 何时查阅 |
|---|---|---|---|
| 1 | 命名细则 | references/01-naming.md | 命名拿不准、新建文件/目录时 |
| 2 | TypeScript 类型与 class 结构 | references/02-typescript.md | 类型选择、class 成员排序、abstract 使用时 |
| 3 | 注释·格式·lint 基线 | references/03-comments-style.md | 配 lint、写注释、争论格式时 |
DI + RxJS + 命令模式架构的通用编码规范。适用于任何基于依赖注入（redi 或同类容器）、RxJS 响应式、插件化的 TypeScript 项目。编写 Service/Controller/Plugin/Command、DI 注入（createIdentifier/@Inject/@Optional/@DependentOn）、Observable（$ 后缀/Subject 封装）、Disposable 生命周期、拦截器责任链、错误处理与日志、test bed 测试时使用。
TypeScript monorepo 拆包与跨端工程化规范。新建 monorepo、拆分/新建包、设计包边界、决定代码放哪个包时使用，尤其涉及：三维拆包原则（功能域×平台层×抽象层级）、契约包 + 对称多端实现（Electron 双进程/web/mobile）、逻辑包与 -ui 包分离、包标准形态（exports/publishConfig/peerDependencies）、共享 infra 包收敛工程配置、ESLint 架构护栏（禁桶导入/穿透导入/自包导入/facade 隔离）、facade 门面与 preset 套餐分层 API、turbo 任务编排与测试组织。
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 搭配效果最佳。
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 必读。