Model-Specific Behavioral Patch (claude)

Model-Specific Behavioral Patch (claude)

The following nudges are tuned for the claude model family. They are subordinate to skill workflow, STOP points, AskUserQuestion gates, plan-mode safety, and /ship review gates. If a nudge below conflicts with skill instructions, the skill wins. Treat these as preferences, not rules.

Todo-list discipline. ...（以下即 claude.md 原文）

文件头注释特别强调：这段"从属"措辞是包装器标题的一部分，**与覆写文件内容无关，每个覆写都会携带**。这保证了即使用户自行编辑 claude.md 加入激进措辞，生成文档中的行为补丁仍被声明为"偏好而非规则"，且永远让位于 Skill 工作流、STOP 点、AskUserQuestion 门控和 /ship 审查门。唯一的例外是 `gpt-5.6-sol`，它在 [scripts/resolvers/model-overlay.ts](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/scripts/resolvers/model-overlay.ts?utm_source=gitcode_repo_files#L52-L59) 走了一段不同的 scope 消歧声明——从源码结构看，这个特判说明包装器的从属语义可以按模型定制。

### 注入位置：preamble 组合根

注入发生在 [scripts/resolvers/preamble.ts](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/scripts/resolvers/preamble.ts?utm_source=gitcode_repo_files) 的 `generatePreamble()` 中，`generateModelOverlay(ctx)` 的调用位于 [scripts/resolvers/preamble.ts](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/scripts/resolvers/preamble.ts?utm_source=gitcode_repo_files#L114)。两个细节值得强调：

- **不受 tier 门控**：preamble 分为 1-4 层（tier 2+ 才渲染 AskUserFormat、completeness 等区块），但 `generateModelOverlay` 在 L114 无条件调用——无论 Skill 声明 `preamble-tier: 1` 还是 4，只要 `ctx.model` 有值，行为补丁都会出现；
- **渲染顺序是有意设计的**：[scripts/resolvers/preamble.ts](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/scripts/resolvers/preamble.ts?utm_source=gitcode_repo_files#L108-L111) 的注释说明，AskUserQuestion Format 必须渲染在模型覆写**之前**，让"一次一个问题"的节奏规则先成为环境默认值，覆写提示再以从属补丁形式落位——注释明确提到 Opus 4.7 从上往下读、会吸收遇到的第一条节奏指令，颠倒顺序曾导致 plan-review 节奏回归（v1.6.4.0 的 bug）。

### 运行时可见性：MODEL_OVERLAY 标识

生成的 Skill 文档中会显式声明当前生效的覆写。例如仓库根目录的 [SKILL.md](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/SKILL.md?utm_source=gitcode_repo_files#L78-L94) 中就完整呈现了 `## Model-Specific Behavioral Patch (claude)` 段落及其三条规则；所有技能目录下的生成产物（[browse/SKILL.md](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/browse/SKILL.md?utm_source=gitcode_repo_files)、[autoplan/SKILL.md](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/autoplan/SKILL.md?utm_source=gitcode_repo_files) 等）同样带有该段落。运行时还有一条机器可读的标识：[scripts/resolvers/preamble/generate-preamble-bash.ts](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/scripts/resolvers/preamble/generate-preamble-bash.ts?utm_source=gitcode_repo_files#L114) 生成 `echo "MODEL_OVERLAY: ${ctx.model ?? 'none'}"`，配合 [bin/gstack-skill-start](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/bin/gstack-skill-start?utm_source=gitcode_repo_files) 中 `--model` 参数的解析（L38 初始化 `MODEL_OVERLAY="none"`，L169 输出），使得每次 skill-start 都会把实际生效的覆写模型打印到 preamble 输出中，用户无需反查即可确认"补丁是否激活"。CHANGELOG 对这一机制的原始描述是："Overlay files are plain markdown — edit in place, no code changes. `MODEL_OVERLAY: {model}` prints in the preamble output so you know which one is active."（见 [CHANGELOG.md](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/CHANGELOG.md?utm_source=gitcode_repo_files#L7329)）

## 三、继承体系：claude.md 是整个 Claude 家族覆写的基座

当前 [model-overlays/](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/model-overlays/?utm_source=gitcode_repo_files) 目录共维护 10 个覆写文件：`claude.md`、`opus-4-7.md`、`opus-4-8.md`、`sonnet-5.md`、`fable-5.md`、`gpt.md`、`gpt-5.4.md`、`gpt-5.6-sol.md`、`gemini.md`、`o-series.md`。其中 Claude 家族内部形成了以 claude.md 为根的继承树：

- [model-overlays/opus-4-7.md](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/model-overlays/opus-4-7.md?utm_source=gitcode_repo_files)、[model-overlays/opus-4-8.md](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/model-overlays/opus-4-8.md?utm_source=gitcode_repo_files)、[model-overlays/fable-5.md](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/model-overlays/fable-5.md?utm_source=gitcode_repo_files)、[model-overlays/sonnet-5.md](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/model-overlays/sonnet-5.md?utm_source=gitcode_repo_files) 均以 `{{INHERIT:claude}}` 开头，先获得三条基础规则，再叠加版本专属提示。例如 [model-overlays/fable-5.md](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/model-overlays/fable-5.md?utm_source=gitcode_repo_files) 在基座上追加了 "Act when you have enough to act"（防止过度规划）、"Ground progress claims in evidence"（进展声明必须能对应到工具结果）、"Assessment vs action"（评估与行动的边界）四条 Fable 家族提示；[model-overlays/opus-4-7.md](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/model-overlays/opus-4-7.md?utm_source=gitcode_repo_files) 则追加了 "Effort-match the step"、"Pace questions to the skill"、"Literal interpretation awareness" 等针对 Opus 4.7 的调教；
- 非 Claude 家族走独立的继承链：[model-overlays/gpt-5.4.md](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/model-overlays/gpt-5.4.md?utm_source=gitcode_repo_files) 按解析器头部注释的设计"build on top of `gpt.md` without duplication"，继承自 [model-overlays/gpt.md](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/model-overlays/gpt.md?utm_source=gitcode_repo_files)。

这套继承机制有专门的测试守护。以 [test/model-overlay-fable-5.test.ts](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/test/model-overlay-fable-5.test.ts?utm_source=gitcode_repo_files) 为例，它验证了四个断言：

1. 原始 `fable-5.md` 包含 "Act when you have enough to act"；
2. 经 `generateModelOverlay(makeCtx('fable-5'))` 解析后的输出**同时**包含来自 claude 基座的 "Todo-list discipline" 和 Fable 专属提示——即继承确实拼接成功；
3. 解析输出中不存在未解析的 `{{INHERIT:` 残留；
4. **负向断言**：直接解析 `claude` 覆写时输出**不**包含 "Act when you have enough to act"——保证基座保持纯净，版本提示不泄漏回基础层。

同系列还有 [test/model-overlay-opus-4-7.test.ts](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/test/model-overlay-opus-4-7.test.ts?utm_source=gitcode_repo_files)、[test/model-overlay-opus-4-8.test.ts](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/test/model-overlay-opus-4-8.test.ts?utm_source=gitcode_repo_files)、[test/model-overlay-sonnet-5.test.ts](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/test/model-overlay-sonnet-5.test.ts?utm_source=gitcode_repo_files)、[test/model-overlay-gpt-5.6-sol.test.ts](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/test/model-overlay-gpt-5.6-sol.test.ts?utm_source=gitcode_repo_files) 等测试文件，各自对"家族提示在位 + 继承拼接 + 无残留指令"做门控断言。此外 [scripts/preflight-agent-sdk.ts](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/scripts/preflight-agent-sdk.ts?utm_source=gitcode_repo_files) 也直接复用 `readOverlay` 来解析 `{{INHERIT:claude}}`，说明该继承语义在 agent SDK 预检路径中同样生效。

## 四、模型分类学：--model 如何映射到 claude.md

覆写选择的入口是模型分类模块 [scripts/models.ts](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/scripts/models.ts?utm_source=gitcode_repo_files)。它定义了两件事：

**模型家族全集**（[scripts/models.ts](https://gitcode.com/GitHub_Trending/gs/gstack/blob/9da6692930db209e8632e8da3d5e5b5995d8af9c/scripts/models.ts?utm_source=gitcode_repo_files#L18-L29)）：

```typescript
export const ALL_MODEL_NAMES = [
  'claude', 'opus-4-7', 'fable-5', 'opus-4-8', 'sonnet-5',
  'gpt', 'gpt-5.4', 'gpt-5.6-sol', 'gemini', 'o-series',
] as const;