矽基前沿 [Si]gnals
資訊圖：暖紙底。上方一條橫貫的灰色量尺，最左端切出一小截藍色窄片，標題「skill 清單的預算」，引線拉出「模型 context window 的 1%」。下方一張紙卡清單五列，左側是墨色的 skill 名稱方塊，右側描述欄：上兩列畫滿細灰線並標「常用的：描述保留」，下三列只剩開頭一小段線、其餘以虛線框表示被截斷並標「最少用的：描述被削掉」，旁邊小字「名字還在，關鍵字沒了」。卡片右下角一枚藍色描邊徽章以等寬字體寫「/skill-doctor」，其下小字「列出從來沒被叫過的那幾個」。
工作現場

Claude Code 新指令，列出你從來沒叫過的 skill

裝太多，最少用的那幾個會先被削掉描述

署名矽基前沿 · 工作現場線編輯廖玄同
新聞AI Coding 工作流企業 Agent StackAnthropic

你這半年在 Claude Code 裡陸陸續續裝的那些 skill，有幾個是真的被叫用過的？

Claude Code 的官方文件寫著一件多數人不知道的事：所有 skill 的名稱與描述會被載進 context，讓模型知道有哪些東西可用，而那份清單有預算——模型 context window 的 1%。清單塞不下的時候，Claude Code 從你最少叫用的 skill 開始砍描述，讓常用的保住全文。官方接著寫明，這個動作「可能把 Claude 用來比對你的請求的關鍵字一起砍掉」。

所以裝太多的代價不只是多花錢。名稱永遠留著，描述會先被削——而被削的，正好是那些你很少用、但真的需要的時候希望它跳出來的 skill。它不會報錯，只是安靜地不被觸發。

9 月 4 日的 2.1.261 版加了一個指令來查這件事。/skill-doctor 列出這場對話裡的 skill 各花多少 context、被叫用過幾次，標出從來沒被叫過的那幾個，並告訴你去哪裡關掉它們，順便列出你最近沒用過的 plugin。內建 skill 與企業 skill 不在報告範圍內。互動模式下報告開在 /plugin 管理員的 Stats 分頁，-p 的非互動模式直接印成文字。

有兩個限制先講。它要 2.1.252 以上，而我今天查 npm，latest 是 2.1.263、stable 還停在 2.1.236——走 stable 通道的人現在打這個指令是沒有的。它也不吃 Remote Control，從手機或瀏覽器連過去會回一句 Skill usage reports are not available on this connection.，得在跑那場對話的那台機器的終端機裡打。

今天可以做的三件事：claude --version 看自己在哪個版本；跑得動就跑一次 /skill-doctor，把從來沒被叫過的關掉；捨不得關的，在 skillOverrides 裡設成 name-only，它就只留名字、不佔描述的預算。預算本身也調得動——skillListingBudgetFraction 設 0.02 就是 2%，但那一格是從別的東西手上搶來的，不是變出來的。

Agent Skills 是什麼那篇講的是它怎麼運作，這一則講的是裝多了會怎樣。跟思考強度那一格是同一個形狀：你沒設定的地方都有預設值，而預設值正在替你做決定。

查核備註：本篇是對 Claude Code 官方 changelog 與官方文件的檢視。版本通道那兩個數字是我今天用 npm view 讀到的當下值，會變。我沒有實際跑過 /skill-doctor——我這台機器上的 Claude Code 是 2.1.220，比它要求的 2.1.252 還低；清單預算滿了之後描述被削到什麼程度，我也沒有實測，那是官方文件的說法。

LEARN

想系統性學會,不只看這一則?

Claude Code 教學：用終端 AI Agent 完成真正的工作

讓 Claude Code 在你的專案裡完成一個真實任務，而且控得住權限、驗得了 diff、管得住成本。

從第 0 課開始 →

SOURCES

  1. AClaude Code changelog — 官方版本紀錄（2.1.261，2026-09-04：新增 `/skill-doctor`，顯示哪些已載入的 skill 沒被用到、以及它們花掉多少 context；2026-09-07 讀）
  2. AExtend Claude with skills — Claude Code 官方文件（skill 清單載入 context、預算為 context window 的 1%、溢出時從最少叫用者開始丟描述並可能削掉關鍵字、1,536 字元描述上限、`skillOverrides` 的 name-only、`skillListingBudgetFraction`、`/skill-doctor` 的版本需求與 Remote Control 限制；2026-09-07 讀）
  3. ASlash commands — Claude Code 官方文件（`/skill-doctor` 的報告內容與輸出位置：互動模式開在 /plugin 管理員 Stats 分頁、-p 非互動模式印成文字；2026-09-07 讀）
  4. Anpm registry — @anthropic-ai/claude-code dist-tags（2026-09-07 以 `npm view` 讀取：latest 2.1.263、stable 2.1.236）

來源分級:A = 一手公告/論文/官方文件 · B = 可信媒體 · C = 可參考但需脈絡 · D = 觀察用，不可當事實。

本文由 AI 協助研究，矽基前沿編輯部撰稿，總編輯廖玄同審閱定稿。 編輯方針與 AI 使用說明

CONTINUE READING

繼續讀

編輯部從相同 beat 與主題挑出最可能讓你接著看的三篇。

WEEKLY [SI]GNALS

訂閱《矽基前沿週報》

每週五早上，把本週 AI 與算力產業最值得記住的變化連回台灣。

本週關鍵訊號 · 為什麼值得記住 · 下週觀察 · 5 分鐘讀完。

免費 · 隨時取消 · 不轉售你的 email。

MACHINE-READABLE SUMMARY

Topic
工作現場
Key claims
  • Claude Code 官方文件載明，skill 的名稱與描述會被載入 context，該清單的字元預算為模型 context window 的 1%；清單溢出時系統從最少被叫用的 skill 開始丟棄描述，官方明寫這可能把 Claude 用來比對使用者請求的關鍵字一併削去。
  • Claude Code 2.1.261（官方 changelog 標示 2026-09-04）新增 `/skill-doctor`，顯示各 skill 的 context 成本與使用次數、標出從未被叫用者並指出關閉位置，另列出近期未使用的 plugin；報告不涵蓋內建 skill 與企業 skill。
  • 官方文件載明 `/skill-doctor` 需要 Claude Code v2.1.252 以上，且不支援 Remote Control 連線——從手機或瀏覽器連過去會回覆 `Skill usage reports are not available on this connection.`，須在執行該對話的機器終端機中執行。
  • 2026-09-07 查 npm，`@anthropic-ai/claude-code` 的 `latest` 為 2.1.263、`stable` 為 2.1.236，stable 通道低於 `/skill-doctor` 所需的 2.1.252。
  • 官方文件提供兩個調節方式：在 `skillOverrides` 把低優先的條目設為 `name-only`，該 skill 只列名稱不列描述；`skillListingBudgetFraction` 可調高清單預算比例（例如 0.02 即 2%）。
Entities
Claude Code · Agent Skills · skill-doctor · skillOverrides · skillListingBudgetFraction · Anthropic
Taiwan relevance
medium
Confidence
high
Last updated
2026-09-07
Canonical URL
https://signals.tw/articles/claude-code-skill-listing-budget-skill-doctor/

SUGGESTED CITATION

如果 AI agent / 研究 / 報導要引用本文,建議格式如下:

矽基前沿 · 工作現場線（編輯：廖玄同），《Claude Code 新指令，列出你從來沒叫過的 skill》，矽基前沿 [Si]gnals，2026-09-07。https://signals.tw/articles/claude-code-skill-listing-budget-skill-doctor/

AI agents / search engines may quote, summarize, and cite with attribution and a link back to the canonical URL above. See /for-ai-agents for full policy.