mcpField
S
simplify

simplify

github.com/wkentaro开发0112 次安装1 周前更新
代码仓库

关于 simplify

用于审查变更代码并实施已验证、保持行为不变的清理。检查复用、简化、效率和抽象边界,也可使用仅报告模式而不修改目标。

主要功能

  1. 01审查完整变更及相关上下文
  2. 02检查复用、简化、效率和边界
  3. 03根据预期行为验证发现
  4. 04以最小改动清理并运行检查
  5. 05仅报告模式不修改目标

适用场景

  1. 01简化变更引入的代码
  2. 02只审查差异而不修改代码
  3. 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 和类型检查,并直接检查任何已变更的输出表面。只有在检查通过且能明确证明预期行为未改变时,才保留编辑。

最后简要列出修复、因何跳过的发现以及检查结果,或确认代码原本已经干净。将历史记录和发布留给调用方:不要提交、变基、评论或推送。

评论

支持 Markdown