code-simplification
简化代码以提升清晰度。当为提升清晰度而重构代码且不改变行为时使用。当代码可运行但可读性、可维护性或可扩展性欠佳时使用。当审查积累了不必要复杂性的代码时使用。
技能说明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 遵循以下流程执行:
- 先理解,再动手(Chesterton's Fence):弄清代码的职责、调用关系、边界情况和历史背景,不理解就不要简化
- 识别简化机会:查找深层嵌套、超长函数、嵌套三元表达式、布尔参数标志等具体模式
- 应用简化:在保持行为完全一致的前提下,优先遵循项目现有约定,选择易于理解的显式写法而非晦涩的紧凑写法
注意事项
- 严格保持行为不变:所有输入输出、副作用、错误行为、边界条件必须完全一致;不确定时可先跑测试验证
- 不要为了简化而简化:代码已足够清晰时不要强行改动;不理解的代码先读懂再处理
- 克制过度简化:避免激进内联、合并无关逻辑、删除有存在理由的抽象;不要追求行数最少,而应追求更容易理解
- 控制修改范围:默认只简化最近变动的代码,避免夹带无关重构,防止 diff 噪音和回归风险