技能目录被截断:先禁用,再调 skills.max_context_tokens
启动时只塞技能名和描述,默认大约是模型窗口的 2%。显式值上限 10000。装太多时先 [[skills.config]] 关掉不用的,不要先把预算拉满。
/skills 里缺技能、或启动警告说目录被截断时,先关掉不用的,不要先加大窗口:
[[skills.config]]
path = "/home/you/.agents/skills/noisy/SKILL.md"
enabled = false
[skills]
max_context_tokens = 8000
skills.max_context_tokens 管的是可用技能目录(name / description)进提示的预算,不是选中之后整份 SKILL.md。默认大约是当前模型上下文窗口的 2%;你写了正整数才会覆盖,且官方把显式值封顶在 10000。窗口未知时,技能页还提过大约 8000 字符的回退,不要把两种单位抄成一件事。
max_context_tokens 属于 [skills] 表。写进 [[skills.config]] 某一条里不会当目录预算。改完必须重启 Codex。
2026 年 7 月有文章还写「2% 写死、调不了」。8 月的 PR 已经加了这个键,不要再照抄那段。目录再大,模型选中技能后仍会读完整说明;真正省上下文的办法是少装、短 description、关掉不用的技能。