关于 simplify
用于审查变更代码并实施已验证、保持行为不变的清理。检查复用、简化、效率和抽象边界,也可使用仅报告模式而不修改目标。
主要功能
- 01审查完整变更及相关上下文
- 02检查复用、简化、效率和边界
- 03根据预期行为验证发现
- 04以最小改动清理并运行检查
- 05仅报告模式不修改目标
适用场景
- 01简化变更引入的代码
- 02只审查差异而不修改代码
- 03通过相关测试验证清理改动
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ wkentaro/ agent-skills --skill simplify安装后在 Claude Code 中输入/simplify确认已加载。
附带文件agents/openai.yamlevals/evals.json
详细介绍
简化
在不查找正确性缺陷的前提下,提升变更代码的质量:
/simplify [target]
如果提供了目标,则使用该目标。否则,检查当前工作树和分支相对于其基准的差异。除非现有仓库辅助工具是更简单的替代方案,否则将工作限制在变更代码的范围内。
常规模式会应用已验证的清理。如果父工作流或调用方设定了仅报告边界,则使用仅报告模式,并保持目标不变。
审查变更
阅读完整差异、其调用方、相关仓库说明,以及用于确立预期行为的测试或文档。然后,为每个审查角度各分配一名全新的、仅报告的 Reviewer。在资源允许时并发运行,必要时才串行;资源限制不会减少审查角度。
| 角度 | 审查标准 |
|---|---|
| 复用 | 如果现有辅助工具、实用程序、类型或已安装依赖项更清晰且能保持行为,则用其替换新增的重复实现。 |
| 简化 | 移除变更引入或暴露的冗余或可推导状态、不必要的分支或嵌套、复制粘贴式差异、间接层和死代码。 |
| 效率 | 移除已证实的重复工作、不必要的 I/O、分配或范围过大的操作;省略推测性的微优化。 |
| 抽象层级 | 让策略、编排和底层机制处于恰当的现有边界;移除泄漏或仅做透传的抽象,而不是增加新层。 |
每位 Reviewer 只返回包含位置、单行结论、具体代价、证据和最小行为保持型修复方案的发现,或返回 No findings.。Reviewer 不得编辑、提交、发布或委派任务。
综合审查
对指向同一机制的发现去重,并根据源代码和预期行为逐一核实。只有在代价具体、修复方案仍在范围内且预期行为保持不变时,才保留发现。驳回误报、仅涉及风格的改动、推测性的灵活性,以及需要大范围重构相邻代码的修复方案。
将疑似正确性缺陷视为此技能范围之外的问题,并建议使用 code-review;不要将其伪装成清理事项。
仅报告模式
返回已核实的发现及驳回的主张,并说明理由。若没有问题,则返回 No findings.。说明目标未被修改。此模式是一项组合审查技能:来源包括顶层 Simplify Reviewer 和全部四位角度 Reviewer。
应用模式
将每项已核实的清理作为最小且连贯的编辑应用。运行范围最窄的相关测试、lint 和类型检查,并直接检查任何已变更的输出表面。只有在检查通过且能明确证明预期行为未改变时,才保留编辑。
最后简要列出修复、因何跳过的发现以及检查结果,或确认代码原本已经干净。将历史记录和发布留给调用方:不要提交、变基、评论或推送。