mcpField
I
improve

improve

github.com/owainlewis开发425347 次安装4 天前更新
代码仓库

关于 improve

供 Agent 使用的重构技能,在保持行为和公共接口不变的前提下简化代码。它要求进行针对性测试和检查,并将改动限制在目标范围内。

主要功能

  1. 01确定目标代码和需保持的行为
  2. 02覆盖不足时补充针对性测试
  3. 03简化、去重或澄清代码
  4. 04保留接口和用户可见行为
  5. 05运行检查并报告依据

适用场景

  1. 01降低近期变更代码的复杂度
  2. 02在不改变行为时消除重复
  3. 03重构测试覆盖不足的代码

安装

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

$npx skills add https://github.com/owainlewis/blueprint --skill improve

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

附带文件agents/openai.yaml

详细介绍

改进

让代码更易于理解,同时不改变其行为。减少读者需要追踪的层级,以及需要记住的隐藏状态。

流程

  1. 根据请求、当前 diff 或近期更改的代码,确定目标。
  2. 阅读目标代码、相关测试和周边代码。说明哪些行为必须保持不变。
  3. 如果这些行为缺少测试,添加有针对性的覆盖,并针对未更改的代码运行测试。重构前先提交通过的纯测试更改。如果自动化测试无法验证这些行为,请说明原因并提供其他证据。
  4. 找出不必要的复杂性、重复、死代码、含糊的命名、别扭的边界,以及得不偿失的抽象。
  5. 通过删除、去重、重命名、简化、提取或内联,进行有针对性的改进。
  6. 保留公共接口、数据结构、错误和用户可见行为,除非用户明确要求更改。
  7. 运行能够覆盖重构可能影响行为的测试和检查。报告改进内容、保持不变的行为,以及支持这些结论的证据。

返回内容

说明哪些内容变得更简单、哪些行为保持不变,以及哪些检查验证了这一点。指出仍未验证的行为。

边界

  • 不要扩展产品范围,也不要顺手处理无关的清理工作。
  • 优先进行少量清晰的修改,而不是大范围重写。
  • 即使重新设计更容易,也要保持行为不变。

评论

支持 Markdown