SuperAPI AI 工具集

request-refactor-plan

编程与开发

查看项目

更新于 10-16 01:38

技能介绍

用途:当用户想要规划重构、创建重构 RFC 或将重构拆分为安全增量步骤时,调用此技能生成详细的重构计划,并作为 GitHub issue 提交。

主要流程与能力:先向用户询问想解决的问题的详细描述以及可能的解决方案想法;探索仓库以验证用户断言并了解代码库现状;询问用户是否考虑过其他选项,并展示其他选项;就实现细节进行极其详细彻底的访谈;确定实现的确切范围,明确计划更改与不更改的内容;检查该区域代码的测试覆盖率,若覆盖不足则询问用户的测试计划;将实现拆解为小提交计划,遵循 Martin Fowler 的建议“让每个重构步骤尽可能小,这样你始终可以看到程序在工作”。

GitHub issue 模板包含:问题陈述(从开发者角度描述面临的问题)、解决方案(从开发者角度描述)、提交计划(长而详细的实现计划,用通俗语言拆解为尽可能小的提交,每个提交都应使代码库保持可工作状态)、决策文档(实现决策列表,可含将构建/修改的模块、模块接口、开发者的技术澄清、架构决策、Schema 变更、API 契约、具体交互;不要包含具体文件路径或代码片段以免过时)、测试决策(好测试的描述,只测外部行为不测实现细节;将测试哪些模块;测试的先例)、范围之外、补充说明(可选)。

使用方式与限制:技能按步骤执行,若认为不必要可跳过某些步骤。官方未提供具体安装或调用命令。适用场景为代码重构的前期规划与沟通。不编造收费、价格、平台或效果信息。