skill-authoring-sync
Installation
SKILL.md
Skill Authoring Sync
本技能把“中央仓库沉淀”和“项目侧安装”串成一次闭环。默认中央仓库是 https://github.com/why8023/agent-skills.git,默认安装方式是 npx skills 的 Project scope,不额外加 -g。
Workflow
先识别目标环境的管理方式
- 用户要求刷新个人用户级安装时,先检查用户目录下
.apm/agent-config.json。读取其repository和entrypoint,再检查登记仓库的apm.yml是否包含目标 Skill 的源路径。 - 如果命中个人 APM 清单,完成下面的源码编写、验证、独立提交和推送后,调用登记仓库的
manage.ps1(Windows)或manage.sh(Linux),执行update --source <owner/repo/skill-subdirectory>和check;随后单独提交、推送个人清单更新。这条路径替代后面的 npx 安装步骤,目标 Agent 以个人清单为准。 - 登记入口失效或 APM 更新失败时报告问题,不自动回退到 npx。个人机器路径、登录信息及私有清单不得写入中央 Skill 仓库。
- 用户明确要求项目级安装时,先检查目标项目的
apm.yml。如果该项目已用 APM 管理此来源,使用其既有 APM 更新流程;没有采用 APM 的项目继续以下 npx 项目级流程,不因此扩大为全局安装。 - 新增或重命名的 Skill 必须先加入目标清单并处理旧路径,再安装;不能仅因清单没有条目就绕过已有管理器。