code-simplification

代码简化

Inspired by the Claude Code Simplifier plugin. Adapted here as a model-agnostic, process-driven skill for any AI coding agent.

概览

通过降低复杂度来简化代码，同时保持行为完全不变。目标不是让代码行数更少，而是让它更容易读、容易理解、容易修改、也更容易调试。每一次简化都应该通过一个简单测试：“一个新加入团队的人，会不会比看原始版本更快看懂它？”

何时使用

• 功能已经能跑、测试也通过了，但实现比它应该有的样子更重
• Code review 中指出了可读性或复杂度问题
• 你碰到深层嵌套逻辑、超长函数或命名不清的代码
• 你在整理那些赶工写出来的代码
• 你要把散落在多个文件中的相关逻辑收拢起来
• 合并一些引入重复或不一致的改动之后

不适用的场景：

• 代码已经足够干净清晰，不要为了“简化而简化”
• 你还没真正理解代码在干什么，先看懂再简化
• 这段代码是性能热点，而“更简单”的写法会带来可测量的性能损失
• 你马上就要彻底重写这个模块，对废弃代码做简化是在浪费精力

五个原则

1. 精确保留行为

不要改变代码做的事情，只改变它的表达方式。所有输入、输出、副作用、错误行为和边界情况都必须保持一致。如果你不确定某次“简化”是否保留行为，就不要做。

ASK BEFORE EVERY CHANGE:
→ Does this produce the same output for every input?
→ Does this maintain the same error behavior?
→ Does this preserve the same side effects and ordering?
→ Do all existing tests still pass without modification?

2. 遵守项目约定

简化代码，意味着让它更贴近当前代码库，而不是把你自己的偏好强行带进来。开始简化前：

1. Read CLAUDE.md / project conventions
2. Study how neighboring code handles similar patterns
3. Match the project's style for:
   - Import ordering and module system
   - Function declaration style
   - Naming conventions
   - Error handling patterns
   - Type annotation depth

如果所谓“简化”打破了代码库一致性，那它不是简化，而是无意义扰动。

3. 清晰优先于聪明

当紧凑写法需要人停下来想一下时，显式代码通常更好。

// UNCLEAR: Dense ternary chain
const label = isNew ? 'New' : isUpdated ? 'Updated' : isArchived ? 'Archived' : 'Active';

// CLEAR: Readable mapping
function getStatusLabel(item: Item): string {
  if (item.isNew) return 'New';
  if (item.isUpdated) return 'Updated';
  if (item.isArchived) return 'Archived';
  return 'Active';
}

// UNCLEAR: Chained reduces with inline logic
const result = items.reduce((acc, item) => ({
  ...acc,
  [item.id]: { ...acc[item.id], count: (acc[item.id]?.count ?? 0) + 1 }
}), {});

// CLEAR: Named intermediate step
const countById = new Map<string, number>();
for (const item of items) {
  countById.set(item.id, (countById.get(item.id) ?? 0) + 1);
}