Skill 发现的三层来源与优先级
项目、自定义与用户三个根目录被发现并监视;同层内按 rank、提供方顺序、本地顺序裁决重名;最近的 scope 层胜出。
DISCOVERY SOURCES
项目根
仓库内,随版本走
自定义根
部署级,不随仓库
用户根
个人级,跨项目
SCAN
目录 bundle 或平铺文件
解析 frontmatter
只扫根目录一层
刻意不支持嵌套发现
监视变更并失效
新增、改名、删除即时可见
ARBITRATION
重名怎么裁决
1. 最近的 scope 层直接胜出
2. 同层内先比 rank
3. 再比提供方注册顺序
4. 最后比本地目录顺序
四步之后仍相同才视为同一份
顺序固定,所以同名覆盖是可预测的
优先级固定带来一个代价:用户根的同名 Skill 永远盖不过项目根,即使它是更新版本。
所以改名而不改内容的重命名,必须同时处理旧名字的残留,否则两个都会出现在目录里。