前言¶
团队里常见做法是手写 ESLint、Prettier、EditorConfig，或在文档里贴一份「编码规范」，再靠 Code Review 兜底。问题是：规范文档和 AI 生成的代码往往各说各话，换语言或框架又要重新对齐一遍。下面介绍 SkillHub 上的 coderules-skill（坐标 @user_3b34947d/coderules-skill，版本 1.0.0）：它把「识别栈 → 加载对应规范 → 生成 / 审查 / 修复」串成一条可在对话里触发的流程，且标注 requires_api_key=false，不依赖额外 API Key。
这是什么¶
coderules-skill 在 SkillHub 上的定位是「智能代码规范助手」。来源为 community，发布者为 user_3b34947d，分类 dev-programming。官方页面与 API 元数据一致描述其能力：自动识别项目技术栈，加载对应语言与框架规范，生成符合规范的代码，并对现有代码做规范审查。
支持的语言（据官方简介）：TypeScript、Python、Go、Rust、Java。
支持的框架（据官方简介）：React、Vue、Next.js、Nuxt、Django、Spring Boot。
核心功能¶
以下能力均来自 SkillHub 页面与已抓取元数据，不展开未公开的 SKILL.md 细节。
- 技术栈识别：根据项目上下文判断语言与框架，再选用匹配的规范集。
- 规范约束下的代码生成：在新功能、补全模块时，让输出对齐已加载的规范，而不是通用风格。
- 规范审查：对已有文件或片段检查是否符合当前栈的规范要求。
- 不规范代码修复：在审查结果基础上，按同一套规范提出或落实修改方向。
- 项目初始化时的规范配置：在新建或整理仓库时，协助落地代码规范相关配置（具体文件形态以 Skill 内说明为准）。
触发词（官方列出）：代码规范、code rules、生成代码、代码审查、规范检查、coderules。
安装与启用¶
SkillHub 推荐通过 SkillHub 安装说明 安装 CLI，并把技能装进当前 Agent 实际读取的 skills 目录；装到默认 ./skills/ 而 Agent 不读该路径时，技能不会被加载。
1、检查或安装 skillhub CLI¶
先确认本机是否已有 CLI：
command -v skillhub && skillhub --version
若未安装，可按官方文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装 coderules-skill¶
官方安装提示为：根据 https://skillhub.cn/install/skillhub.md，安装坐标 @user_3b34947d/coderules-skill。
在已安装 CLI 的前提下，将技能安装到对应客户端的 skills 目录。以 Cursor 为例（路径来自 SkillHub 安装文档）：
skillhub install @user_3b34947d/coderules-skill --dir ~/.cursor/skills/
其他客户端请改用各自目录，例如官方文档记载的：
- Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装完成后，按你所用 Agent 的说明重启或刷新技能列表，使新 Skill 生效。
也可将下面这句发给支持 Skill 安装的 AI，由其按安装文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3b34947d/coderules-skill。
典型用法¶
官方未提供独立命令行子工具示例，用法以在 Agent 对话中结合触发词与项目上下文为主。可按场景复现下列请求方式（表述可调整，关键词与意图需对齐官方说明）。
生成新代码并套用规范
在已打开目标仓库的会话中说明技术栈或让 Agent 自行识别，并带上触发词，例如：
用 coderules：在这个 Next.js 项目里新增一个用户列表页组件，生成代码并符合项目代码规范。
审查现有代码
代码审查：检查 src/components/UserList.tsx 是否符合当前 React/TypeScript 规范。
修复不规范实现
规范检查：下面这段 Go 处理函数有哪些不符合规范的地方，并给出修复后的写法。
初始化或整理规范配置
项目初始化：为这个 Django 仓库配置代码规范相关设置，并说明需要改哪些文件。
经过上面的步骤，Agent 应加载 coderules-skill 中的规范逻辑；若栈不在官方列出的语言/框架范围内，行为以 Skill 实际支持为准，不宜假定全覆盖。
适用场景与注意¶
适合谁
- 多语言、多框架仓库，希望 AI 写码与 Review 时统一规范口径的开发者。
- 希望减少「生成一段能跑但风格混乱」的代码、再靠人工改风格的团队。
- 已在用 Cursor、Claude Code、Codex 等支持 SkillHub 技能安装的客户端的用户。
使用注意
- 规范粒度与具体规则以 Skill 包内定义为准；官方简介列出的是识别范围，不等于你司内部规范已自动内置，必要时仍要在对话中补充团队约定。
- 社区来源（community）技能，升级与维护节奏取决于发布者；安装前可在 SkillHub 查看版本 1.0.0 与页面说明。
- SkillHub 页面统计（以抓取时为准）：评分 100000，下载 908，安装 21；数据会随时间变化，以官网为准。
- 无需 API Key（requires_api_key=false），但安装与搜索仍依赖 skillhub CLI 与网络访问 SkillHub。
结尾¶
coderules-skill 把「按栈加载规范 → 生成、审查、修复、初始化」收敛到一个可安装的 Agent Skill，适合在日常写码与审查对话里用触发词唤起。查阅详情与安装入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_3b34947d/coderules-skill
- API 元数据：https://api.skillhub.cn/user_3b34947d/coderules-skill
