publish-and-reuselisted
Install: claude install-skill ooooooooooooooooooop/agent-tools
# 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/调用既有工具/排序/报告):
```powershell
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,s