必须使用 M2.7 模型启用结构化输出模式，因为它支持 Clean Architecture 四层目录拆分、确定性结构契约、Code Linter 自动重构，以及 Team Engine 角色隔离；而 H3 或更低版本的 M2 模型无法满足这些代码结构优化需求。

你需要让 MiniMax Agent 生成的代码具备清晰的模块划分、易读的函数命名和明确的职责边界，而不是把所有逻辑堆在一个文件中，或写成层层嵌套、难以维护的代码块。

用 M2.7 模型启用结构化输出模式

MiniMax Agent 默认使用的是 H3 或 M2 系列模型，但真正原生支持“结构化技能编排”的只有 M2.7。这个模型会在生成内容前先自动判断任务复杂度，再决定是否触发分层输出协议。操作方式很简单：打开 Agent 设置 → 选择模型 → 切换为 【M2.7】。如果这一步没有完成，后续所有关于结构化代码生成的指令基本都会以降级模式执行。

这一步不能省略：H3 虽然支持 JSON 输出，但并不会强制约束代码组织结构；M2.7 则会在生成 Python 或 TypeScript 代码时，默认按照 domain→service→dto→utils 四层目录结构展开，并为每个文件自动补充清晰的 docstring 与 type hint。

在 prompt 中嵌入结构契约（Structure Contract）

直接告诉 Agent 你期望的代码骨架，比让它“自行判断”更稳定可靠。结构契约不是普通模板，而是带有明确约束条件的声明式指令。

方法一：用关键词锚定层级

在需求描述后追加一句：“请按 Clean Architecture 分层，domain 层不依赖任何外部库，service 层只调用 domain 接口，infra 层封装 HTTP/DB 实现。”

方法二：指定文件粒度

这里要明确最终产出，共 4 个文件：user_domain.py（包含 User、Role 类）、auth_service.py（包含 AuthService 类）、http_adapter.py（包含 FastAPI 路由），以及 test_auth.py（包含 pytest 测试用例）。

【注意】不要写“尽量分层”或“最好有注释”——M2.7 对模糊副词的响应非常弱，必须使用“请按……”“生成……个文件”“含……类”等确定性动词，才能提升结构化输出的准确性。

启用 MCP 工具链中的 Code Linter Skill

第一步：进入 MiniMax Agent 桌面端 → 点击左下角「Skills」→ 搜索并启用 Code Linter 技能。

第二步：提交代码生成任务后，Agent 会自动在输出末尾附加 lint 结果报告，标出以下问题：函数长度超过 50 行、参数未添加类型标注、重复 import、public 方法缺少 docstring。

第三步：点击报告中的「Fix & Rebuild」按钮，Agent 会基于原始意图对代码进行重构，把长函数拆分为 validate_input()、fetch_user_data()、apply_business_rules() 三个独立函数，同时补全 typing 和测试桩。

这一步操作非常直接，点击按钮即可，但前提是 Code Linter 必须提前开启——如果处于关闭状态，Agent 不会执行任何代码结构校验或自动重构。

用 Team Engine 强制角色分离

第一步：在任务输入框顶部点击「Ma vis Mode」开关，启用多 Agent 协作模式。

第二步：输入需求时明确分配职责：

① Leader Agent 负责整体架构设计，输出模块关系图与接口契约；

② Domain Worker 专门编写 entity、value object、repository interface；

③ Infra Worker 只负责实现 repository concrete class 和第三方 SDK 封装；

④ Verifier Worker 对比 domain 层与 infra 层的接口签名一致性，一旦发现不匹配立即中断流程。

这种分工并非模拟，而是由 Team Engine 底层 runtime 进行真实调度——在 Domain Worker 的代码沙箱中，根本看不到 requests 或 sqlalchemy 包，从源头上避免“业务逻辑混入 SQL”的问题，让代码结构更清晰、职责更明确。