前言¶
業務代碼能跑之後，常見問題是命名含糊、職責堆在一個類裏、改一處牽一片。人工對照《重構》和 SOLID 逐段改，耗時長，也容易漏掉邊界情況。把「整潔代碼、SOLID、現代工程實踐」寫成固定指令的 Agent Skill，可以在你貼出代碼或指定文件時，讓模型按同一套標準做分析與改寫建議，而不是每次從零描述角色。
下面介紹 SkillHub 上的 code-refactoring-refactor-clean：它是什麼、能做什麼、如何安裝，以及使用時要注意什麼。
這是什麼¶
code-refactoring-refactor-clean 是 SkillHub 座標 @org-02qudk26/code-refactoring-refactor-clean 下的開發類 Skill，當前版本 1.0.0，來源標註爲 enterprise，分類爲 dev-programming，由 智雨科技 發佈。
官方簡介將其定位爲：你是一名代碼重構專家，專精於整潔代碼原則、SOLID 設計模式和現代軟件工程最佳實踐；分析並重構提供的代碼，以提升其質量、可維護性和性能。
頁面標籤標明 requires_api_key=false，即啓用該 Skill 本身不依賴額外 API Key 配置。
核心功能¶
根據 SkillHub 頁面與元數據，可覈實的能力邊界如下：
- 角色與原則固定：對話中 Agent 按「重構專家」人設工作，並顯式對齊整潔代碼、SOLID 與常見最佳實踐，而不是泛泛的「優化代碼」。
- 分析與重構：針對你提供的代碼片段或指定路徑下的實現，進行質量、可維護性與性能維度的審視，並給出重構後的代碼或分步改寫方案（具體輸出形式取決於你當時的提示與 Agent 能力）。
- 無額外密鑰門檻：
requires_api_key=false，安裝後即可在支持 Skills 的客戶端裏調用，無需爲該 Skill 單獨配置密鑰。
SkillHub 側統計（以抓取資料爲準）：評分 100000，下載 1134 次，安裝計數 0（安裝數爲平臺統計字段，不代表無法本地安裝）。
安裝與啓用¶
SkillHub 提供兩種常見入口：用 CLI 安裝到當前 Agent 的 skills 目錄，或把安裝提示發給 AI 讓其按官方安裝文檔執行。
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 skillhub：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝文檔執行完整安裝（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、安裝本 Skill 到對應客戶端目錄¶
安裝技能時必須用 --dir 指向當前 Agent 識別的 skills 目錄；默認裝到 ./skills/ 可能不會被客戶端加載。
skillhub install org-02qudk26/code-refactoring-refactor-clean --dir <skills 目錄>
常用路徑（來自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
SkillHub 技能頁給出的 AI 安裝提示爲：請根據 https://skillhub.cn/install/skillhub.md ，安裝 @org-02qudk26/code-refactoring-refactor-clean。
安裝後若客戶端未自動刷新技能列表，按你所用產品的說明重啓或重新加載配置。
典型用法¶
公開頁面未附帶獨立的長示例倉庫；典型用法是：在已啓用該 Skill 的會話裏，提供待重構代碼與約束，讓 Agent 按 Skill 人設輸出分析與重構結果。
可復現的操作順序示例：
- 確認
code-refactoring-refactor-clean已出現在當前 Agent 的 skills 目錄中。 - 在對話中說明語言、框架版本（若有），並粘貼代碼塊，或給出倉庫內文件路徑請 Agent 讀取（需在你本地環境允許的前提下）。
- 寫明目標，例如：拆分上帝類、消除重複、改善命名、對齊某一 SOLID 原則，或兼顧可讀性與性能。
- 要求輸出重構後代碼、變更說明，以及建議的驗證方式（測試、類型檢查等），由你本地執行驗證。
示例提示（示意，可按項目改寫）：
使用 code-refactoring-refactor-clean 技能。
語言：TypeScript。請重構下面這段服務類：職責過多、方法過長。
約束：保持對外 API 不變；給出重構後代碼與逐步遷移說明。
（在此粘貼代碼）
適用場景與注意¶
適合誰
- 需要在 Code Review 或迭代前，快速得到「按整潔代碼 / SOLID 框架」組織的重構意見與改寫稿的開發者。
- 希望團隊內重構討論有統一話術與原則，而不是每次手寫一長段 system 提示的用戶。
限制與注意
- Skill 提供的是分析與重構建議；是否合入主幹、是否破壞行爲，仍需你本地的測試、審查與發佈流程把關。
- 大段跨文件重構時，應分批提交上下文，並明確「不改變行爲」等約束，避免模型在信息不全時臆造依賴。
- 安裝數等頁面統計來自 SkillHub，與你在本機是否安裝無必然對應；以本地
skills目錄與客戶端是否識別爲準。
結尾¶
code-refactoring-refactor-clean 把「重構專家 + 整潔代碼 + SOLID + 工程實踐」固化成可安裝的 Skill，適合在 Cursor、Claude Code、Codex 等支持 SkillHub 技能的環境中，對指定代碼做結構化重構討論。
- SkillHub 技能頁：https://www.skillhub.cn/skills/org-02qudk26/code-refactoring-refactor-clean
- API 座標頁：https://api.skillhub.cn/org-02qudk26/code-refactoring-refactor-clean
- 安裝說明：https://skillhub.cn/install/skillhub.md
