web-naming
Installation
SKILL.md
范围: 浏览器端 UI(React 组件、Hook、props、前端模块与相关测试文件名)。不覆盖纯后端 Node/Hono 库。Vue 专有约定见仓内 vue-* skills。仓内若有 typescript-best-practices:要不要判别联合 / branded type 以它为准(原则见 type-system-discipline,若仓内有)。本 skill 只规定这些结构的命名。未部署时用本 skill 的 string union / 数字枚举建议。
模式:
- Coding 模式:为新代码选名。按速查表与反模式表依次检查;有疑义时,以最能表达意图的名字为准。
- Review 模式:审查 PR diff 中的命名。重点找全大写缩写(
HTTPClient)、userID、数字枚举当真实零值、IFoo前缀、utils/helpers、布尔裸名、组件文件用小写(除非该仓已统一 kebab 组件文件)。 - Audit 模式:全库命名审计。用子代理并行扫描:(1) 布尔裸名与缩写大小写,(2)
I前缀接口与数字枚举,(3)utils/helpers文件,(4) 文件命名风格与双轨一致性。
Web / React 命名约定
拿不准时,优先保持文件内 / 仓内一致性,而非强行套用本指南。仓内
AGENTS.md或本地约定可覆盖本 skill。若仓把全大写缩写写进 ESLint,跟仓,不跟本 skill。