ooooooooooooooooooop 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 生命周期同步。
模式路由
| 用户说 | 进入模式 |
|---|---|
| 同步一下 / 同步我的 Personal AI / 更新一下这台电脑 / 让两台电脑一致 | SYNC（AUTO_SYNC，自动判方向） |
| 把变化同步出去 / 只上传 | PUSH（显式上传，必须有 ownership receipt） |
| 只检查 | CHECK（只读） |
| 只拉远端 | PULL（禁止 push/merge） |
| 只上传 | PUSH（禁止 pull/merge） |
| 在新电脑恢复 | RESTORE |
| 上传环境 / 更新环境 / 环境体检 / 新设备复现（旧表达） | 继续工作，映射到 PUSH / PULL / CHECK / RESTORE 子流程 |
高层工作流
编排器（薄，只 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、显式 push 模式下有 ownership receipt 且验证通过的 FF push、不同设备新增 record/revision 的 Memory 确定性合并（复用 MemoryProvider.import_bundle 契约）、派生索引 rebuild、runtime diff/refresh。SYNC 不隐式 commit/push。
安全规则（铁律）
- 方向判定只用 git ancestry，禁止 mtime / last-write-wins / timestamp 覆盖。
- LOCAL_DIRTY 一律 UNTOUCHED：禁止自动 add/commit/stash/reset/checkout/overwrite。
- DIVERGED 默认 REVIEW：禁止自动 merge/rebase/force push 基础设施 canonical；唯一例外是 memory-only 且路径不相交的确定性合并，且 curated state（identity/preferences/goals）双端修改永远 CONFLICT_REVIEW。
- secrets 绝不进 git sync：只检测引用 AVAILABLE/MISSING/NOT_REQUIRED；optional 缺失不阻塞整体。
- device-local / derived 永不同步：路径、GPU、端口、索引、projcache、node_modules——每设备
aic discover/ 本地 rebuild。 - raw history 不走 git sync：sessions/traces/broker sqlite 继续走 Durability。
- 凭据绝对不出包：
.credentials.yaml、sessions/、storages/永远排除。 - 不破坏目标端无关文件：所有 apply 仅增量覆盖，不清理未登记文件。
- 已知外部 blocker（BACKUP_KEY_CUSTODY / NOVEL_REPO_DURABILITY）状态未变只报
known external blocker, unchanged，不重复建议解决。 - public 项目 push 前必须 privacy scan，命中即 BLOCKED_PRIVACY（NOVEL_REPO_DURABILITY 继续保持）。
- canonical 写操作必须先取得 machine-local mutation lease；dirty、foreign lock、unknown lock 或 scope 未验证时一律 REVIEW/DEFER。
- commit 只能 stage 声明的 owned paths，并写出 machine-local ownership receipt；禁止
git add -A、隐式 push 和非 canonical restore 注册 Scheduler。
输出契约
默认短输出（用户说“展开”才下钻 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）：仅显式
push模式；每个 ahead commit 必须有 ownership receipt，再执行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 无新增异常。