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)时,跟仓。示例代码的格式不代表规定。

Installs
11
GitHub Stars
1
First Seen
Sep 22, 2026