关于 improve
供 Agent 使用的重构技能,在保持行为和公共接口不变的前提下简化代码。它要求进行针对性测试和检查,并将改动限制在目标范围内。
主要功能
- 01确定目标代码和需保持的行为
- 02覆盖不足时补充针对性测试
- 03简化、去重或澄清代码
- 04保留接口和用户可见行为
- 05运行检查并报告依据
适用场景
- 01降低近期变更代码的复杂度
- 02在不改变行为时消除重复
- 03重构测试覆盖不足的代码
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ owainlewis/ blueprint --skill improve安装后在 Claude Code 中输入/improve确认已加载。
附带文件agents/openai.yaml
详细介绍
改进
让代码更易于理解,同时不改变其行为。减少读者需要追踪的层级,以及需要记住的隐藏状态。
流程
- 根据请求、当前 diff 或近期更改的代码,确定目标。
- 阅读目标代码、相关测试和周边代码。说明哪些行为必须保持不变。
- 如果这些行为缺少测试,添加有针对性的覆盖,并针对未更改的代码运行测试。重构前先提交通过的纯测试更改。如果自动化测试无法验证这些行为,请说明原因并提供其他证据。
- 找出不必要的复杂性、重复、死代码、含糊的命名、别扭的边界,以及得不偿失的抽象。
- 通过删除、去重、重命名、简化、提取或内联,进行有针对性的改进。
- 保留公共接口、数据结构、错误和用户可见行为,除非用户明确要求更改。
- 运行能够覆盖重构可能影响行为的测试和检查。报告改进内容、保持不变的行为,以及支持这些结论的证据。
返回内容
说明哪些内容变得更简单、哪些行为保持不变,以及哪些检查验证了这一点。指出仍未验证的行为。
边界
- 不要扩展产品范围,也不要顺手处理无关的清理工作。
- 优先进行少量清晰的修改,而不是大范围重写。
- 即使重新设计更容易,也要保持行为不变。
评论
支持 Markdown