前言¶
功能已经跑通、测试也绿，但读一段逻辑要来回跳好几层缩进，改一个小需求却不敢动——这类问题往往不是缺测试，而是实现里堆了嵌套、重复和误导性命名。手工「大改一把」容易顺带改坏行为；只加注释又治不了结构。下面介绍 SkillHub 上的 代码简化重构（@org-b6kzcl68/code-simplification）：面向 AI 编码助手的 SKILL.md 技能，把「可读性重构」收成可重复触发的流程，并明确约束：简化的是形状，不是需求。
这是什么¶
代码简化重构 是 SkillHub 分类 dev-programming 下的企业来源技能（发布者：重庆途光网络传媒有限责任公司），当前版本 1.0.0，标签 requires_api_key=false，无需额外 API Key。
一句话定位：在不改变代码行为的前提下降低复杂度、提升可读性与可维护性。它解决的是「实现臃肿、审查里反复提可读性、赶工留下的技术债、合并后重复与不一致」等场景，而不是替代功能开发或修 bug。
- SkillHub 页面：https://www.skillhub.cn/skills/org-b6kzcl68/code-simplification
- 资料页：https://api.skillhub.cn/user_e40a4360/code-simplification
（页面展示评分 100000，下载 555 次；数据以 SkillHub 当时公示为准。）
核心功能¶
官方简介中可核对的能力如下。
五大原则¶
技能要求重构过程遵守五条边界，避免「为了短而短」：
- 精确保留行为——对外可观测结果与副作用不变。
- 遵循项目约定——命名、目录、框架用法与仓库现有风格一致。
- 清晰优先于炫技——用直白结构替代晦涩技巧。
- 防止过度简化——不为了行数牺牲必要的显式逻辑或错误处理。
- 只改动当前范围——不借机扩大 diff、不顺手改无关模块。
识别信号¶
技能会引导关注典型「该简化」迹象，例如：
- 嵌套逻辑过深
- 函数过长、职责混杂
- 误导性命名
- 重复代码
并配套 TypeScript、Python、React 等语言的渐进式改写示例（在技能正文 SKILL.md 中，按官方包内容为准）。
工作方式¶
强调可落地的工程节奏：
- 增量修改，每步可 review、可回滚。
- 每步运行测试，用测试锁住行为。
- 重构与功能变更分开提交，便于审计与 bisect。
- 超大范围改动时借助自动化工具，而不是一次手搓巨型 patch。
安装与启用¶
SkillHub 提供的安装方式，是让 AI 按通用安装说明拉取指定坐标，而不是手写 git clone。
在 Cursor、Claude Code 等支持 SkillHub 协议的助手里，可将下面提示交给 AI 执行（原文来自 SkillHub 技能页）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@org-b6kzcl68/code-simplification`。
具体目录结构、各客户端差异以 https://skillhub.cn/install/skillhub.md 为准；本文未单独核实的 CLI 参数不一并列出。
典型用法¶
技能基于通用 SKILL.md 格式：安装后由模型在对话中按技能说明执行。官方给出的 Use when 与触发词可用于判断是否该启用本技能。
何时启用（Use when）¶
- 功能已通过测试，但实现显得臃肿。
- 代码审查中发现可读性或复杂度问题。
- 需要在时间压力下整理赶工写出的代码。
- 合并变更后引入了重复与不一致。
触发词（Triggers）¶
在对话中可直接使用或贴近以下表述，便于助手匹配技能：
- 代码简化、重构、可读性优化
- 降低复杂度、清理重复代码
- 代码审查、维护性改进
建议协作流程¶
结合技能强调的节奏，一次简化任务可以按下面步骤推进：
- 说明范围（文件/模块）与约束（必须保持的行为、现有测试命令）。
- 让助手先列出识别到的复杂度信号，再给出分步重构计划。
- 每完成一小步即运行项目测试；失败则回退该步，不叠加下一步。
- 提交时区分「纯重构」与「功能变更」两类 commit。
技能正文中的多语言示例用于对照改写思路；具体片段以安装后的 SKILL.md 为准，此处不臆造代码。
适用场景与注意¶
适合谁
- 主流程已稳定、希望降低维护成本的业务代码维护者。
- 在 review 中需要结构化讨论「如何改才安全」的 Tech Lead 或 reviewer。
- 使用 AI 辅助改代码、又担心助手「顺手改需求」的团队。
限制与注意
- 目标是可读性与复杂度，不替代缺陷修复或新功能设计；行为变更应走正常需求流程。
- 无测试或测试很弱的模块，「精确保留行为」难以验证，应先补关键路径测试再大规模简化。
- 遵循「只改动当前范围」：避免在简化 PR 里混入格式化全库、升级依赖等无关变更。
- 企业来源技能，使用与分发须符合 SkillHub 及所在组织政策。
结尾¶
代码简化重构 把「不改行为的重构」写成可安装的技能：用原则划边界、用信号找问题、用增量与测试约束改动。若你手头是绿测试但难读的实现，或审查里反复出现的复杂度项，可从 SkillHub 安装 @org-b6kzcl68/code-simplification，并按官方安装说明启用。
- SkillHub：https://www.skillhub.cn/skills/org-b6kzcl68/code-simplification
- 资料：https://api.skillhub.cn/user_e40a4360/code-simplification
