用途:这是一项代码命名规范技能,核心原则是名称应描述代码在业务领域中的用途,而不是实现细节或历史背景。资料指出,类似“NewUserAPI”“ZodValidator”这类命名会造成混淆。
主要能力与规则:名称只表达“做什么”,不表达“怎么做”;避免时间性词汇(New、Old、Legacy、Improved、Enhanced、Unified、Refactored、Updated、Modern);避免暴露实现细节(如 Zod、JSON、MCP、SQL);除非模式本身就是目的,否则避免携带模式名(Factory、Builder、Manager 等);避免冗余限定词(Abstract、Base、Interface)。资料给出的正例包括 class ConfigValidator、const apiClient = new Client()、function createTool(),以及可读性强的领域语句如 user.authenticate()、order.calculateTotal()、payment.process()。
使用场景:变量、函数、类、模块命名;既有代码重构;代码审查反馈;API 设计。尤其在重构、替换实现、使用设计模式、记录变更时,容易加“New”“Improved”“Zod”“Factory”等字样,应特别注意。
核验清单:名称描述领域用途、不含实现细节、无时间语境、无不必要的模式名、与其他代码组合成可读句子、无 new/old/improved/wrapper。
限制与关联:资料未提供该技能的安装方式、运行命令、适用平台或收费信息。资料提及可与变量命名技能、撰写长效注释技能配合使用,但未给出具体实现步骤。
分类:coding