Skill 从下载到用起来

Skill 怎么更新、恢复旧版和移除:做一次可回退练习

为会议待办 Skill 增加取消规则,备份并测试新旧用例,练习恢复旧版、项目目录移出与 Codex 精确路径禁用。

本文目录 · 7

更新 Skill 不只是把新 SKILL.md 盖上去。新版可能改了触发条件、增加脚本,甚至把“整理结果”变成“发送结果”。本课用上一课的会议待办 Skill 做一次小更新,验证成功后再练习恢复与停止使用。

适用于手动放入项目目录的本地 Skill。插件安装的技能应由对应产品的插件管理流程维护,不能照本课随意拆插件文件。本课不删除正式资料,不调用外部服务,也不要求升级模型账号。

1. 先查清自己到底装在哪里

准备专用项目 C:\ai-practice\meeting-work,按 制作第一个 Skill 放入完整的 kg-meeting-actions。只选择一种宿主:

实际使用方式本课入口
Claude Code 项目级C:\ai-practice\meeting-work\.claude\skills\kg-meeting-actions\SKILL.md
Codex 项目级C:\ai-practice\meeting-work\.agents\skills\kg-meeting-actions\SKILL.md

检查技能选择列表或加载记录里的实际来源。如果你是通过插件安装,或者来源在个人目录,不要假定操作上面的项目目录会改变那一份。先准确记录来源,必要时回到对应宿主安装课核对。

在自己的本地维护笔记写下:名称、宿主、项目、精确入口、取得日期、来源名称、当前用途、是否含脚本和外部连接。不要把密码或客户材料放进这份笔记。

本例来源写“开工科技原创会议待办教程”,不要写成某个开源仓库版本。来源记录是一条证据,不应为了显得完整而编造发布号。

2. 停止调用,再保存可恢复的旧副本

结束正在使用这个 Skill 的会话,确认没有由它发起的任务仍在运行。用文件资源管理器创建 C:\ai-practice\skill-backups\meeting-v1,把整个 kg-meeting-actions 文件夹复制到其中;先打开备份的入口,确认确实有完整内容。

备份要放在 .claude/skills.agents/skills 之外。仅把技能改名成 kg-meeting-actions-old 后留在发现目录中,宿主仍可能把它识别为另一个技能,不等于已经停用。

可以用 Get-FileHash -Algorithm SHA256 -LiteralPath '实际入口路径' 比较原入口和备份入口的校验值。把引号里的占位文字替换为刚核对的完整路径,分别执行;两者应一致。这个值用于检查副本字节是否相同,不证明来源可信,也不能代替阅读变更。

保留三组旧测试材料。没有旧输入与旧预期,就很难知道新版究竟修复了什么、又破坏了什么。

3. 先明确一个值得更新的新要求

本课新增的实际需求是:“决定要做一件事后,会议又明确取消,不能继续把它列成待办。”这不同于上一课的改期,也不同于两个说法没有解释的冲突。

把下面内容作为新增规则,添加在入口的“提取规则”第 8 条之后,其他部分保持不变:

9. 记录明确取消一项先前决定时,不再把它列为待办。
   在输出末尾的“已取消”部分保留事项与取消依据。
   “暂缓、等待确认”不等于取消;这种情况列入待确认问题,说明现有状态。

这是对本课原创文件的修改,不要求改上游第三方资源。添加前后比较正文,确认只增加这条规则,没有顺手修改名称、路径或自动调用策略。

真实下载包更新时同样先读变化:有没有新 scripts、外部服务配置或工具权限?原来只返回文本,新版是否要求自动发邮件?用途和费用边界改变,就不能把它当作普通错别字修复直接接受。

4. 用新增用例和旧用例一起测试

重开同一项目的新会话,明确调用 /kg-meeting-actions$kg-meeting-actions,附上:

会议开始决定:小林制作新版下载横幅,周五前完成。
会议结尾明确取消制作横幅,因为本轮不更换下载页。
另一项决定是更新使用说明;此项暂缓,等待需求确认,未取消。

人工教学预期:横幅不在已确定待办表中,进入“已取消”,依据为结尾的明确取消;更新说明进入待确认问题,并保留“暂缓、未取消”。不能把两项都简单写成“已取消”,也不能仍催小林周五交横幅。

再跑上一课的三组材料:确定与建议、负责人缺失、改期与冲突。新增取消规则不应导致普通任务消失,也不应把改期误判为取消。

本文提供的是预期,不冒充实际运行。你运行后把结果填到维护笔记;即使新用例通过,旧用例失败也应先保留旧版继续使用,而不是只看新增功能。

5. 怎样确认真的恢复了旧版

如果新版没有通过,先停止会话。将当前新版整个文件夹移到 C:\ai-practice\skill-backups\meeting-v2-failed 下保留,再把之前备份的旧文件夹复制回原先核对过的精确位置。移动前看清完整路径,只处理这一个技能文件夹,不选择整个 skills 目录。

这里使用文件管理器的复制、剪切和粘贴,不给“清空目录”的命令。若目标里已有同名内容,不要一路选择替换;先核对哪份是活动入口、哪份是备份,避免把唯一旧版覆盖掉。

恢复后检查入口校验值与 v1 备份一致,在新会话里再跑旧测试。仅在旧会话中说“现在请用旧版”,不能保证刚才加载的新指令已经退出上下文。

恢复文件也不会撤销此前生成的表格或已发送的消息。本课没有外部发送;真实工作若有外部结果,必须单独检查,不能靠回退 Skill 自动收回。

6. 不想再用时,先停用而不是直接删

手动安装的 Claude Code 项目技能,可以在停止相关会话后,将已确认的单个技能文件夹移到上面的外部备份位置,再重新开会话检查它不再被发现。个人层级或插件里的同名项可能仍存在,出现同名命令时要核对来源,不要继续删除别的未知目录。

Codex 除了同样的移出方式,也支持在个人 config.toml 中对精确入口设置禁用。下面仅适用于本课这个项目路径:

[[skills.config]]
path = 'C:/ai-practice/meeting-work/.agents/skills/kg-meeting-actions/SKILL.md'
enabled = false

这是 Codex 配置,不是 Claude Code 配置。修改配置前先保留副本;若已有同一路径的条目,编辑那一条,不重复追加,不用这三行覆盖整个配置文件。保存后按官方说明重启 Codex,再核对列表或禁用状态;若要恢复,修改对应条目为 enabled = true 并重启。

只想结束这次练习,用文件管理器移出更容易理解,不必为了停一个 Skill 学完整配置系统。无论采用哪种方式,停用后应以新会话验证,而不是要求旧会话忘记已经读过的内容。

7. 移除以后还需要保留什么

保留来源、旧版副本、测试输入和最后一次通过结果,便于未来恢复。文件夹本身没有必要立刻永久删除;确认不再需要时,只处理已经核实的单个备份,而不是批量清理全部技能。

之前花掉的模型额度、写出的文件和产生的外部任务不会随停用消失。如果曾把凭据放进共享文件,应到对应服务撤销或更换,删除那行文字不等于凭据已经安全。

能说明“现在用哪份、为什么换版、怎样验证、怎样恢复”,就完成了这次维护练习。下次选择本站资源时,继续用 安装前检查 先读来源、许可、依赖与动作范围,避免积累一批不知道来历也无法回退的技能。

文字来源:OpenAI 与 Anthropic 官方 Skill 文档;开工科技原创练习