repo-sync

Repo-sync 是一款专为 workspace-hub 多仓库架构所设计的进阶协调技能。它能自动化管理超过 25 个独立 Git 仓库的同步流程，处理大型开发环境中常见的 Git 状态异常。该代理执行多阶段作业：批量拉取、故障诊断、自动化修复、编码健康验证以及背景生态系统健康汇报。专为管理分布式代码库的软件工程师与系统架构师设计，提供可靠且非破坏性的方式来解决 detached HEAD、未提交变更及分支历史分歧等问题。

• 使用优化脚本跨所有子模块与仓库执行批量 Git 操作。

• 针对分支分歧、工作区脏乱 (未提交变更)、detached HEAD 状态以及丢失上游追踪分支等故障模式进行细致诊断。

• 执行精确的自动修复，例如暂存脏乱变更、使用 --no-rebase 策略合并分歧分支，并在适当时重置子模块指针。

• 内含编码健康检查功能，可识别并标记 Windows 格式的 UTF-16/CRLF 文件，确保仓库整洁并预防流水线解析错误。

• 通过 ecosystem-health 技能触发背景生态系统健康审计，在不中断用户工作流程的前提下维护全局系统完整性。

• 实施严格的安全协议，包括针对“只读/已归档”远程仓库的例外处理机制，在通知开发者前将仅存在于本地的提交保存为补丁对象。

• 一律默认采取合并而非变基 (rebase)，以维持 workspace-hub 生态系统中稳定的 Git 历史记录。

• 将子模块 (如 digitalmodel 与 worldenergydata) 的 detached HEAD 状态视为正常行为，确保已锁定提交指针的完整性。

• 执行完毕后会提供结构化的 Markdown 摘要表格，详细列出仓库名称、检测到的问题、采取的修复方式以及最终结果。

• 需要本地写入权限，并通过调用仓库工作区内标准的 Git 二进制文件与 Shell 脚本进行操作。

• 除非明确触发，否则不会强制推送或强制重置 (reset --hard)，优先确保数据安全并针对如暂存冲突等破坏性情境保留人工审核流程。