Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

feat(context-budget): keep plugin skill descriptions visible when the skill listing overflows

未关闭
#6,458 4 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
28/100
Issue 类型
功能
描述清晰度
需要澄清
活跃度
活跃
技术栈
json, shell

调研方向

Start from the problem statement: skill listings are truncated by skillListingBudgetFraction and skillListingMaxDescChars (defaults and this repo's .claude/settings.json). Related issue #6093 covers measure-only /context-budget:audit. Do not implement until maintainers pick a fleet-wide budget, a plugin description cleanup (including disable-model-invocation), and whether the audit should list dropped skills. Done is those decisions plus the matching settings and listing behavior, not a one-file patch.

由索引模型根据 Issue 内容生成。

描述

needs-human needs-triage

Problem

The skill listing loaded at session start has a character budget: skillListingBudgetFraction, default 0.01 of the context window, with a per-skill cap set by skillListingMaxDescChars, default 1536 (https://code.claude.com/docs/en/settings-reference). When the listing goes over budget, descriptions are dropped. A dropped description means the model cannot tell when to invoke that skill.

Measured on 2026-10-05 with Claude Code 2.1.289, 30 headless runs on claude-haiku-4-5-20251001:

  • The listing overflowed in every run, even with every plugin disabled.
  • With a full melodic install, 317 of 329 skills lost their descriptions.
  • Turning plugins off saves almost no tokens, because overflowing descriptions are dropped anyway. The real per-session costs are agent listings, SessionStart hook text and MCP tool names.

The budget fraction is set inconsistently: 0.05 in this repo's .claude/settings.json, 0.03 in medley, and the default elsewhere.

Decide

  1. A fleet-wide skillListingBudgetFraction value, measured on Opus 5.5 and Fable 5.1 as well as Haiku. The budget scales with context size, so the overflow on a 1M-context model is unmeasured.
  2. A description cleanup across the melodic plugins:
    • shorter, sharper trigger text for model-invocable skills
    • disable-model-invocation on skills that only a person runs, so they leave the listing
  3. Whether /context-budget:audit should report listing overflow: which skills are dropped at a given budget.

Related: #6093 (measure-only audit mode). The plugin profiles design is the other lever: fewer active plugins per task.

🤖 Generated with Claude Code

主要语言
Shell
星标
22
派生
2
平均合并
5 小时 11 分钟
30 天内合并 PR
838

环境准备

  • 没有 Dockerfile 或 Docker Compose 文件
  • 没有 Pull Request 模板
  • 阅读贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

melodic-software/claude-code-plugins 的其他 Issue

查看 melodic-software/claude-code-plugins 的全部 Issue

相似的 Issue

更多 Shell/Bash Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。