关于 clean-copy
clean-copy 是一项编码技能,用于从 main 在新分支上重做现有分支,并整理出便于审阅的提交历史。它将改动拆分为逻辑步骤,并要求最终分支与源分支一致。
主要功能
- 01检查源分支、状态、提交和差异
- 02从 main 在干净分支上重做改动
- 03按连贯实现步骤规划提交
- 04验证最终分支与源分支一致
- 05使用 pr 技能创建拉取请求
适用场景
- 01将功能分支整理成清晰的提交序列
- 02为审阅者整理分支历史
- 03重做工作但保持最终状态不变
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ tldraw/ tldraw --skill clean-copy安装后在 Claude Code 中输入/clean-copy确认已加载。
详细介绍
干净副本
在新分支上重新实现当前分支,并构建清晰、具有叙事质量的提交历史,便于审查者理解。
工作流
- 收集上下文:
- 源分支:
git branch --show-current。 - 工作区:
git status --short。 - 自 main 以来的提交:
git log main..HEAD --oneline。 - 差异摘要:
git diff main...HEAD --stat。
- 源分支:
- 验证源分支:
- 确保没有未提交的更改或合并冲突。
- 确认源分支已与
main保持同步。
- 选择新分支名称:
- 如果用户提供了所请求的名称,则使用该名称。
- 否则使用
<source-branch>-clean。
- 分析差异:
- 研究源分支与
main之间的所有更改。 - 在重新创建之前,理解最终预期状态。
- 研究源分支与
- 从
main创建干净分支。 - 规划提交故事线:
- 将实现拆分为自包含的逻辑步骤。
- 每一步都应读起来像教程中的一个开发阶段。
- 重新实现工作:
- 逐步重新创建最终更改。
- 在每个连贯的想法之后提交。
- 使用清晰的提交主题和描述。
- 对中间提交使用
git commit --no-verify,以免钩子阻止暂时不完整的状态。
- 验证正确性:
- 确认最终干净分支状态与原始源分支完全一致。
- 在不使用
--no-verify的情况下运行最终提交,以便正常运行检查。
- 使用
pr技能打开拉取请求。- 在 PR 描述中包含指向原始分支的链接。
规则
- 永远不要将自己或 AI 工具添加为作者、贡献者或共同作者。
- 永远不要在提交或 PR 内容中包含 AI 署名。
- 最终干净分支必须与源分支完全相同。
- 除非用户明确要求,否则不要强制推送。
评论
支持 Markdown