---

name: conductor-revert description: "按逻辑工作单元（轨道、阶段或任务）进行 Git 感知的撤销操作" risk: critical source: community date_added: "2026-02-27"

撤销轨道

按逻辑工作单元进行变更撤销，具有完整的 git 感知能力。支持撤销整个轨道、特定阶段或单个任务。

何时使用此技能

• 处理撤销轨道任务或工作流时
• 需要撤销轨道的指导、最佳实践或检查清单时

不要使用此技能当

• 任务与撤销轨道无关时
• 需要此范围之外的不同领域或工具时

说明

• 明确目标、约束和所需输入。
• 应用相关最佳实践并验证结果。
• 提供可操作的步骤和验证方法。
• 如需详细示例，请打开 resources/implementation-playbook.md。

预检检查

1. 验证 Conductor 已初始化：

   • 检查 conductor/tracks.md 是否存在
   • 如果缺失：显示错误并建议先运行 /conductor:setup

2. 验证 git 仓库：

   • 运行 git status 确认 git 仓库

   • 检查未提交的更改

   • 如果存在未提交的更改：

     警告：检测到未提交的更改
     
     有更改的文件：
     {文件列表}
     
     选项：
     1. 暂存更改并继续
     2. 先提交更改
     3. 取消撤销
     

3. 验证 git 状态足够干净可以撤销：

   • 没有正在进行的合并
   • 没有正在进行的变基
   • 如果发现问题：停止并解释解决步骤

目标选择

如果提供了参数：

解析参数格式：

完整轨道： {trackId}

• 示例：auth_20250115
• 撤销整个轨道的所有提交

特定阶段： {trackId}:phase{N}

• 示例：auth_20250115:phase2
• 撤销阶段 N 及所有后续阶段的提交

特定任务： {trackId}:task{X.Y}

• 示例：auth_20250115:task2.3
• 仅撤销任务 X.Y 的提交

如果没有参数：

显示引导式选择菜单：

你想撤销什么？

当前进行中：
1. [~] dashboard_20250112 中的任务 2.3（最近）

最近完成：
2. [x] dashboard_20250112 中的任务 2.2（1 小时前）
3. [x] dashboard_20250112 中的阶段 1（3 小时前）
4. [x] 完整轨道：auth_20250115（昨天）

选项：
5. 输入特定引用（track:phase 或 track:task）
6. 取消

选择选项：

提交发现

任务撤销

1. 在 git 日志中搜索任务特定的提交：

   git log --oneline --grep="{trackId}" --grep="Task {X.Y}" --all-match
   

2. 同时查找 plan.md 更新提交：

   git log --oneline --grep="mark task {X.Y} complete" --grep="{trackId}" --all-match
   

3. 收集所有匹配的提交 SHA

阶段撤销

1. 通过读取 plan.md 确定该阶段的任务范围

2. 搜索该阶段中所有任务的提交：

   git log --oneline --grep="{trackId}" | grep -E "Task {N}\.[0-9]"
   

3. 查找阶段验证提交（如果存在）

4. 查找该阶段任务的所有 plan.md 更新提交

5. 按时间顺序收集所有匹配的提交 SHA

完整轨道撤销

1. 查找所有提及该轨道的提交：

   git log --oneline --grep="{trackId}"
   

2. 查找轨道创建提交：

   git log --oneline -- "conductor/tracks/{trackId}/"
   

3. 按时间顺序收集所有匹配的提交 SHA

执行计划显示

在任何撤销操作之前，显示完整计划：

================================================================================
                           撤销执行计划
================================================================================

目标：{正在撤销的内容描述}

要撤销的提交（按时间倒序）：
  1. abc1234 - feat: 添加图表渲染 (dashboard_20250112)
  2. def5678 - chore: 标记任务 2.3 完成 (dashboard_20250112)
  3. ghi9012 - feat: 添加数据钩子 (dashboard_20250112)
  4. jkl3456 - chore: 标记任务 2.2 完成 (dashboard_20250112)

将受影响的文件：
  - src/components/Dashboard.tsx（已修改）
  - src/hooks/useData.ts（将被删除 - 在这些提交中创建）
  - conductor/tracks/dashboard_20250112/plan.md（已修改）

计划更新：
  - 任务 2.2：[x] -> [ ]
  - 任务 2.3：[~] -> [ ]

================================================================================
                              !! 警告 !!
================================================================================

此操作将：
- 创建 {N} 个撤销提交
- 修改 {M} 个文件
- 将 {P} 个任务重置为待处理状态

没有手动干预，此操作无法轻易撤销。

================================================================================

输入 'YES' 继续，或输入其他任何内容取消：

关键：需要明确的 'YES' 确认。不要在 'y'、'yes' 或回车时继续。

撤销执行

按时间倒序执行撤销（最新的优先）：