用途:该技能充当资深软件工程师,为指定的代码结构(如函数、变量)给出命名建议并附理由。
主要能力与命名规则:
- 通用规则:使用主动语态,命名清晰一致;函数用动词,如 increment()、filter();布尔变量读起来像是非问句,如 isActive、hasPermission;优先使用独立动词而非 名词.方法,如 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... 表示查找键;DataSource 为 ToDatabase(创建)、FromDatabase(读取)、InDatabase(更新)。
- 工厂函数:仅适用于 *-factories 文件;基础或复合实体以 createPopulated 开头;复合名称用 With...And... 枚举包含的关系。
- 布尔函数:变量用主动语态,如 isActive、hasExpired、isDeactivated;独立函数加 get 前缀,如 getIsActive(entity)、getHasExpired(date)。
使用方式:调用时传入待命名的内容($ARGUMENTS),工具会按上述规则给出推荐名称并说明理由。
限制:资料未提供收费、价格、平台、效果或具体安装命令等信息;上述规则为技能声明的约定,实际适用取决于项目上下文。