展开知识库目录

Skill 更新冲突或不再使用时,怎样停用、卸载和回滚

直接删目录可能让项目规则、自动化、文档和团队任务失去依赖。

先把问题看准

停用 Skill 先查谁在引用它

直接删目录可能让项目规则、自动化、文档和团队任务失去依赖。先禁用触发,观察影响,再删除文件、脚本、凭证和分发记录。

第 1 步

盘点安装与引用

用户级、项目级、团队包、规则文件、自动化和文档中所有路径与版本。

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

第 2 步

选择停用或回滚

更新冲突优先回到上一稳定版;不再使用则先标弃用和替代,给迁移窗口。

确认“选择停用或回滚”已经有可回查结果,再进入“禁用并做反向测试”;依据仍然来自猜测时,把缺口单列并停在当前步骤。

第 3 步

禁用并做反向测试

Skill 不应再触发,原有任务应使用替代流程或给清楚错误,而不是静默失败。

确认“禁用并做反向测试”已经有可回查结果,再进入“移除依赖和秘密”;依据仍然来自猜测时,把缺口单列并停在当前步骤。

第 4 步

移除依赖和秘密

删除脚本、包、环境变量、Token、缓存和外部授权,保留必要审计记录。

确认“移除依赖和秘密”已经有可回查结果,再进入“更新团队文档”;依据仍然来自猜测时,把缺口单列并停在当前步骤。

第 5 步

更新团队文档

安装目录、索引、示例和链接指向替代版本,通知受影响使用者。

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

完成后应能在“停用记录、依赖清单与替代链接”中找到与这一步对应的记录;仍需靠猜测补全,就停在这里。

做到这里就可以停

卸载完成要证明没有残留触发和权限

记录旧版、原因、受影响项目、替代、验证和恢复路径。历史产物是否保留按数据政策处理,不因卸载一并删除。

进一步核对

参考资料与核对入口