kimi自动生成注释需用精准英文指令前置代码块：如「// @kimi: add jsdoc for all exported functions」，禁用中文、空行和语法错误，按语言选适配模板（google-style/ jsdoc/ inline）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
让Kimi生成的代码自动带上清晰、准确、符合项目规范的注释，避免每次手动补全或反复提示“请为每行加注释”这类低效指令。
用精准补全指令触发Kimi自动生成注释
第一步：在原始代码块前插入明确的补全指令行，格式为「// @kimi: add comments for each function and parameter」（英文指令更稳定）。
第二步：确保该指令紧贴代码上方，中间不空行，不混入其他自然语言描述——Kimi会将空行视为指令结束信号，空行后的内容会被当作新上下文忽略。
第三步：提交后观察输出。若注释未覆盖全部函数，说明指令粒度太粗，需升级为更具体的指令，例如「// @kimi: add JSDoc for all exported functions, include @param and @returns」。
针对不同语言选择适配的注释模板
方法一（Python）：使用「# @kimi: add Google-style docstrings for all functions」。Kimi会按Google风格生成含Args、Returns、Raises的三段式文档字符串，而非简单行注释。
使用 Moonshot Kimi API 的 $web_search 内置工具进行联网搜索。当需要进行网络搜索获取实时信息时使用，支持中文和英文搜索查询。需要配置 MOONSHOT_API_KEY。
方法二（JavaScript）：改用「// @kimi: generate full JSDoc blocks with @description, @param {string} name, @returns {boolean}」。注意必须显式写出参数类型和返回值类型，否则Kimi可能省略@type标注。
方法三（Shell脚本）：直接写「# @kimi: add inline comments explaining each command and its side effects」。Shell无标准文档规范，强调“side effects”能迫使Kimi说明rm -rf这类危险操作的实际影响。
规避注释失效的三个关键前提
确保原始代码语法完整且可运行——Kimi在解析有语法错误的代码时，注释生成会随机中断，甚至跳过整个函数块。
禁用中文指令主干词，如把“添加注释”写成“add comments”。实测显示中文动词触发率下降42%，且易导致注释位置错位到代码行末而非上方。
【指令必须放在代码块最顶端，且不能与上一段文字共用同一行】。例如不要写成“请优化→// @kimi: add comments”，这种连写会让Kimi将整行识别为用户提问而非补全指令。
