现象
新版本 Claude Code 对话框右下角打开后提示:
5 skill descriptions dropped
输入 /doctor 命令后,能看到完整说明:
Skill listing will be truncated
5 descriptions dropped (full descriptions kept for most-used skills) (1.1%/1% of context):
superpowers:receiving-code-review, codex:gpt-5-4-prompting, codex:codex-cli-runtime, +2 more
run /skills to disable some, or raise skillListingBudgetFraction (currently 1%) in settings.json
Opting in would cost ~2k tokens for skills every session and uses rate limits faster含义与影响
这个提示的意思是:Claude Code 发现你的 skills 太多,所有 skill 的 description 加起来超过了默认上下文预算,所以它把一部分”不常用 skill”的描述丢掉了。
影响:
- skill 还在
/skills仍能看到- 仍能通过显式指定 skill 名字来调用
- 但 Claude 自动判断”什么时候该用这个 skill”的能力会下降
- 被 drop description 的 skill 可能更难被自动触发
- 常用 skill 会优先保留完整描述
提高上限
编辑 ~/.claude/settings.json:
{
"skillListingBudgetFraction": 0.02,
"skillListingMaxDescChars": 2048
}skillListingBudgetFraction:将全部 skills 元数据限制在上下文窗口的该比例内,超出范围的技能将完全失去其描述。0.02⇒ 2%skillListingMaxDescChars:每项技能描述的字符限制,超过此长度的描述将被截断