前言¶

代码里有一类债务不会立刻报错：功能已经通过测试，但实现开始臃肿——嵌套变深、函数变长、同样的逻辑复制了好几份、命名让人看不懂原意。它不阻塞发布，却会让每一次后续修改变慢，让 code review 难以进行。

手工清理这类代码效率低，也容易出错：既要挪位置又要保证行为不变，一步改错就得回滚。下面介绍一个专门做这件事的 Skill：code-simplification。

这是什么¶

code-simplification（代码简化重构）是一个在不改变代码行为的前提下降低复杂度、提升可读性与可维护性的代码简化技能。

它的基本资料如下：

名称:   代码简化重构
坐标:   @org-b6kzcl68/code-simplification
版本:   1.0.0
来源:   enterprise
分类:   dev-programming
发布者: 重庆途光网络传媒有限责任公司
标签:   requires_api_key=false（不需要 API Key）
评分:   100000，下载 1851

核心功能¶

这个 Skill 的判断标准分三层：原则、识别信号、改写方法。

先看它遵循的五大原则：

1、精确保留行为：重构的产出必须与原实现行为一致。
2、遵循项目约定：沿用项目已有的写法，不引入新风格。
3、清晰优先于炫技：选择更清楚的写法，而不是更巧妙的写法。
4、防止过度简化：不为简化而强行合并。
5、只改动当前范围：不顺手改无关代码。

再看识别信号。资料中明确列出了四类应当简化的信号：

• 嵌套逻辑
• 长函数
• 误导性命名
• 重复代码

最后是改写方法。它提供 TypeScript、Python、React 等语言的渐进式改写示例，方式是增量修改：每步只改一点，每步运行测试，重构与功能变更分开提交，超大范围的改动借助自动化工具完成。

安装与启用¶

本次撰写时官方页面无法访问，资料中没有给出可核实的安装命令或配置方式，这里不臆测。下面只列出官方地址，安装说明请以页面为准。

SkillHub 页面: https://www.skillhub.cn/skills/org-b6kzcl68/code-simplification
API 地址:     https://api.skillhub.cn/zcwl/code-simplification

该 Skill 基于通用 SKILL.md 格式，标签 requires_api_key=false，说明调用不需要额外申请密钥。

典型用法¶

资料给出的触发条件如下，满足这些情况时使用该 Skill：

• 功能已通过测试，但实现显得臃肿
• 代码审查中发现了可读性或复杂度问题
• 需要重构时间压力下写出的代码
• 合并变更后引入了重复与不一致

对应的触发关键词是：代码简化、重构、可读性优化、降低复杂度、清理重复代码、代码审查、维护性改进。

实际使用时，先说明要遵循的五大原则和目标简化信号，再要求按渐进式方式改写：每完成一步就运行一次测试，重构与功能变更分开提交。经过上面的步骤，确认行为没有变化后，再进入下一个简化点。

适用场景与注意¶

适合谁：项目已有测试保障、需要清理已验证但臃肿代码的团队，尤其是 TypeScript、Python、React 项目，资料提供了这三类的渐进式改写示例。

需要注意的地方：

• 前提是精确保留行为。项目没有测试时，先补测试再做简化，否则无法验证每步是否改变行为。
• 重构与功能变更分开提交，避免两类改动混在一起难以回溯。
• 防止过度简化。这是它五大原则之一，简化以提升清晰为度，不以行数减少为目标。
• 只改动当前范围，不要借简化之名做无关重排。

结尾¶

code-simplification 提供的不是一套魔法，而是一套可执行的约束：五项原则、识别信号、语言示例和增量修改纪律。相比凭感觉手工清理，它更适合当作 agent 的检查清单和交互约定，保证简化过程中行为始终不变。

官方地址：https://www.skillhub.cn/skills/org-b6kzcl68/code-simplification