SuperAPI AI 工具集

clean-branch

编程与开发

查看项目

更新于 10-16 01:09

技能介绍

用途:从混合了已提交改动和工作区改动的代码中,提取出某个功能所需的最小完整改动,放到一个新分支上,同时保持源分支、索引和工作文件不变。它改变的是所选内容,不是仅做历史清理。

主要能力:先根据请求、对话和相关 issue 或 PR 推断目标功能与范围,检查实际提交差异、暂存与未暂存改动以及未跟踪文件,并记录源 HEAD 与状态。若存在多个同样可能的功能,会先询问要提取哪一个。基点的选择顺序为用户指定基点、当前 PR 的基点、仓库默认分支;能解析为提交,并尽量刷新远程跟踪引用,同时说明新鲜度限制。无法确定基点时会询问而非猜测。

使用方式:在独立 worktree 中创建新分支,优先使用 git-wt,否则用 git worktree add。只在目标分支应用编辑,源保持不动。按功能依赖而非整提交或整文件选择改动,混合 hunk 可能需要针对目标重新实现。包含该功能真正需要的集成、依赖、生成文件、文档和测试,舍弃无关重构、格式化、实验和推测性工作。提取冲突按预期行为和当前基点解决,整文件复制不得覆盖基点上的较新改动。

验证与交付:对照记录的基点审查完整目标差异,包括新文件;在目标分支运行相关功能测试和仓库要求的检查;端到端验证原始需求,必要时与源比较相关行为并说明实际测量内容。修复提取引入的失败,报告未验证的需求。确认源 HEAD、索引和工作文件未变,并报告目标分支、基点提交、worktree 路径、保留或省略的内容及检查结果。除非被请求或已获授权,提取的改动保持未提交;推送或开 PR 适用同样的授权规则。

限制:资料未提供具体安装命令、收费、价格、平台支持或效果数据。