skill-sync
Installation
SKILL.md
Skill Sync
在开始前,确认当前仓库是否以 skills/<skill-name>/ 组织 skill。默认交付物至少包含 SKILL.md;如果仓库已经使用 agents/openai.yaml,也一并创建或更新。
Default Sync Targets
- 默认附加 agent 目标:
codex、claude-code、openclaw、cursor、opencode、qoder、trae、trae-cn、windsurf。 Universal由npx skills自动包含,对应.agents/skills;默认不要额外写-a universal。- 如果用户明确要求只更新其中一部分 agent,就把默认目标集缩小到用户指定范围。
- 统一约定:只有在“全部 skill + 全部受支持 agent”都要同步时才使用
--all。 - 不要再使用
--skill '*';当前 Windows 环境下它可能不会按“全部 skill”解析。
Workflow
- 建立变更范围。
- 确认目标 skill 名,使用小写加连字符。
- 检查
skills/下是否重名;更新已有 skill 时复用原目录。 - 如果是重命名 skill,明确旧名和新名,并把这次工作视为“新增新 skill + 删除旧 skill + 清理旧安装”。
- 只处理本次目标 skill 相关文件,不要混入仓库里其他未完成变更。