如果你想在MiniMax Agent 中让生成的代码自动补齐规范注释，首先需要把几个关键设置明确下来：采用哪一种注释风格，例如 JSDoc 或 Google Python Style；注释使用中文还是英文；以及注释需要覆盖到哪些代码范围。若这些内容没有提前配置，系统默认通常不会生成函数级注释；一旦风格选择错误，输出的注释格式也很容易直接偏离标准。进一步来说，注释的详细程度可以通过全局设置、prompt 提示词，或 system 指令进行控制；而要确保这些规则真正生效，还需要检查注释起始标记是否正确、参数说明是否逐一对应，以及 IDE 最终能否正常识别这些代码注释。

在 MiniMax Agent 中为生成的代码自动添加规范注释时，必须明确指定注释风格、语言偏好以及作用域范围，否则生成结果可能完全没有注释，或只包含笼统、不符合规范的说明。

设置全局注释模板

打开 Agent 控制台后，先点击右上角头像，进入「Settings」，再找到「Code Generation」模块；随后在「Comment Style」下拉菜单中，根据项目类型选择对应格式：JavaScript/TypeScript 项目选择「JSDoc」，Python 项目选择「Google Python Style」。

这一步必须优先完成，【未设置注释风格时，Agent 默认通常不会生成任何函数级注释】。如果选错风格，例如给 Python 代码配置 JSDoc，不仅会造成注释格式不规范，还可能导致 IDE 无法正确识别代码文档。

为单次调用指定注释深度

方法一：在 prompt 中显式说明
输入需求时，可在代码请求后补充一句：“请为每个函数添加完整的 JSDoc 注释，包含 @param、@returns 和 @throws。”

方法二：使用系统指令前缀
在消息开头加入：system: 注释级别=函数级+行内关键逻辑说明。该指令会覆盖全局设置，并优先生效。

方法三：禁用注释（仅用于调试）
当你需要对比原始代码逻辑时，可以写：“输出纯代码，不要任何注释、空行或解释性文字。” Agent 会严格移除所有注释块和文档字符串。

强制注释生效的三步校验

第一步：提交代码生成请求后，立即检查返回内容首行是否包含/**或"""等注释起始标记；

第二步：随机打开一个函数，确认参数名与注释中的 @param 字段完全一致——如果出现 @param x，但函数签名实际是 def func(a, b)，就说明注释没有正确绑定真实参数；

第三步：复制一段带注释的代码到 VS Code 中，启用 Pylance 或 ESLint 插件，观察是否触发“Missing docstring”警告——【没有警告，才说明注释已被正确识别】。