mcpField
C
cleanup-changes

cleanup-changes

github.com/robot-inventor开发352 次安装3 天前更新
代码仓库

关于 cleanup-changes

用于清理代码改动的 Skill,可回顾试错过程并移除不必要的修改。适用于用户提出清理要求或准备提交、创建拉取请求时,并默认保留 Git 暂存状态。

主要功能

  1. 01回顾试错过程中产生的改动
  2. 02区分必要与不必要的修改
  3. 03撤销判定为不必要的改动
  4. 04未经指示不改变 Git 暂存状态

适用场景

  1. 01提交前删除无关修改
  2. 02创建拉取请求前审查改动
  3. 03修复问题试验后清理代码

安装

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

$npx skills add https://github.com/robot-inventor/agent-skills --skill cleanup-changes

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

详细介绍

清理更改技能

人类和 Agent 通常都会通过反复试错来编写代码,并进行大量更改(包括非必要和不必要的更改),以实现最终目标。然而,这一试错过程中产生的非必要和不必要更改不应包含在最终代码中。应根据需要审查更改,并撤销不必要的更改,只保留必要的更改。

何时应用

当用户要求清理更改,或在创建提交或拉取请求之前,应执行此技能。

步骤

以下是此技能的核心内容;请遵循指定步骤。除非用户明确要求,否则不要更改 Git 暂存状态。用户可能已暂存更改,以此记录代码最后一个预期状态的快照。

1. 回顾试错过程

回顾任务中的试错过程,区分本质上必要的更改,以及虽经尝试但最终证明无效且不必要的更改。

不要假定某项更改本质上是否必要。例如,修复 Bug 时,应审查 Bug 最终修复时所做的更改,理解 Bug 的根本原因,然后据此判断每项更改是否本质上必要。

判断每项更改是否必要时,应特别注意由多个因素导致的 Bug。Bug 可能由单一、简单的原因引起,也可能由多个因素共同导致。如果是由单一、简单的原因引起,那么修复 Bug 时最后所做的更改可能就足够了,之前的更改可能是不必要的。如果 Bug 是由多个因素导致的,那么仅靠最后一项更改可能不够,试错过程中为解决问题而做的一些前序更改也可能是必要的。请仔细考虑 Bug 的根本原因,包括它是由单一原因还是多个因素导致的,然后判断哪些更改必要,哪些不必要。

2. 撤销不必要的更改

撤销上一步判定为不必要的所有更改,只保留必要的更改。

不过,即使某项更改并非严格必要,对当前更改附近的拼写错误进行小幅修正,或进行小规模重构,也是可以接受的。通常,在编码过程中,即使并非严格必要,修正更改附近发现的拼写错误,或进行与当前更改相关的小规模重构,都是可以接受的。

评论

支持 Markdown