Git 暂存操作可能影响 Claude 技能恢复
作者在运行中的无头 Claude Code 会话下测试暂存与恢复:整个 .claude 目录被移除后,2.1.319 在恢复后 29 秒仍无法识别技能,2.1.322 在 15 秒检查时已恢复。仅移除新增技能目录时,两版均在 15 秒检查时恢复;每种情况各测试两次。
AI 深度解读
git stash pop 已经把文件放回磁盘,正在运行的 Claude Code 仍可能报 Unknown skill。作者做了 6 轮实验,发现版本差异只在整个 .claude 目录消失过时出现。2.1.319 在恢复文件 29 秒后仍找不到 skill 和 command,2.1.322 在第 15 秒检查时已经能调用。
如果你让多个 AI 编程会话共用一份 checkout,或者在脚本里刚恢复改动就调用项目 skill,这组实验能帮你区分两件事。文件什么时候回来,会话又是什么时候重新认出它的。
为什么暂存几份改动会让整个目录消失
作者团队让多个 Claude Code 会话及其子代理共用一个 Git checkout,没用 worktree。一个会话还在写 skill,另一个会话就可能已经开始处理 rebase 冲突。按他们团队的约定,遇到需要手动解决的冲突,先用 git stash push -- <their paths> 暂存其他会话的改动,解决完再用 git stash pop 恢复。正在编写的新 skill 可能因此从磁盘上消失一两分钟。
Claude Code 文档说,项目的 .claude/skills/ 会被监听,当前会话能直接感知变化。2.1.321 的更新日志提到,它修复了项目 skills、commands 和 agents 所在目录被移除又恢复后,这些条目仍然缺失的问题,并用 git stash 举例。2.1.320 没有发布到 npm,所以作者拿修复前最后一个已发布版本 2.1.319,和修复后的 2.1.322 做对比。
实验的关键是把目录结构分成两种。第一种里,.claude 下没有任何已提交文件,所有测试文件都已暂存、尚未提交,执行 git stash push -- .claude 后,整个 .claude 从工作区消失。第二种里,.claude/skills、.claude/commands 和 .claude/agents 各有一个已提交文件,同一条命令只会移走新加的测试条目,父目录一直留在磁盘上。两种情况下 git stash pop 都能恢复测试文件,区别在于会话是否经历过父目录消失。
两个版本的差异出现在第几秒
每轮从一个只有 README 和测试文件的临时 Git 仓库开始,用 Sonnet 5.5 跑一个 claude -p 无交互会话,只读项目设置,工具限于 Skill、Bash 和 Agent。测试文件包括 5 个正文为固定回复指令的 SKILL.md(probe-a 到 probe-e)、5 个自定义命令(cmd-a 到 cmd-e),以及一个固定回复的 stash-agent。
每轮按固定顺序执行 20 步,在暂存前、暂存期间、恢复后立即、再等 10 秒和再等 10 秒分别发起检查。每个 skill 和 command 在同一轮只调用一次,避免下一次检查命中会话已经加载过的定义。作者用 git stash pop 对应的 Bash 调用返回时间作为计时起点。每个版本跑 2 轮整目录消失、1 轮父目录保留,共 6 轮。
- 整个
.claude消失时,2.1.319两轮都在第 29 秒报Unknown skill。此前的ls和git status已经列出了恢复的文件。2.1.322两轮都在第 1 秒失败,到第 15 秒检查时已返回Launching skill。 - 父目录始终存在时,两个版本都在第 15 秒检查时恢复。在全部 6 轮里,自定义 command 和同一检查点的 skill 同步成功或失败,恢复后的首次检查全部失败。


虽然步骤写的是等待 10 秒,实际检查点还隔着其他工具调用,前两个检查点相隔约 14 秒。2.1.322 的结果只能把恢复时间夹在第 1 秒检查失败和第 15 秒检查成功之间。作者还遇到两个复跑细节。全局 gitignore 忽略了 .claude,普通的 git add .claude 没把测试文件加进去,得用 git add -f。2.1.322 的 Bash 工具拒绝了单独运行的 sleep 30,接受了 sleep 10; git status --short。
为什么 agent 文件没了还能启动
6 轮共发起 30 次 Agent 调用,每次都成功启动 stash-agent。作者还检查了子代理自己的会话记录,确认每次都给出了 agent 文件指定的固定回复。其中有 6 次发生在暂存期间,当时 .claude/agents/stash-agent.md 确实已经不在磁盘上。
在这批 claude -p 会话里,启动时加载的 agent 定义在文件删除后仍可使用。对共享 checkout 来说,临时移走文件没有打断这项能力。反过来,如果你删除文件是为了让正在运行的会话停止使用旧定义,这个操作在实验里没有达到目的。更新日志也提到了 agents,但作者没有检查交互式菜单,结论只覆盖这批会话里的 Agent 工具调用。
我的判断
这组测试最有说服力的地方,是把磁盘状态和工具调用结果都记录了下来。普通代码文件恢复后,下次读取就能看到内容。项目 skill 还要等 Claude Code 重新发现,git status 正常只证明了前一步。因此,脚本里如果把 git stash pop 成功当成下一步可以调用 skill 的信号,升级到 2.1.322 之后仍然可能踩到那段空窗。
作者团队自己的仓库已经提交了 skill,日常暂存新 skill 更接近父目录保留的实验,两版在这个场景都恢复了。刚开始搭建 .claude 的仓库,或者用 git stash --include-untracked 暂存尚未跟踪的配置,更可能碰到整目录消失。作者还举了切到没有 .claude 的分支再切回的例子,这个路径没有实测。单独移走整个 .claude/skills 也没有作为独立场景跑过。
每版只有 3 轮,模型、仓库规模和运行机器也有限。旧版的记录只能说明最后一次检查仍失败,无法判断继续等多久会恢复。固定睡 15 秒实现起来简单,但会把一次实验的采样点当成所有环境的等待阈值。带上限地检查 skill 是否真的可用,更贴近脚本所依赖的条件。若团队的问题是多个会话频繁改动同一份工作区,分开 checkout 或使用 worktree 可以减少彼此暂存文件的机会,但原文没有做 worktree 的对照实验。
能拿来做什么
- 如果你的 Node 或 Shell 脚本会在
git stash pop后调用 Claude Code 的项目 skill,把恢复文件和调用 skill 拆成两步。遇到Unknown skill时做有上限的短间隔重试,并记录版本和报错。对于有副作用的 skill,只在确认尚未启动时重试。 - 排查时同时记录 Claude Code 版本和消失的目录层级。用
ls或git status --short确认磁盘已恢复,再检查会话是否识别条目。交互式会话里可以把/reload-skills作为一次排查尝试,作者没有验证它能否修复这次暂存引发的问题。 - 如果你删除或改写 agent 文件是为了让自动化改用新定义,用一个新
claude -p会话验证实际行为。旧会话在这组实验里仍能调用已经删掉的定义。