用途:在编写代码、注释、文档、提交信息、分支名等所有文本时,使用尊重且无障碍的术语。核心原则是措辞很重要。
主要能力:提供术语替换对照表,涵盖分支名(master→main,slave→replica/secondary/follower)、访问控制(whitelist→allowlist,blacklist→denylist)、主从关系(master/slave→primary/replica、leader/follower)、性别化用语(man hours→person hours,guys→everyone,he/she→they)、能力相关(sanity check→validity check,dumb→silent)、暴力相关(kill→stop/terminate,abort→cancel,nuke→delete)及其它(dummy→placeholder,native→built-in,first-class→built-in,grandfathered in→exempted)。并给出配置、文档、注释、错误信息中的上下文示例。
使用方式:按对照表替换术语。改动既有代码时,小范围(同文件)可随改动重命名并更新相关文档,提交信息注明“重命名为包容性术语”;大范围(多文件)另建议题,先完成当前工作;公共 API 先记录弃用计划,添加指向新术语的 deprecated 别名,逐步迁移,主版本中移除。分支名与提交信息也遵循该规范。
适用场景:代码审查、新代码与文档编写、术语重构。含检查清单,覆盖 master/slave、whitelist/blacklist、性别化语言、能力相关负面词、变量与函数名、错误信息与注释。
限制:资料未说明其强制力或自动检测机制;部分行业标准用语(如 execute query)被视为可接受。参考资源含 Google 开发者风格指南与 Inclusive Naming Initiative。该技能被 issue-driven-development 步骤 7 与 comprehensive-review 风格标准采用。