当你在Codex中精心配置了多个Skills,用于日常自动化工作流,却因重装系统、环境迁移或文件误删导致全部技能失效——这种崩溃体验相信不少用户都曾经历过。为避免此类灾难,你需要在问题发生前完成一项关键操作:Codex技能包的结构化备份。这并非可选项,而是保障AI工作流持续运行的强制性措施。
确认技能包实际存储位置
打开文件资源管理器,直接复制并访问以下路径:%APPDATA%Codexskills。这是Codex Desktop默认加载第三方及自定义Skills的主目录,所有以文件夹形式存在的技能包(如.curated/pdf、.system/skill-installer)均位于此目录下。
注意:切勿仅依赖Codex界面中显示的“已启用技能列表”来判断备份范围——部分已禁用技能仍保留在该目录下,而通过$skill-installer安装的技能可能写入子目录.curated或.system,必须完整打包。

执行全量压缩备份
选中整个skills文件夹 → 右键 → “发送到” → “压缩(zipped)文件夹”即可。
将生成的ZIP文件重命名为codex-skills-backup-$(date +%Y%m%d).zip(例如codex-skills-backup-20260601.zip),并立即保存至非系统盘(如D:BackupCodex)或加密云盘根目录。
关键前提:备份前请确保Codex应用已完全退出——任务栏右下角托盘图标消失,且进程管理器中无codex.exe残留。否则可能导致部分技能文件因被占用而跳过压缩,造成备份不完整。
验证备份可用性
第一步:将刚生成的ZIP包解压到临时文件夹;
第二步:检查解压后是否包含.curated与.system这两个核心子目录;
第三步:进入.curated目录,确认至少存在一个非空子文件夹(如notion-knowledge-capture),且其内部包含skill.yaml或README.md文件;
第四步:打开Codex → 调用命令面板(Ctrl+Shift+P)→ 输入$skill-installer list → 观察终端输出是否列出你预期的技能名称。若全部出现,则说明备份可直接用于恢复。
增量备份高频更新技能
方法一:对日常迭代的技能单独快照
进入%APPDATA%Codexskills.curatedgh-fix-ci这类频繁修改的技能目录,右键 → “属性” → 查看“修改日期”,若近24小时内有变更,立即对该子文件夹单独压缩,并在命名中添加-delta后缀(如gh-fix-ci-delta-20260601.zip)。
方法二:通过命令行精准捕获变更
以管理员身份运行PowerShell,执行:robocopy "%APPDATA%Codexskills.curated" "D:BackupCodexdelta" /e /xo /np /log:D:BackupCodexdeltalast-sync.log。该命令仅同步比目标目录更新的文件,/xo参数可排除已存在且时间戳相同的文件,避免冗余覆盖。
这一步操作起来非常简单,将文件直接拖入目标目录即可。
