用途:这是一个通用编码规范技能。当用户请求生成代码时,生成的代码应遵循当前规范,用于统一代码风格与质量。
主要能力与规范要点:
- 异常处理:开发阶段尽量不捕获异常,让问题暴露;不要捕获 Exception 或 Throwable,只在确切知道特定异常且能合理处理时才精确捕获。
- 注释:代码自解释,优先方法、类级别注释,而非行内注释。
- 函数式与链式调用:集合、流处理优先链式调用,如 classes.flatMap(...).filter(...).toList();若链式仅一个节点且无法一行写完,改用原生循环。
- 控制流:减少嵌套,建议不超过 3 层;优先卫语句提前返回;等待或轮询用“超时时间 + 轮询间隔”而非循环 N 次。
- 不可变性:优先 final、val、const,纯函数避免副作用。
- 日志:生产代码禁用 System.out.println、console.log、print,复用项目日志封装或成熟框架。
- 方法设计:单一职责,方法建议不超过 50 行,参数不超过 4 个,降低圈复杂度,遵循 DRY,避免中间透传层。
- 类型安全:可能无结果时用 Optional<T>、std::optional<T>、Option<T> 显式表达,避免隐式返回 null。
- 命名:相同语义行为使用统一 API 名称,通过参数重载区分输入源。
- 单元测试:核心业务逻辑覆盖率 80% 以上,测试独立、不依赖外部环境,命名清晰描述场景,使用表达力强的断言。
- 构建与验证:仅当识别到支持默认构建目录或共享缓存的系统(如 Gradle、Maven、npm)时尝试构建;CMake 等需手动指定构建目录的系统跳过自动编译;严禁提交无法编译的代码。
使用方式:作为技能约束代码生成过程,具体安装与调用方式资料未提供。
适用场景:需要统一编码规范、生成符合上述实践代码的开发任务。
限制:示例以 Java 为主;其余语言、平台、收费与效果等资料暂未提供。