code-simplification

code-simplification 技能概览

code-simplification 是做什么的

code-simplification 技能帮助 AI agent 重构已经能正常工作的代码，让它更易读、更容易推理，也更方便维护，同时不改变行为。它最适合处理“逻辑是对的，但写得过于复杂”的代码：层层嵌套的条件判断、过长的函数、重复的逻辑、让人困惑的命名，或者本该明确却分散在各处的规则。

谁应该使用它

如果你是在做以清晰度为目标的重构、在审查一段“本不该这么难懂”的代码，或者在功能上线后清理实现债务，就适合使用 code-simplification skill。当你想要一个比大范围重写更稳妥的方案时，它尤其有用。

它不是什么

这个技能不适合用来重新设计行为、追求性能提升，或者简化你还没有真正理解的代码。如果仓库本身已经很干净，或者核心问题是需求缺失而不是复杂度，那么通常用一个通用 prompt，比用 code-simplification guide 更合适。

如何使用 code-simplification 技能

安装并打开正确的文件

对于 code-simplification install，先用 npx skills add addyosmani/agent-skills --skill code-simplification 添加该技能。然后先阅读 SKILL.md，因为里面写着流程规则。如果还需要更多上下文，再查看仓库里的 README.md、AGENTS.md、metadata.json，以及任何 rules/、resources/、references/ 或 scripts/ 目录。

给技能正确的起始输入

最好的 code-simplification usage 是从一个可运行的目标和清晰边界开始。告诉 agent 要简化哪个文件或模块、哪些内容绝不能变，以及现有代码为什么难维护。好的输入像这样：“简化 src/payments/checkout.ts；保留校验、错误信息和 API 形状；减少嵌套分支和重复解析。” 不好的输入像这样：“把它写得更清爽一点。”

遵循实用的工作流

一个有效的 code-simplification for Refactoring 流程是：先理解当前行为，再找出能保持行为不变的最小简化，最后用现有测试或等价检查验证结果。仓库中的指导强调要严格保持行为，因此这类简化应该更像一次受控重构，而不是重写。

注意输出质量问题

最常见的失败模式是过度简化：模型可能会抹平重要的边界情况、过于激进地重命名，或者把原本有区别的分支合并掉。如果发生这种情况，就在 prompt 里重申约束，并要求只针对结构、命名或重复逻辑做更窄的一轮处理。

code-simplification 技能 FAQ

code-simplification 只适合有经验的重构者吗？

不是。只要你能指出具体文件，并说明想修复的症状，它对新手同样有用。这个技能提供的是流程，但好的 code-simplification usage 仍然依赖清晰的范围。

它和普通 prompt 有什么不同？

普通 prompt 往往只会说“把代码写得更干净”，但方法很模糊。code-simplification skill 更偏向决策：它强调保持行为不变，要求做出可读的简化，并且不鼓励那些看起来更漂亮、实际上会改变意图的改动。

什么时候不该用它？

当代码还在探索阶段、需求还在变化，或者任务本质上是重设计时，不要使用 code-simplification。如果你想做性能优化，而且不准备在清晰度上做取舍，它也不是合适的选择。

它适用于大多数代码库吗？

是的，但它在有测试、或能可靠验证行为的仓库里效果最好。如果你无法验证等价性，就把简化范围收得更小、更局部一些。

如何改进 code-simplification 技能

先说明真正的约束

最高价值的改进，就是告诉 agent 哪些内容不能变：输入、输出、错误文本、公开 API、时序假设，或者文件边界。约束越明确，code-simplification skill 在“优化”代码时误删重要内容的概率就越低。

明确你想要哪种简化

不同的简化解决的是不同问题。说明你是想减少分支、让命名更清楚、减少重复、缩短函数，还是更好地分离关注点。这样能帮助模型避免把多种重构混在一次处理里。

提供具体的痛点示例

如果某个循环很难读，就把让你困惑的分支、函数或调用链指出来。和空泛的赞美或批评相比，具体的提示更容易得到好的 code-simplification guide 结果，因为模型能直接瞄准你真正关心的复杂点。

以行为为准迭代，而不是以风格为准

第一轮完成后，检查简化后的版本是否更容易追踪，同时是否仍覆盖相同的情况。如果没有，就要求更窄的修改：保留相同逻辑、保持公开签名不变，或者在简化内部结构的同时保留相同的错误路径。