code-simplification

简化代码以提升清晰度。当为提升清晰度而重构代码且不改变行为时使用。当代码可运行但可读性、可维护性或可扩展性欠佳时使用。当审查积累了不必要复杂性的代码时使用。

提供方:addyosmani/agent-skills调用次数:5.0k收藏:60更新:2026/08/28

技能说明addyosmani/agent-skills

简化代码以提升清晰度。当为提升清晰度而重构代码且不改变行为时使用。当代码可运行但可读性、可维护性或可扩展性欠佳时使用。当审查积累了不必要复杂性的代码时使用。

code-simplification 是一个面向 AI 编码 Agent 的代码简化技能。它的核心目标是在不改变代码行为的前提下,降低代码的阅读、维护和调试成本,让新成员能更快理解现有实现。适用于功能已正常工作、但实现显得复杂冗余的场景。

使用场景

  • 功能开发完成且测试通过,但实现比预期更复杂
  • 代码审查时发现可读性或复杂度问题
  • 遇到深层嵌套逻辑、超长函数或命名不清晰的代码
  • 合并代码后发现重复或不一致的逻辑

使用方法

该技能是一个模型无关、流程驱动的 Skill。安装方式取决于你使用的 Agent 框架:

通过 Claude Code 插件安装(原始来源)

# 使用官方 Cluade Plugins 中的 code-simplifier(原始实现)
git clone https://github.com/anthropics/claude-plugins-official.git
# 然后在 Claude Code 中启用 code-simplifier 插件

使用 Agent Skills 协议安装(如 OpenClaw、Clawdbot 等支持 Agent Skill 的 CLI)

# 通过 npx 快速添加该技能(如果使用相关支持 CLI 的生态)
npx skills add anthropics/skills code-simplification

启用后,让 Agent 遵循以下流程执行:

  1. 先理解,再动手(Chesterton's Fence):弄清代码的职责、调用关系、边界情况和历史背景,不理解就不要简化
  2. 识别简化机会:查找深层嵌套、超长函数、嵌套三元表达式、布尔参数标志等具体模式
  3. 应用简化:在保持行为完全一致的前提下,优先遵循项目现有约定,选择易于理解的显式写法而非晦涩的紧凑写法

注意事项

  • 严格保持行为不变:所有输入输出、副作用、错误行为、边界条件必须完全一致;不确定时可先跑测试验证
  • 不要为了简化而简化:代码已足够清晰时不要强行改动;不理解的代码先读懂再处理
  • 克制过度简化:避免激进内联、合并无关逻辑、删除有存在理由的抽象;不要追求行数最少,而应追求更容易理解
  • 控制修改范围:默认只简化最近变动的代码,避免夹带无关重构,防止 diff 噪音和回归风险