跳到主要内容

Simplify Code

对最近的代码变更进行 3-agent 并行清理。

Skill 元数据​

SourceBundled(默认安装)
Pathskills/software-development/simplify-code
Version1.0.0
AuthorKOPI AI AGENT(灵感来自 Claude Code /simplify)
LicenseMIT
Platformslinux, macos, windows
Tagscode-review, cleanup, refactor, delegation, subagent, parallel, simplify
Related skillsrequesting-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 模式会一起返回结果)。

  1. 合并各项发现为一个列表,在 reviewer 之间有重叠的地方去重。
  2. 丢弃误报 —— 你掌握最多的上下文;你不必与 reviewer 争辩,只需默默丢弃站不住脚或错误的建议。
  3. 解决冲突。 reviewer 之间可能意见不一致(Reviewer 1:"使用现有的工具 X";Reviewer 3:"X 很慢,内联它")。默认的裁决顺序是:正确性 > 用户明确的关注点 > 可读性/复用 > 微观性能。 除非该路径确实是热路径,否则不要应用损害清晰度的性能"修复"。当两个建议互斥且都站得住脚时,选择改动代码更少的那个,并记录备选方案。
  4. 按风险层级顺序应用:
    • 先应用 SAFE(自动应用):未使用的 import、被注释掉的代码、纯透传的 wrapper、冗余的类型断言。之后运行测试。
    • 接着应用 CAREFUL(带验证地应用,一次一个文件):重命名局部变量、展平三元表达式、提取 helper、合并重复代码。每个文件之后运行测试。任何导致失败的改动都要回滚。
    • 最后处理 RISKY(标记待审查——不要自动应用):N+1 重构、公共 API 变更、并发修复、错误处理变更。对每一项附上风险描述和测试覆盖情况。 如果用户选择 dry run,则展示全部三个层级,但不应用任何改动。
  5. 验证你没有破坏任何东西:针对受影响的文件运行项目的针对性测试(不是完整测试套件),并重新运行仓库使用的任何 linter/类型检查。如果某个修复导致测试失败,回滚那一个修复并报告。
  6. 总结你所做的更改:按 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 阶段的安全/质量门禁。