SuperAPI AI 工具集

meaningful-identifiers

编程与开发

查看项目

更新于 11-15 00:54

技能介绍

用途

该技能为 TypeScript 代码中的回调参数和局部变量提供命名指导,核心原则是:变量名必须描述它所承载的值。它主要面向编写或重构循环、数组回调(map/filter/find/reduce)等场景。

主要规则

  • 数组回调参数按元素的领域类型命名,例如 batches.map((batch) => …)、bins.filter((bin) => …)、checkpoints.find((checkpoint) => …)。
  • 不要把 right、left、column 用于并非排序操作数或表格列的值。
  • reduce 累加器按其累计的内容命名:运行总和用 sum 或 total,而不是 step。
  • 百分位或比率参数按其代表的量命名(如 percentileRank、multiplier),而不是使用无关的领域名词。

应保留的正确用法

  • 排序比较器:(left, right) => left - right。
  • 在真实的 .columns 数组上:(column) => column.key。
  • 当元素确实是行数据时:for (const row of …Rows)。

适用场景与限制

该技能适用于 TypeScript 循环、数组回调和局部变量命名的编写与重构。资料未提供安装方式、收费信息、平台支持范围或具体使用步骤,这些内容暂未提供。