为什么 APC Agent 应该默认使用 model: inherit
APC agent 文件在保持轻量且易于移植时效果最佳。
最好的默认设置是使用 model: inherit。只有在项目确实需要时,才使用特定的模型。这条规则能保持文件的整洁。代码仓库承载项目契约,而运行时(runtime)负责选择模型。
APC agent 是 agent 文件中的一个角色 (persona)。它定义了名称、角色和技能。它不应该硬编码整个运行时栈,也不应该强制将某个供应商设为默认。它负责描述角色,并将执行交给运行时。
为什么 model: inherit 更好:
- 可移植性:你今天可能在使用 APX,明天可能就在用 Cursor 或 Claude Code。继承机制允许 agent 在所有工具中通用。
- 减少噪音:在每个文件中硬编码模型会造成杂乱。
- 更好的解耦:APC 定义 agent “是什么”,而运行时定义它“如何运行”。
- 更简单的配置:团队成员可以克隆你的仓库并立即运行,无需修改 agent 文件。
何时使用特定模型:
只有在项目依赖于特定供应商和模型 ID 时才使用它们。例如:
- 用于简单摘要的小型本地模型。
- 针对特定工具使用场景 (tool-use profiles) 的特定模型。
- 用于测试夹具 (test fixtures) 的可预测引擎。
在固定 (pin) 模型之前,请进行以下测试:
- 该模型是否属于项目契约的一部分?如果是,请固定它。
- 该模型是否仅仅是本地运行时的选择?如果是,请使用
model: inherit。 - 该值是否属于机密或特定于机器?请将其保留在你的运行时配置中。
描述 agent,而不是描述机器。这能让你的 agent 文件保持实用性,而不是变得难以迁移。
Source: https://dev.to/agentprojectcontext/why-apc-agents-should-default-to-model-inherit-1jih
Optional learning community: https://t.me/GyaanSetuAi