关于 cleanup-changes
用于清理代码改动的 Skill,可回顾试错过程并移除不必要的修改。适用于用户提出清理要求或准备提交、创建拉取请求时,并默认保留 Git 暂存状态。
主要功能
- 01回顾试错过程中产生的改动
- 02区分必要与不必要的修改
- 03撤销判定为不必要的改动
- 04未经指示不改变 Git 暂存状态
适用场景
- 01提交前删除无关修改
- 02创建拉取请求前审查改动
- 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. 撤销不必要的更改
撤销上一步判定为不必要的所有更改,只保留必要的更改。
不过,即使某项更改并非严格必要,对当前更改附近的拼写错误进行小幅修正,或进行小规模重构,也是可以接受的。通常,在编码过程中,即使并非严格必要,修正更改附近发现的拼写错误,或进行与当前更改相关的小规模重构,都是可以接受的。