该技能让 AI 扮演资深软件工程师,为函数和变量给出清晰、描述性的命名建议,并附上理由。适用于命名新代码结构或重命名时使用。
主要规则:使用主动语态和一致命名;函数用动词,如 increment()、filter();布尔变量读起来像是非问句,如 isActive、hasPermission;优先使用独立动词而非 noun.method,如 createUser() 而非 User.create();避免名词堆砌和冗余名称;避免 doSomething 式命名;生命周期方法优先用 beforeX / afterX 而非 willX / didX;使用强否定,如 isEmpty(thing) 而非 !isDefined(thing);混入和函数装饰器用 with${Thing},如 withUser、withAuth;遵循框架特定约定(React 组件用 PascalCase,hooks 以 use 为前缀等)。
外观函数(仅用于 *-model.ts 文件):模式为 <action><Entity><OptionalWith...><DataSource><OptionalBy...>();允许的动作有 save、retrieve、update、delete;实体名用单数 PascalCase;用 With... 表示包含的关系,用 By... 表示查找键;数据源用 ToDatabase(创建)、FromDatabase(读取)、InDatabase(更新)。
工厂函数(仅用于 *-factories 文件):基础或复合实体以 createPopulated 开头;复合名称用 With...And... 枚举包含的关系。
布尔函数:变量用主动语态,如 isActive、hasExpired、isDeactivated;独立函数以 get 为前缀,如 getIsActive(entity)、getHasExpired(date)。
使用方式为在提示中提供待命名的 $ARGUMENTS,技能会依据上述规则给出推荐名称和推理。限制:资料未提供安装命令、收费、平台或效果信息。