SuperAPI AI 工具集

code-quality

测试与质量

查看项目

更新于 10-15 19:52

技能介绍

用途:该技能提供编程哲学与质量标准,在编写或审查代码时自动应用,帮助控制复杂度、改善模块化并识别代码异味。

主要能力:

  • 复杂度管理:将复杂度视为依赖加晦涩,关注变更放大、认知负荷、未知未知等征兆,主张对渐进式复杂度“零容忍”,提前投入设计,避免制造技术债的战术捷径。
  • 模块化原则:深模块(简单接口实现强大功能)、信息隐藏、通用化设计、避免“类爆炸”。
  • 代码异味识别:重复逻辑/复制粘贴、过紧耦合或循环依赖、脆弱设计、意图不清或命名含糊、无实际收益的过度工程;识别时简要说明问题并给出1–2个重构方向及利弊。
  • 错误处理策略:尽可能通过设计消除错误、在低层屏蔽异常、用通用处理器聚合异常、对罕见不可恢复错误直接崩溃。
  • 注释标准:先自解释代码;注释讲WHY而非WHAT;应注释设计决策与取舍、非显而易见行为、接口契约、边界情况、跨模块依赖;不应注释自明代码、良好命名、标准模式;改代码时删除复述性注释、保留解释原因的注释、更新过期注释。

使用方式:资料未提供具体安装或调用命令,仅说明在编写或审查代码时自动应用。

适用场景:日常编码、代码审查、重构与设计评审。

限制:资料未提供支持的编程语言、平台、配置方式与收费信息。