展开知识库目录

Skill 安装在哪里:用户级、项目级和团队分发怎么选

用户级适合个人跨项目复用,项目级适合跟随仓库约束,团队分发还需要版本、依赖和升级策略。

先把问题看准

安装位置决定 Skill 影响范围

用户级适合个人跨项目复用,项目级适合跟随仓库约束,团队分发还需要版本、依赖和升级策略。实际目录和发现规则以当前客户端文档为准。

第 1 步

用户级

只影响个人环境,适合通用工作流和个人凭证引用;仍要避免在所有项目误触发。

记录客户端版本、Skill 版本、触发输入、实际步骤、工具调用和输出,正例与反例都要保留。

第 2 步

项目级

与仓库任务、规则和脚本紧密相关,便于版本化;不要提交个人路径、密钥和本机专用依赖。

确认“项目级”已经有可回查结果,再进入“团队分发”;依据仍然来自猜测时,把缺口单列并停在当前步骤。

第 3 步

团队分发

需要固定版本、安装清单、兼容性、更新和回滚,不能只发一个文件夹截图。

确认“团队分发”已经有可回查结果,再进入“依赖位置”;依据仍然来自猜测时,把缺口单列并停在当前步骤。

第 4 步

依赖位置

脚本、运行时、模板和工具的安装方式与作用域一致,使用环境变量或相对路径。

确认“依赖位置”已经有可回查结果,再进入“反向验证”;依据仍然来自猜测时,把缺口单列并停在当前步骤。

第 5 步

反向验证

在目标项目应发现,在无关项目不应意外触发;换一台干净环境按说明安装。

脚本、网络、凭证和写操作必须在说明中可见;触发边界不清或结果不可验收时不要扩大使用范围。 完成后把证据归入“安装记录与作用域说明”。

完成后应能在“安装记录与作用域说明”中找到与这一步对应的记录;仍需靠猜测补全,就停在这里。

做到这里就可以停

安装记录说明谁、在哪里、装了哪一版

包含来源、作用域、依赖、测试和卸载。团队 Skill 只有作者电脑能运行,不算完成分发。

进一步核对

参考资料与核对入口