同一个 git stash pop 动作,两个版本给出了完全不同的答案。在无头 Claude Code 会话里跑完 stash 再 pop,2.1.319 在 pop 之后 29 秒的检查中仍然对探测用的技能和命令回一句“Unknown skill”,两次运行都是如此;2.1.322 则在 15 秒的检查点之前就把它们找了回来,同样是两次运行都恢复。
这个差距只在一种情况下出现:整个 .claude 文件夹从磁盘上消失又被重建。如果只是新技能自己的文件夹没了、.claude/skills 本身还在,两个版本都能在 15 秒检查前恢复。
为什么一个正在运行的会话会碰上 stash?几个 Claude Code 会话和它们的子代理共用一个 git 检出,又不用 worktree,于是一个会话还在跑一轮对话,另一个会话已经在同一个文件夹里敲 git 命令。真正让人担心的是冲突处理:仓库规则要求,当 rebase 冲突需要手工解决、而其他会话在树里还有未提交改动时,先把这些改动用 git stash push -- 挪开,冲突解决后再用 git stash pop 放回来。如果这些未提交改动里有一个别的会话正在写的新技能,stash 就会把它的文件夹从磁盘上删掉一两分钟,而拥有它的会话还在运行。
Claude Code 文档的技能页面说,项目的 .claude/skills/ 文件夹是被监视的,Claude Code“在当前会话内就会拾取变化,无需重启”。2.1.321 的更新日志里正好有一条对应这个担忧:项目技能、命令和代理“在其文件夹于会话中途被移除又回来后仍然缺失”,并把 git stash 作为例子。更新日志只能说明 bug 存在过,说不清空窗有多长、哪个文件夹必须消失、代理是否和技能一样。于是有了这组测量。
怎么测的
每次运行都在一个临时文件夹里新建 git 仓库,里面只有一个 README 和若干探测文件:五个技能 probe-a 到 probe-e,每个是一份只要求固定回复的 SKILL.md;五个命令 cmd-a 到 cmd-e,放在 .claude/commands/ 下;一个代理 stash-agent,放在 .claude/agents/ 下,整个提示词就是一句固定回复。每个技能和命令在一次运行中只调用一次——如果同一个技能检查两次,第二次可能由会话已加载的内容作答,测到的就是会话记忆而不是文件夹。
用了两种布局。整体布局里,.claude 下没有任何东西被提交,所有探测文件都已暂存但未提交,于是 git stash push -- .claude 把整个 .claude 文件夹删掉,pop 再把它重建。叶子布局里,.claude/skills、.claude/commands 和 .claude/agents 各自已有一个提交过的文件,只有探测文件是新的,stash 只删掉探测技能自己的文件夹和探测文件,父文件夹留在磁盘上。
每次运行是一个无头 claude -p 会话,主模型 Sonnet 5.5,只读项目自己的设置,工具限于 Skill、Bash 和 Agent。提示词按固定顺序列了 20 步:检查 probe-a、cmd-a 和代理;执行 git stash push -- .claude 后等 10 秒;检查 probe-b、cmd-b 和代理;执行 git stash pop 后立刻检查 probe-c、cmd-c 和代理;再等 10 秒检查 probe-d、cmd-d 和代理;再等 10 秒检查 probe-e、cmd-e 和代理。技能或命令检查就是一次 Skill 工具调用,要么返回“Launching skill”,要么以“Unknown skill”失败。代理检查是一次 Agent 工具调用,之后读子代理自己的记录,看它是否带着代理的提示词运行。所有时间都取自会话记录里的时间戳,从 pop 的 Bash 调用返回那一刻算起。
对比的是 2.1.319 和 2.1.322。修复列在 2.1.321 名下,而 2.1.320 从未发布到 npm,所以 2.1.319 是修复前最后一个版本。两个版本都用机器上已有的二进制运行。整体布局每个版本跑两次,叶子布局每个版本跑一次,共六次。
第一次尝试有两个坑值得记下。机器的全局 gitignore 列了 .claude,所以普通的 git add .claude 会静默跳过所有探测文件,stash 也就没东西可删,得用 git add -f 暂存。另外 Bash 工具在 2.1.322 会话里拒绝了单独一条 sleep 30,提示改用轮询循环;sleep 10; git status --short 能通过,所以每次等待是 10 秒。
看到了什么
命令的表现和技能完全一致:.claude/commands/ 里的命令文件消失和回来,与它旁边的技能在同一个检查点。
2.1.319 加整体布局,技能和命令在观察期内再没回来。两次运行中最后一次技能检查都在 pop 之后 29 秒,仍然以“Unknown skill”失败,尽管前几步的 ls 和 git status 已经列出了所有文件。2.1.322 同样布局,两次运行都在 1 秒检查与 15 秒检查之间恢复。
pop 之后紧接着的那次检查,所有运行、两个版本、两种布局全部失败。即便是修好的版本,会话也需要一点时间才能注意到文件回来了。检查间隔约 14 秒,所以只能说 2.1.322 上的空窗大于 1 秒、小于 15 秒。
代理是意外。六次运行共 30 次 Agent 调用,全部启动了 stash-agent,每一个子代理都用代理文件里的固定回复作答——包括 stash 期间的六次调用,那时 .claude/agents/stash-agent.md 根本不在磁盘上。在这些无头会话里,两个版本上,启动时加载的代理定义在其文件被删除后依然可用。
共用检出意味着什么
两个版本的差别只在整体布局出现,也就是父文件夹本身消失的时候。如果只是技能自己的文件夹走了又回来,2.1.319 在 15 秒检查前就已经重新拾取。所以旧版本上的风险比更新日志那句话听起来要窄:是整个 .claude 文件夹、或整个 .claude/skills 文件夹离开磁盘的那种情况。
在自家仓库里,.claude/skills 放的是已提交的技能,stash 只会删掉新技能自己的文件夹,也就是叶子布局,两个版本都能恢复。整体布局对应的是 .claude 下什么都没提交的仓库:比如 .claude 是新的、还没提交,又被 git stash --include-untracked 收走;或者切到一个没有 .claude 文件夹的分支再切回来。这里只测了 stash,没测分支切换。
三次运行得出三个实用结论:
- git stash pop 之后别马上调技能。pop 后一秒做的检查在两个版本上全部失败,脚本如果 pop 完立刻跑技能,即便在 2.1.322 上也可能拿到“Unknown skill”。
- 在 2.1.321 之前的版本上,如果整个文件夹消失,等待没用。运行中 30 秒内什么都没回来。文档提到 /reload-skills 用于会话启动时就不存在的技能文件夹,交互式会话里这是第一个会试的办法,但没有测,因为运行都是无头的。
- 被删掉的代理仍能被启动。对 stash 来说这很方便,代理在文件不在时照常工作;这也意味着会话中途删掉代理文件,不会阻止一个正在运行的无头会话使用它。更新日志那条也点了代理,交互式菜单可能表现不同,这里只测了 claude -p 会话里的 Agent 工具。
没测的部分
每个版本三次运行,足以看出一致的模式,但不足以排除机器之间的时序差异。所有运行都用 Sonnet 5.5 作主模型,仓库是一个很小的临时仓库。没有测在 worktree 里启动的会话——更新日志那条也提到 worktree,而自家仓库不用它。没有测 ~/.claude/skills 下的技能,也没测用 --add-dir 添加的文件夹。探测检查间隔 14 秒,所以 2.1.322 的恢复时间是一个区间,不是一个数。
热门跟贴