mcpField
S
simplify

simplify

github.com/bhagyamudgal开发2114 次安装3 天前更新
代码仓库

关于 simplify

simplify 是用于精简当前任务改动的代码清理技能,面向希望在保持行为不变的前提下降低维护复杂度的开发者。它限定清理范围,并要求验证等价性及扫描新增注释。

主要功能

  1. 01仅处理当前任务的差异
  2. 02查找新增重复和不必要复杂性
  3. 03优先删除而非增加抽象
  4. 04扫描并清除不符合规则的新增注释
  5. 05重跑受清理影响的检查

适用场景

  1. 01移除任务改动引入的重复代码
  2. 02精简不必要的分支或配置
  3. 03在不改变公开行为的前提下整理改动

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/bhagyamudgal/skills --skill simplify

安装后在 Claude Code 中输入/simplify确认已加载。

附带文件agents/openai.yaml

详细介绍

简化

我会进行尽可能小且保留行为的清理,让完成后的改动更易于维护。代码更少,行为不变。这就是全部工作。

1. 确定改动范围

我会记录原始请求、审查基线、变更路径,以及当前差异或内容哈希。我会阅读完整差异,以及每项拟议清理涉及的周边代码。

清理范围仅限当前任务的差异。与任务无关的既有代码保持不变,我会将此作为把关条件。我不会偏离范围。

2. 找出可移除的复杂性

我只检查以下内容。

  • 此次改动引入的重复内容。
  • 请求不需要的抽象、分支、配置或错误处理。
  • 此次改动引入的无用导入、变量、函数、文件或间接层。
  • 可以在不改变公开契约的情况下变得更清晰的控制流或命名。
  • 未通过下方新增注释扫描的注释。

我优先删除代码并使用直接写法,而不是新增辅助函数。如果复用现有的局部模式可以避免分叉,我就会复用。我会保留必要的防护、证据、恢复行为、测试和用户确认的决定。

新增注释扫描

我会按照全局注释规则检查此次改动新增的每条注释。只有以下注释会保留:导出符号上的单行 /** */ 契约注释,或包含 URL、规范章节、ADR 或 docs/ 路径,或议题编号的单行引用。其余注释我都会立即删除,包括解释代码做什么、为何采用当前形式,或哪些内容可能因此失效的注释。我会对差异运行规则指定的 grep,并删除它打印出的每条注释。项目规则可以收紧此扫描,但不能放宽。

每项拟议编辑都必须说明简化了什么,以及为何可观察行为仍然等效;此次改动不得保留任何无引用的新增注释。此扫描是阻断条件。只要差异中还留有此类注释,调用方就不能宣告工作完成。

3. 应用并验证

我只会应用代码和现有测试能够支持其等效性的清理。如果清理会改变行为、要求、公开输出、持久化、授权或失败语义,我会将其作为单独提案返回,而不直接应用。

我会重新运行因清理而失效的检查,并将最终差异与原始请求进行比较。如果清理改动了已完成审查所覆盖的内容,我会通过 converge-reviews 仅使该部分覆盖失效并重新运行。过期的收敛结果无法验证简化后的差异。我会报告所做的编辑,或报告 No simplification needed,并附上精确的验证结果。

只有当差异范围没有超出请求、每一行保留内容都有任务依据,且适用的检查仍然通过时,我才会将差异视为完成。

评论

支持 Markdown