conductor-revert

Conductor Revert - 按逻辑工作单元安全撤销 Git 提交

技能概述

Conductor Revert 是一个 Git 感知的撤销工具，支持按 Track（整个任务）、Phase（阶段）或 Task（单个任务）为单位回退代码，让撤销操作与你的逻辑工作单元保持一致。

适用场景

1. 代码实现路径错误需要回退

当某个功能或任务的实现方向不对，需要完全重做时，不必逐个挑选 Git 提交进行撤销。只需指定对应的 Track ID、Phase 或 Task，Conductor Revert 会自动识别所有相关提交并按正确顺序执行回退。

2. 多阶段项目中需要撤销特定阶段

在分阶段开发的项目中，可能只需要撤销某个阶段（如 phase2）及其后续阶段的提交，同时保留早期已完成的工作。Conductor Revert 支持 {trackId}:phase{N} 格式精确控制撤销范围。

3. 需要保留完整 Git 历史的安全回退

与 git reset --hard 不同，Conductor Revert 使用 git revert 创建新的撤销提交，完整保留所有历史记录。即使提交已推送到远程，也能安全执行撤销操作，无需强制推送。

核心功能

1. 智能提交发现与关联

Conductor Revert 会扫描 Git 日志，自动找出与指定工作单元相关的所有提交。它支持多种提交消息格式，包括功能实现提交和任务标记提交（如 "mark task 2.3 complete"），确保不遗漏任何相关更改。

2. 执行前预览与确认

在执行任何撤销操作前，Conductor Revert 会显示完整的执行计划，包括将要撤销的提交列表、受影响的文件、Plan.md 状态变更等。需要用户明确输入 "YES" 才会继续，防止误操作。

3. 冲突安全处理

如果撤销过程中遇到 Git 冲突，Conductor Revert 会立即暂停并显示冲突详情，提供选项让用户选择处理方式。它不会尝试自动解决冲突，确保用户对每一处更改都有完全的控制权。

常见问题

Conductor Revert 和普通的 git revert 有什么区别？

普通 git revert 需要你手动指定每个提交的 SHA，而且要按正确的逆序执行。Conductor Revert 会自动根据 Track/Phase/Task 找出所有相关提交，按正确顺序批量撤销，同时同步更新 Conductor 的 Plan.md 和 tracks.md 状态。

推送到远程后还能安全撤销吗？

可以。Conductor Revert 使用 git revert 创建新的撤销提交，这是 Git 中最安全的回退方式。撤销完成后，你只需要正常 git push 即可，不需要也不应该使用 --force。远程仓库会看到新的撤销提交，完整保留所有历史。

撤销时遇到冲突怎么办？

Conductor Revert 会在检测到冲突时立即停止执行，显示冲突文件和选项。你可以选择查看冲突详情、中止撤销序列（保留已完成的撤销）或打开手动解决指南。任何情况下都不会尝试自动解决冲突，确保你对代码有完全控制。