用途
model-adaptation 是工具包中专门处理“底层 Claude 模型更换时，提示词、技能和 Agent 脚手架应如何变化”的技能，当前关注 Claude 5 系列（Fable 5、Mythos 5）接替 Opus 4.x 的迁移场景。它只负责提供建议与审计，不负责构建内容。作者规范部分由 skill-writer / skill-review 执行，长时运行部分由 loop-controller 执行，多智能体部分由 orchestrator 执行；本技能集中存放“为什么”和迁移清单，使这些执行点保持同步。
资料指出，模型适配类指导容易过时：它只相对于某一代模型成立，横跨所有技能，且没有天然归属，因此容易变成零散旁注并在新模型发布后失效。该技能作为唯一归属点，新模型到来时只需更新一张景观表并重跑迁移审计。记录来源为 Anthropic 的 Prompting Claude Fable 5 与 Prompting best practices，新模型代际发布时应重新抓取并更新。
核心主张：能力跃升意味着删减而非增加
面对更强模型，反射式做法是写更多指导，但资料认为这通常错误。为较弱模型编写的技能是围绕其失败模式铸成的“模具”，包含逐条列举的 do/don't、刚性模板、反懒惰提醒、“展示你的工作”等指令。更强模型失败模式更少，这些模具反而形成约束，Anthropic 将其测量为输出质量的真实下降。因此迁移主要是做减法：简短指令加原因胜过枚举；某些旧指令现在会适得其反，例如要求模型复述或解释内部推理可能触发 Claude 5 系列的 reasoning_extraction 拒答，并静默提升 fallback 到 Opus；应先信任默认行为，只在实测需要时加回脚手架。
能力范围与模式目录
技能内容按三个桶组织：
- Bucket A 授权卫生（在 skill-writer / skill-review 中执行）：包括删除过度规定、避免推理抽取拒答、简短指令优于枚举、给出原因而非仅给要求。特别区分：frontmatter description 的“pushy / over-enumerate”风格适合触发槽，但不适合技能正文的行为指令。
- Bucket B 长时运行 Agent（在 loop-controller 中执行）：包括默认更长回合、以实际工具结果佐证进度声明、不要在承诺中结束回合、不要向模型展示原始 token 预算倒计时、使用新鲜上下文验证器、提供 send_to_user 工具、以 effort 作为主要调节旋钮。
- Bucket C 多智能体协调（在 orchestrator 中执行）：包括异步长寿子智能体、按波次/角色设置 effort、拒答重路由契约（被标记的 Agent 返回 stop_reason: "refusal" 并重路由到 Opus 4.8）、在高 effort 下明确边界、不要过度重构。
模型与 effort 分层（成本原则）
原则是：让最贵模型做承载性推理（架构/契约设计、对抗性验证、最终综合、困难调试），把批量工作（文件转换、迁移编辑、格式化、样板、广泛研究抓取、初稿）交给同系列更便宜的层级。两个调节旋钮是 model（能通过质量门槛的最便宜层级）和 effort（低→最高）。输出 token 成本约为输入的 5 倍。资料强调提供者相对性：应停留在单一提供者内，默认 Anthropic 原生，阶梯为 Haiku → Sonnet → Opus → Fable；FreeLLMAPI 是唯一多提供者例外。
资料给出任务到层级的映射：机械/高量任务用 Haiku 或需要轻推理时用 Sonnet，effort 低/中；标准实现用 Sonnet，medium/high；承载性推理用 Opus 或 Fable，high/xhigh（仅当正确性远重于成本时用 max）。另提出优化器/目标分离：由强模型创作/优化/审查产物，由便宜模型执行/验证。护栏包括：Haiku 4.5 不支持 effort 参数（API 返回 400）；不要反射式用 max；每次 Agent/Workflow 生成都显式传 model 和 effort，避免子智能体模型默认值过期；简洁不等于抑制推理。
图像代理模型白名单
use-pxpipe 在会话前放置图像代理，将请求中体积大、重复发送的部分渲染为密集 PNG，因为图像 token 按像素面积计价。该方案仅在背后模型能正确读取渲染时有效；误读密集字形不会报错，而会产生自信的错误答案。因此白名单在本技能中统一治理并采用 fail-closed：只有白名单模型可置于图像代理之后，未列出或新发布的模型默认不允许；模型需通过 pxpipe 约 20 次调用的字形扫描才能获得资格，每次模型发布都需重跑。该轴与分层阶梯独立：一个模型可能适合作为执行层级，但仍被禁止用于代理。
能力交接
当更强模型即将离开方案，或希望便宜模型以强模型的纪律运行时，可从强模型提取“操作手册”作为便宜模型的系统提示。资料限定：手册移植的是纪律而非能力。相关脚本 scripts/extract_operating_manual.py、已提取手册 references/operating-manual.md，以及拒答/继续/框架三项加固和修正后的成本说明位于 references/capability-handoff.md。
适用场景与限制
适用场景：新 Claude 模型发布后的提示词/技能迁移审计、长时自主 Agent 的脚手架调整、多智能体编排中的 effort 与拒答重路由配置、成本优化中的模型/effort 分层、图像代理启用前的模型资格检查。
限制：该技能仅提供指导与审计，不构建产物；模型事实与价格会随代际变化，需要更新景观表和参考文件；部分细节（如具体模型 ID、$/1M、当前白名单及读取率）在参考文件中，资料未在正文完整列出。