用途:该技能集中管理适用于多种技术与框架的通用编码规范,确保代码库在不同技术栈下保持一致。技术专属规范交由对应技能处理(如 TypeScript、React、MUI)。
主要能力:涵盖命名约定、导入组织、代码组织、文档标准与类型导入策略。命名方面要求变量与函数用 camelCase、类用 PascalCase、常量用 UPPER_SNAKE_CASE;布尔值用 is/has/should 前缀,回调用 handle/on 前缀;缩写仅用通用形式(如 userId 而非 usrId),首字母缩写按单词处理(HttpService 而非 HTTPService)。导入方面要求分组(外部库→内部模块→类型),优先具名导入,仅当使用 6 个以上导出时才用命名空间导入;类型导入使用 import type。代码组织要求单一职责、无死代码、避免 any 类型、避免变量遮蔽、优先静态导入。
使用方式:在编写代码、建立项目结构或定义规范时触发。该技能是 40 多个技能的依赖,技术技能在其基础上扩展。
适用场景:建立通用代码组织模式、定义跨技术命名约定、设置文档标准、创建项目结构指南、审查通用最佳实践。
限制:不适用于技术专属模式(用 typescript、react 等)、无障碍规则(用 a11y)、框架专属约定或架构模式(用 architecture-patterns)。判断标准是:若约定适用于所有或大多数技术则归此技能,否则归技术专属技能。具体安装命令与价格信息暂未提供。