skill-sync
将 ~/.agent/skills/ 下的技能通过软链接同步到所有其他 Agent，实现一套 skill 多 Agent 复用。
设计原则
- 单一来源：
~/.agent/skills/是所有技能的唯一存储位置 - 软链复用：其他 Agent 的 skills 目录中创建指向源目录的软链接
- 非破坏性：只同步软链，不移动或删除实际文件
支持的 Agent
| Agent | Skills 目录 |
|---|---|
| knot | ~/.agent/skills/ ← 主目录（源） |
| codex | ~/.codex/skills/ |
| codex-internal | ~/.codex-internal/skills/ |
| claude | ~/.claude/skills/ |
| claude-internal | ~/.claude-internal/skills/ |
| gemini | ~/.gemini/skills/ |
| copilot | ~/.copilot/skills/ |
| codebuddy | ~/.codebuddy/skills/ |
使用流程
1. 查看当前状态
python3 scripts/sync.py --status
2. 同步所有 Agent
python3 scripts/sync.py
3. 只同步特定 Agent
python3 scripts/sync.py --agent codex
python3 scripts/sync.py --agent claude
python3 scripts/sync.py --agent gemini
4. 预览（不实际执行）
python3 scripts/sync.py --dry-run
5. 移除软链接
python3 scripts/sync.py --remove --agent codex
注意事项
- 如果目标位置已存在真实目录（非软链），脚本会跳过并给出警告，需手动处理
- 各 Agent 的
.system目录不会被同步 - 新安装技能到
~/.agent/skills/后，重新运行sync.py即可同步 - 如果某个 Agent 的配置根目录已存在，但
skills/子目录不存在，脚本会自动创建该目录后再同步 - 部分 Agent（如 claude-internal）的 skills 目录可能不存在，会自动跳过
