Simplify Code
对最近的代码变更进行 3-agent 并行清理。
Skill 元数据
| Source | Bundled(默认安装) |
| Path | skills/software-development/simplify-code |
| Version | 1.0.0 |
| Author | KOPI AI AGENT(灵感来自 Claude Code /simplify) |
| License | MIT |
| Platforms | linux, macos, windows |
| Tags | code-review, cleanup, refactor, delegation, subagent, parallel, simplify |
| Related skills | requesting-code-review, test-driven-development, plan |
参考:完整的 SKILL.md
以下是当此 skill 被触发时 Kopi Agent 加载的完整 skill 定义。这是 skill 处于激活状态时 agent 所看到的指令内容。
Simplify Code — 并行审查与清理
使用三个各司其职的审查者并行审查你最近的代码变更,汇总它们的发现,并应用值得应用的修复。
核心原则: 三个专精的审查者胜过一个面面俱到的审查者。每一个都在代码库中深入搜索单一类别的问题——复用、质量、效率——而不会把注意力分散到所有三类上。它们并发运行,因此你付出的是一次审查的延迟,而不是三次。
何时使用
当用户说出以下任意一种说法时触发此 skill:
- "simplify" / "simplify my changes" / "simplify these changes"
- "review my code" / "review my recent changes" / "clean up my changes"
- "/simplify"(如果他们是从 Claude Code 延续过来的习惯)
用户可能添加的可选修饰语——请遵循它们:
- 聚焦(Focus): "simplify focus on efficiency" → 仅运行效率审查者(或在汇总时向其倾斜权重)。可识别的 focus:
reuse、quality、efficiency。 - 试运行(Dry run): "simplify but don't change anything" / "just report" → 运行三个审查者,展示发现,不应用任何更改。应用前先询问。
- 范围(Scope): "simplify the last commit" / "simplify staged" / "simplify src/foo.py" → 相应地缩小 diff 来源(见阶段 1)。
不要在每次编辑后自动运行它。它会消耗相当于三个 subagent 的 token——仅在用户明确要求时才调用它。
流程
阶段 1 —— 识别变更
捕获待审查的 diff。根据用户的要求选择来源,按以下默认顺序:
# 1. Default: uncommitted working-tree changes (tracked files)
git diff
# 2. If that's empty, include staged changes
git diff HEAD
# 3. Scoped variants the user may request:
git diff --staged # "staged changes"
git diff HEAD~1 # "the last commit"
git diff main...HEAD # "this branch" / "my PR"
git diff -- src/foo.py # specific file(s)
如果 git diff 和 git diff HEAD 都为空,且没有 git 仓库或没有变更,则回退到用户明确指定的文件,或本次会话中最近创建/编辑的文件。如果你确实找不到任何已更改的代码,请直接说明并停止——那就没有什么可简化的。
捕获完整的 diff 文本。注意其大小:如果非常大(比如超过 2000 行变更),请警告用户,三个 subagent 各自携带完整 diff 会消耗大量 token,并提议在继续之前缩小范围(按目录、按提交)。
阶段 2 —— 并行启动三个 reviewer
使用 delegate_task 的 batch 模式 —— 将全部三个任务传入同一个 tasks 数组,让它们并发运行。对于这种模式,三个是合适的扇出数量;在任何默认安装上,它都完全在 delegation.max_concurrent_children 预算之内。
为每个 reviewer 提供完整的 diff(不要给片段——跨文件问题会藏在片段的缝隙里),以及仓库的绝对路径,以便它们能搜索更广泛的代码库。每个 reviewer 获得 terminal、file 和 search 工具集(这样它们就能 git、read_file,以及 search_files/grep)。
告知每个 reviewer:
- 在现有代码库中搜索证据(不要只从 diff 推理)。
- 应用切斯特顿栅栏原则(Chesterton's Fence): 在标记任何内容为可删除之前,先对那一行运行
git blame以理解它为何存在。如果你无法确定其原始用途,将其标记为confidence: low—— 不要猜测。 - 以结构化输出报告发现,包含置信度和风险:
file:line → problem → suggested fix | confidence: high/medium/low | risk: SAFE/CAREFUL/RISKY- SAFE = 已证明不影响行为(未使用的 import、被注释掉的代码、纯透传的 wrapper)。自动应用这些。
- CAREFUL = 改进但不改变语义(重命名局部变量、展平嵌套的三元表达式、提取 helper)。应用时需配合测试验证。
- RISKY = 可能改变行为或破坏公共契约(N+1 重构、公共 API 重命名、内存生命周期变更)。标记为需人工审查——不要自动应用。
- 跳过细枝末节和纯风格的改动。只标记能实质性改进代码的内容。
传入以下三个目标(去掉与用户关注点无关的):
Reviewer 1 —— 代码复用
审查此 diff 中是否有代码重复实现了代码库中已有的功能。搜索工具模块、共享 helper 和相邻文件(使用 search_files / grep),寻找新代码可以调用而非重新实现的现有函数、常量或模式。标记:与现有函数重复的新函数;现成工具已经能做到的手写逻辑(手动字符串/路径处理、自定义环境变量检查、临时的类型守卫、重新实现的解析)。对每一项,指明应使用的现有实现及其所在位置。
Reviewer 2 —— 代码质量
审查此 diff 中的质量问题。关注:冗余状态(与现有状态重复或可由现有状态派生的值;本不需要存在的缓存);参数膨胀(在本应重构函数的情况下硬塞进来的新参数);带变体的复制粘贴(本应共享抽象的近似重复代码块);泄漏的抽象(暴露内部实现、破坏现有的封装边界);字符串类型化代码(在已有常量/枚举/注册表的地方使用裸字符串——在标记之前先检查规范注册表);AI 生成的劣质模式(重复陈述明显代码的多余注释,例如
// increment counter上方的count++;对已验证输入进行不必要的防御性 null 检查;绕过类型系统的as any强制转换;与文件其余部分不一致的模式)。对每一项,给出具体的重构方案。
Reviewer 3 —— 效率
审查此 diff 中的效率问题。关注:不必要的工作(冗余计算、重复读取文件、重复的 API 调用、N+1 访问模式);错失的并发机会(本可独立的操作被串行执行);热路径膨胀(在启动路径或每请求路径上执行繁重/阻塞的工作);TOCTOU 反模式(在执行操作前先做存在性预检查,而不是直接执行操作并处理错误);内存问题(无界增长、缺少清理、监听器/句柄泄漏);过宽的读取(加载整个文件而只需一个片段即可);静默失败(空的 catch 块、被忽略的错误返回值、
except: pass、未做任何处理的.catch(() => {})、错误传播缺口——这些会隐藏 bug,至少应在吞掉错误前记录日志)。对每一项,给出具体修复方案及其更快或更安全的原因。
阶段 3 —— 聚合并应用
等待三个 reviewer 全部返回(batch 模式会一起返回结果)。
- 合并各项发现为一个列表,在 reviewer 之间有重叠的地方去重。
- 丢弃误报 —— 你掌握最多的上下文;你不必与 reviewer 争辩,只需默默丢弃站不住脚或错误的建议。
- 解决冲突。 reviewer 之间可能意见不一致(Reviewer 1:"使用现有的工具 X";Reviewer 3:"X 很慢,内联它")。默认的裁决顺序是:正确性 > 用户明确的关注点 > 可读性/复用 > 微观性能。 除非该路径确实是热路径,否则不要应用损害清晰度的性能"修复"。当两个建议互斥且都站得住脚时,选择改动代码更少的那个,并记录备选方案。
- 按风险层级顺序应用:
- 先应用 SAFE(自动应用):未使用的 import、被注释掉的代码、纯透传的 wrapper、冗余的类型断言。之后运行测试。
- 接着应用 CAREFUL(带验证地应用,一次一个文件):重命名局部变量、展平三元表达式、提取 helper、合并重复代码。每个文件之后运行测试。任何导致失败的改动都要回滚。
- 最后处理 RISKY(标记待审查——不要自动应用):N+1 重构、公共 API 变更、并发修复、错误处理变更。对每一项附上风险描述和测试覆盖情况。 如果用户选择 dry run,则展示全部三个层级,但不应用任何改动。
- 验证你没有破坏任何东西:针对受影响的文件运行项目的针对性测试(不是完整测试套件),并重新运行仓库使用的任何 linter/类型检查。如果某个修复导致测试失败,回滚那一个修复并报告。
- 总结你所做的更改:按 reviewer 类别和风险层级分组的已应用修复简短列表,加上你有意跳过的发现及原因。
常见陷阱(Pitfalls)
- 不要扇出(fan out)超过约 3 个。 审阅者越多,成本越高,需要协调的冲突建议也越多,而不是覆盖率更好。三个类别已足够覆盖整个空间。
- 把完整 diff 交给每位审阅者。 将 diff 拆分给不同审阅者会破坏整个设计——跨文件重复代码和 N+1 问题只有在看到完整上下文时才会显现。
- 审阅者应当搜索,而不是猜测。 如果一条复用发现(reuse finding)没有指向现有工具函数(例如"这里可能有个 helper"),那就是噪音。要求提供
file:line证据;缺少证据的发现一律丢弃。 - 应用 ≠ 重写。 这是对用户最近修改的清理,而不是重构整个模块的许可。保持编辑范围仅限于 diff 涉及的内容,加上修复所需的最小周边改动。
- 遵循项目约定。 如果仓库中有 AGENTS.md / CLAUDE.md / HERMES.md 或 linter 配置,请把这些规则整合进审阅者 prompt 中,使建议符合团队风格,而不是与之对抗。
- 大 diff 会撑爆上下文。 如果 diff 非常大,请在委派之前缩小范围——三个子 agent 各自携带 5000 行 diff 成本很高,且可能被截断。
- 不要过度信任死代码工具。
knip、ts-prune和depcheck会标记出实际被动态使用的 export(基于字符串的 import、反射)。在删除之前务必 grep 该符号名——工具报告"干净"并不是证明。 - 未检查公开契约就重命名。 Export 名称、API 路由路径、DB 列名和 config key 都是契约——即使名称很糟糕,重命名也会破坏使用方。将公开契约的变更标记为 RISKY;绝不要自动重命名它们。
- 删除"看似不必要"的错误处理。 空的 catch 块或被忽略的错误可能是有意为之——在该上下文中错误是预期的且无害。标记它,但不要删除;让人工来决定。
相关内容(Related)
如果你的安装中包含 subagent-driven-development skill(可选),它涵盖的是互补的场景:在实现过程中按任务进行并行审阅。本 skill 是独立的事后清理步骤。使用 requesting-code-review 作为 pre-commit 阶段的安全/质量门禁。