Personal AI 生命周期同步（publish-and-reuse）

定位

本 skill 是 Personal AI Infrastructure 长期、多设备、增量生命周期同步的最高层入口。 用户平时只需要说“同步一下我的 Personal AI”，系统自动判断本次应该 PULL / PUSH / MERGE / NO ACTION / REVIEW / BLOCKED——用户不负责判断方向。 Fresh Restore 只是 local canonical missing 时的特殊 SYNC。

旧的 DSH 四层能力（Skills / 插件 / MCP / DSH 配置的上传、更新、体检、新设备复现）保留，但作为整体同步中的子步骤。

复杂协议、SYNC_OWNERSHIP_MATRIX、方向规则、Memory 合并契约、RESTORE 全流程： references/personal-ai-lifecycle-sync.md（先读它再执行非常规场景）。

不适用（负向边界）

• 在非 agent-tools 仓库的其他业务工作区执行环境同步/上传/覆盖。
• 修改具体业务代码或单个 Skill 的内部实现（交给 minimal-implementation）。
• 日常代码编写与单点 Bug 修复。
• 用本入口同步 secrets、sessions、broker sqlite、device-local 路径或派生索引——这些永不进入 git 生命周期同步。

模式路由

高层工作流

编排器（薄，只 inspect/classify/调用既有工具/排序/报告）：

python scripts\personal_ai_sync.py check      # 只读分类，连 checkpoint 都只读更新
python scripts\personal_ai_sync.py sync       # AUTO_SYNC 默认日常入口
python scripts\personal_ai_sync.py sync --detail   # 下钻
python scripts\personal_ai_sync.py restore    # Fresh/缺失恢复

内部顺序（防数据丢失）：fetch all → classify all（git ancestry，禁止 mtime/last-write-wins）→ action plan → 只执行确定安全动作 → 受影响面判定 → 受影响 Harness aic apply（generated-only，snapshot+post-diff+rollback）→ 受影响 derived 增量 refresh → validate → 写 machine-local checkpoint（~/.dsh/.personal-ai-sync/status.json）→ 短输出。

确定安全的自动动作（其余一律 REVIEW）：clean FF pull、验证通过且 privacy scan PASS 的 FF push、不同设备新增 record/revision 的 Memory 确定性合并（复用 MemoryProvider.import_bundle 契约）、派生索引 rebuild、runtime diff/refresh。

安全规则（铁律）

1. 方向判定只用 git ancestry，禁止 mtime / last-write-wins / timestamp 覆盖。
2. LOCAL_DIRTY 一律 UNTOUCHED：禁止自动 add/commit/stash/reset/checkout/overwrite。
3. DIVERGED 默认 REVIEW：禁止自动 merge/rebase/force push 基础设施 canonical；唯一例外是 memory-only 且路径不相交的确定性合并，且 curated state（identity/preferences/goals）双端修改永远 CONFLICT_REVIEW。
4. secrets 绝不进 git sync：只检测引用 AVAILABLE/MISSING/NOT_REQUIRED；optional 缺失不阻塞整体。
5. device-local / derived 永不同步：路径、GPU、端口、索引、projcache、node_modules——每设备 aic discover / 本地 rebuild。
6. raw history 不走 git sync：sessions/traces/broker sqlite 继续走 Durability。
7. 凭据绝对不出包：.credentials.yaml、sessions/、storages/ 永远排除。
8. 不破坏目标端无关文件：所有 apply 仅增量覆盖，不清理未登记文件。
9. 已知外部 blocker（BACKUP_KEY_CUSTODY / NOVEL_REPO_DURABILITY）状态未变只报 known external blocker, unchanged，不重复建议解决。
10. public 项目 push 前必须 privacy scan，命中即 BLOCKED_PRIVACY（NOVEL_REPO_DURABILITY 继续保持）。

输出契约

默认短输出（用户说“展开”才下钻 git 日志/diff/governance 细节）：

Personal AI Sync

agent-tools          IN_SYNC / PULLED / PUSHED
personal-ai-state    IN_SYNC / PULLED / PUSHED / MERGED
projects             <简要汇总>
memory               <新增/合并/冲突数量>
runtime              NO DRIFT / refreshed
secrets              READY / PARTIAL
external blockers    known external blocker, unchanged

Result: PASS / REVIEW / BLOCKED

冲突时先把确定安全的部分同步完，只把真正冲突留给人工（不问“要不要同步其他没冲突的”）。

旧能力：DSH 四层子流程（保留）

• 体检：python scripts\sync_skills.py --destination "$env:USERPROFILE\.dsh\skills" --plugins-destination "$env:USERPROFILE\.dsh\profiles\web\plugins" --dsh-config-dir dsh-config --mcp-cordis "$env:USERPROFILE\.dsh\profiles\web\cordis.patch.yml" --profile full --check
• 上传（Push）：门禁 git diff --check + validate_repo --strict + quality_report --strict + 仓库回归 + publish_check.py → git push → 四层体检确认。
• 更新（Pull）：git pull --ff-only → 门禁 → 同体检命令 --apply → 逐层 sync_dsh_config.py apply → 重启 DSH 生效。
• 新设备复现（Install）：RESTORE 流程（见 reference §14），幂等、可重复执行。

权威细节：references/personal-ai-lifecycle-sync.md、docs/publishing.md、docs/sync-ongoing.md。

验证

本 skill 变更后必须全绿：

python scripts/validate_repo.py --strict
python skills/skill-quality-gate/scripts/quality_report.py --root . --strict
python -m unittest discover -s tests -v
python scripts/publish_check.py

同步执行后验收：aic validate = VALID + 已安装 Harness aic diff = NO DRIFT + personal_status 无新增异常。