前言¶
业务代码能跑之后，常见问题是命名含糊、职责堆在一个类里、改一处牵一片。人工对照《重构》和 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
