Allow opting out of model invocation for installed skills (large monorepo skill-budget pain)
- 主要语言
- Python
- 星标
- 137k
- 派生
- 12.3k
- 平均合并
- 2 天 12 小时
- 30 天内合并 PR
- 159
描述
## Problem
Since v0.8.4 ([PR #2099](https://github.com/github/spec-kit/pull/2099), closing [#2098](https://github.com/github/spec-kit/issues/2098)), `specify init --ai claude` writes `disable-model-invocation: false` on every generated SKILL.md, and the toggle was removed as "redundant" because the new default opts skills into auto-invocation. There is no opt-out flag.
This is a real problem in large monorepos that already register many domain skills. Claude Code reserves a small fraction of context for the skill-listing budget; when that budget is exhausted, lower-priority skills get truncated and Claude loses visibility on them entirely. Adding the 11 spec-kit skills as model-invocable pushes us over the limit and silently drops other skills we use far more often.
Two specific pain points:
1. **Skill-listing budget exhaustion.** With ~50 skills already in play (CI helpers, MR workflows, service tooling, etc.), the spec-kit 11 push us past the default `skillListingBudgetFraction`. The cheapest fix is to make spec-kit skills user-invocable only, so they cost nothing in the listing.
2. **Over-triggering on generic prompts.** Several spec-kit skill descriptions (`speckit-implement`, `speckit-tasks`, `speckit-plan`) are generic enough that Claude auto-invokes them on prompts that have nothing to do with SDD — e.g. someone asking to "implement" or "plan" something unrelated.
## Workaround
We've patched our internally bundled copy to set `disable-model-invocation: true` on all 11 skills. But every fresh `specify init` reverts this, so we either lose the fix on upgrade or have to maintain a long-running patch.
## Proposal
Add a `--no-model-invocation` flag to `specify init` (and persist to the init-options file) that emits `disable-model-invocation: true` in generated SKILL.md frontmatter. Default behaviour stays as-is (model-invocable). Opt-in users get manual `/speckit.*` invocation only.
Alternatively, a per-skill override in a config file would also solve it.
Happy to send a PR if the direction is welcome.
贡献指南
调研方向
从 `specify init` 命令开始,检查它如何写入 init-options 文件以及生成的 `SKILL.md` frontmatter。跟踪现有的 `disable-model-invocation` 处理逻辑,然后验证 `--no-model-invocation` 是否会持久化,并为全部 11 个 skill 输出 `disable-model-invocation: true`,同时保持默认行为不变。
由索引模型根据 Issue 内容生成。
评估
- 技术栈
- python
- 领域
- ai, cli
- Issue 类型
- 功能
- 难度
- 3/5
- 预计耗时
- 1-2 天
- 活跃度
- 活跃
- 描述清晰度
- 基本清楚
- 新手友好度
- 68/100