revert

revert 技能是一款精密的安全回滚代理程序，专为在复杂开发流程中维持项目完整性而设计。与基于单一提交（commit-by-commit）运作的标准 git revert 不同，此技能能够理解由 metadata.json 和 plan.md 管理的项目逻辑结构。它允许开发者通过识别所有相关提交、追踪文件变更并执行自动化的状态验证，来撤销整个追踪、特定阶段或个别任务，确保代码库在复原后保持一致。此工具适用于需要维护干净 Git 历史记录，同时管理多阶段开发任务的软件工程师与主管。

• 根据与特定任务、阶段或追踪相关联的提交进行逻辑分组。

• 强制性的多阶段撤销工作流程，包含影响分析与用户确认闸门。

• 在 Git 存储库、metadata.json 与项目 plan.md 文件之间自动进行状态同步。

• 默认执行安全回滚（创建复原提交而非使用破坏性的强制推送），以维护项目的可审计性。

• 复原后验证，包含项目质量检查与一致性报告。

• 输入：用户请求，指定要复原的范围（追踪、阶段或任务）。

• 操作：分析历史、列出受影响的文件与提交、要求明确的用户确认、执行复原，并更新项目文档。

• 约束：必须严格遵守 5 阶段任务生命周期；操作前务必进行预览；高风险操作必须获得手动确认。

• 适用场景：从失败的功能实现中复原、撤销实验性工作，或在结构化的工程环境中清理过期的任务。