用途:在不改变代码行为的前提下,简化用户刚修改过的代码,提升可读性、一致性与可维护性。适用于用户要求“简化”“清理”“整理”或“在不改变行为下重构”的场景;也适合功能刚完成、准备正式评审前做一次可维护性清理。
主要能力与做法:减少不必要的嵌套;移除局部且明显的重复;在提升清晰度且安全时重命名变量或辅助函数;用直白的控制流替代密集单行写法;避免嵌套三元表达式,多分支逻辑改用 if/else 或 switch;删除只复述代码的注释,保留说明意图或约束的注释;保留有价值的抽象,不为缩短行数而压平结构。
使用方式:先确定范围,优先使用用户指定的文件或区段,否则用 git diff、git diff --name-only 或 git status 查看近期改动,默认只处理被触及的代码;再阅读本地规范,如 AGENTS.md、本地技能规则与仓库约定,本地约定优先于通用偏好;随后在不改语义的前提下简化;最后运行该改动范围最小且有意义的验证,优先定向测试,必要时再做更广的 lint/build 检查。若没有自动化验证,应明确说明并指出残余风险。
限制:不做行为变更、功能开发或改变需求的缺陷修复;不进行跨未触及模块的大规模架构重设计;不用于规格对齐、安全或性能评审,也不用于多评审者清理流程(该场景应使用 simplify)。不添加功能、选项或推测性泛化,不扩大 API 面或更改数据契约,不为风格统一重写未触及模块。未经验证不得声称“无行为变化”。常见错误包括把简化变成重新设计、过早抽象、跨无关文件大范围重命名、追求行数更少而非更易维护,以及因“看起来机械”而跳过验证。该技能改编自 Anthropic 的 code-simplifier 插件智能体,来源位置与改编说明见 references/upstream-agent.md。