borgmatic 策略驱动的 Borg 备份与恢复

要解决的问题

直接用 borg 写备份脚本，最常见的失控是策略散落。仓库路径、保留数量、压缩级别、检查频率、失败重试分别写在不同 cron、shell 或 CI job 里。改一次保留策略可能要动多个脚本；漏改一处就可能出现备份还在跑、但检查没跟上、保留版本数和合规要求对不上的情况。borgmatic 的价值在于把这些规则收敛到一个声明式配置中，但资料里这段命令拼装逻辑仍然容易被忽略。

这个技能做什么

它把 borgmatic 作为 Borg Backup 的自动化入口，让 agent 基于同一份配置执行 backup、prune、check、restore 这些 runbook 动作，而不是逐条拼接原始命令。

核心流程可以拆成三步：

• 读取一个声明式配置文件，其中描述要备份的仓库、源路径、保留策略、检查项和自定义预处理脚本。
• agent 根据配置调用 borgmatic 的例行操作，而不是分别构造 borg create、borg prune、borg check 或 borg extract。
• 把“备份后检查”“按保留窗口清理”“按策略恢复”编排成可监督的流程，降低命令参数漂移带来的风险。

这样处理的收益不只是少写命令。备份、清理、检查使用同一份策略，智能体在处理“备份刚完成但需要验证”“保留版本超了要裁剪”“恢复前先做一致性检查”这类任务时，判断依据更一致。

适用边界与注意点

它适合已经在使用 Borg Backup、希望把备份运维收敛到单一配置的场景。borgmatic 只负责编排和配置管理，不替代 Borg 的底层压缩、去重和加密机制；也不自动决定哪些目录必须备份。

使用前仍需确认上游前提：系统里已经安装 borgmatic 和 borg，并理解配置文件里每个源、目标仓库和脚本的含义。恢复操作会读取所选配置对应的备份仓库；如果配置文件缺少关键路径，agent 可能看似完成备份，但实际上没有覆盖目标数据。

此外，本技能资料只提供使用方向和上游文档链接，没有展开完整的配置字段说明或错误处理细节。实际落地时仍要参考 borgmatic 官方文档，并在测试仓库上验证 prune 和 check 的结果。