code-simplifier

name	code-simplifier
description	在保持功能不变的前提下简化代码，提高可读性、一致性与可维护性。适用于清理、重构或检查近期修改；除非另有说明，只关注近期改动。

代码简化

保持功能不变，简化代码并提高可读性。优先选择明确的实现，避免过度紧凑的写法。

核心规则

保留功能

• 不改变已有功能、输出、公开行为或外部契约，只调整实现方式。
• 保留必要的错误处理、边界行为、状态转换和有助于组织代码的抽象。
• 修改前先理解相关调用方、测试、配置和数据格式，避免只根据局部代码做判断。

遵循项目上下文

• 先阅读当前仓库和当前任务适用的 Agent 规则、编码规范和验证要求。
• 遵循目标语言、框架、运行时和依赖的现有约定，不把某一种语言或平台的规则套用到其他代码上。
• 保持公共 API、命名、兼容性、序列化格式、错误语义和用户可见文本的一致性。

提高清晰度

• 减少不必要的复杂度、嵌套、重复逻辑和间接层。
• 使用清晰、明确的变量名、函数名和控制流。
• 将职责相关的逻辑放在一起，但不要把无关职责合并到同一个函数或组件中。
• 多条件逻辑优先使用清晰的分支结构，避免嵌套三元运算符和难以调试的密集单行代码。
• 删除只描述显而易见代码的注释，保留解释意图、约束和非显然原因的注释。

保持平衡

• 不为了减少行数牺牲可读性、可测试性、可调试性或未来扩展能力。
• 不删除有助于表达领域概念、隔离副作用或维持文件职责的抽象。
• 选择能让后续维护者快速理解的改动，而不是炫技式或过度通用的方案。

范围与授权

• 除非用户明确要求更大范围，否则只检查近期修改或当前会话接触过的代码。
• 技能被调用时应主动分析简化机会；只有当前任务已授权写入时才能实际修改文件。
• planning、检查或只读 review 请求只输出建议，不修改工作树。
• 不因代码简化任务自动扩大文件范围、运行高成本验证或执行外部操作。

工作流程

1. 识别近期修改区域及其相关调用链、测试和配置。
2. 分析真实的复杂度、重复逻辑和可维护性问题。
3. 选择保持行为不变的最小清晰改动。
4. 应用当前项目规范，以及适用的语言或框架专项规则。
5. 验证功能契约、边界行为、格式和项目要求的检查。
6. 记录会影响后续理解的重要变化及未验证事项。

语言和平台专项规则

处理特定语言、框架或 IDE 项目时，只加载对应的专项 reference。处理其他类型的代码时，不要读取或套用无关专项规则。

• Electron、TypeScript、React、IPC、preload 或 renderer：阅读 Electron/TypeScript 专项规则。
• Swift、SwiftUI 或 Xcode：阅读 Swift/Xcode 专项规则。