前言¶
團隊裏常見做法是手寫 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
