soia-dev-sync-skillslisted

# soia-dev-sync-skills ## 客户可读说明 ### 这个技能可以做什么 将一个已安装或本地的共享技能目录同步到用户选择的 AI 工具目录。它只创建或替换同名的软链接；先用 `--dry-run` 展示影响，再在已有明确授权时写入。 ### 客户如何使用 提供源目录、目标 id 或路径，以及可选的单项技能名。目标由 `--targets` 显式提供；没有适合的内置 id 时使用绝对路径。 ```bash python3 skills/soia-dev-sync-skills/scripts/sync_soia_skills.py \ --source-dir <shared-skill-dir> \ --targets codex,claude \ --dry-run ``` 确认计划后移除 `--dry-run`。使用 `--skills <name>` 只同步指定技能，默认会把其 frontmatter 中的 `dependencies.hard` 一并纳入；`--no-deps` 可关闭该行为。 ### 依赖与安装 ```bash npx skills add soia-team/soia-open-skills -g -a '*' -s soia-dev-sync-skills -y ``` 依赖 Python 3 和一个包含 `SKILL.md` 子目录的源目录。可选配置示例在 `config.example.yml`：它仅记录用户自己的默认 source/targets，命令行参数优先。配置文件放在： ```text ~/.config/soia-skills/soia-open-skills/soia-dev/soia-dev-sync-skills/config.yml SOIA_DEV_SYNC_SKILLS_CONFIG_FILE=<custom-config-path> ``` ### 日志与完成回执 ```markdown 完成：<dry-run 或实际同步结果>。 日志摘要： - source: <共享技能源> - targets: <目标目录> - linked/removed: <数量与名称> - skipped/failed: <原因或无> 验证：<命令退出码、软链接解析或 dry-run> 问题与下一步：<确认、缺依赖或无> ``` ## 安全边界 - 先展示 source、目标、将创建/替换/删除的链接；没有本轮明确写入授权时停在预览。 - 拒绝把 source 自身作为目标；不复制目录。 - 只处理 `soia-*` 管理名和当前点名技能；绝不删除无关第三方技能。 - 默认清理指向不存在目标的一级 `soia-*` 软链接；用 `--no-prune` 保留它们。 ## 工作流 1. 确认 `--source-dir`、目标和技能范围；不要猜测个人目录或产品 workspace。 2. 运行 `--dry-run`，复核每个目标的 create/replace/remove 计划。 3. 得到授权后执行同一命令（不带 `--dry-run`）。 4. 复核退出码及每个目标的软链接解析结果；仅报告实际执行的验证。 常用命令： ```bash # 查看内置目标或共享源中的技能 python3 skills/soia-dev-sync-skills/scripts/sync_soia_skills.py --list-targets pyth