web-code-style
Installation
SKILL.md
范围: Web 全栈的 TypeScript:React(TSX)前端与 Node 服务端。命名与代码风格的通用规则适用任何层;React 专属规则(组件/Hook 文件名、props、JSX)只用于前端。类型建模与渲染性能归仓内对应技能(见「依赖」),本 skill 只规定它们怎么命名、怎么写得易读。
按任务读对应 references
| 任务 | 读哪些 references |
|---|---|
| 命名(任何层) | references/naming-core.md、references/naming-files.md |
| React 前端的组件/Hook/props/文件名 | references/naming-react.md |
| 写/审控制流、函数、注释(任何层) | references/style-core.md |
| 写/审组件、JSX、文件内组织 | references/style-ui.md |
| 需要长示例 | references/examples.md |
只读与当前任务相关的文件,不要一次全读。monorepo 里按目标文件所在包选路由:前端包用 React 双轨文件命名,服务端包一律走 references/naming-files.md 的默认轨。Vue SFC 见仓内 vue-* skills。
优先级与工具边界
仓内 AGENTS.md、本地约定、相邻文件的现状,优先于本 skill。拿不准时保持文件内、仓内一致,不要为了套规则而重命名整个模块。
仓内 formatter / linter(Biome、@antfu/eslint-config、oxlint 等,以仓内实际配置为准)已强制的规则,以工具为准,审查时不重复提,本 skill 也不写死规则名。行宽、引号、分号、缩进、else after return 这类机械规则归工具。某类问题反复出现而工具没管,先在仓内工具里补规则,不要往本 skill 里加文字。本 skill 默认保留缩写规范大小写(HTTPClient、parseURL);仓的工具或现有约定强制词形拼写(HttpClient)时,跟仓。示例代码的格式不代表规定。