SuperAPI AI 工具集

soia-dev-sync-skills

通用与其它

查看项目

更新于 10-16 08:49

技能介绍

用途:把一个已安装或本地的共享技能目录,以软链接方式同步到用户明确选择的 AI 工具目录。只创建或替换同名软链接,不复制目录。

主要能力:支持 --dry-run 预览;--targets 显式指定内置目标 id 或绝对路径;--skills 只同步指定技能,默认会纳入其 frontmatter 中 dependencies.hard(用 --no-deps 关闭);默认清理指向不存在目标的一级 soia-* 软链接(用 --no-prune 保留)。仅处理 soia-* 管理名和当前点名技能,不删除无关第三方技能。

使用方式: 安装:npx skills add soia-team/soia-open-skills -g -a '*' -s soia-dev-sync-skills -y 同步:python3 skills/soia-dev-sync-skills/scripts/sync_soia_skills.py --source-dir <shared-skill-dir> --targets codex,claude --dry-run 确认后去掉 --dry-run。查看内置目标或源内技能: python3 ... --list-targets;python3 ... --source-dir <dir> --list-skills

依赖:Python 3,源目录含 SKILL.md 子目录。可选配置 config.example.yml,路径 ~/.config/soia-skills/soia-open-skills/soia-dev/soia-dev-sync-skills/config.yml,可用 SOIA_DEV_SYNC_SKILLS_CONFIG_FILE 指定自定义路径;命令行参数优先。审计日志写到 ${XDG_STATE_HOME:-~/.local/state}/soia-dev-sync-skills/,最多保留 20 个。

限制与安全边界:拒绝把 source 自身作为目标;不复制目录;无本轮明确写入授权时停在预览。目标需显式提供,无法确定时选 other-ai-tools。