用python写一个名为calculate_tax的函数；price：商品价格（float，单位为元）；tax_rate：税率（float，0.0～0.2之间的小数）；不处理负价，遇到price
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
让智谱清言为你生成清晰、准确、符合工程规范的代码注释，需明确说明语言环境、函数用途、参数含义与边界条件，避免笼统描述“处理数据”或“返回结果”这类无效表达。
基础注释提示词结构
第一步：在提示词开头直接声明编程语言和函数名，例如：“用Python写一个名为calculate_tax的函数”。
第二步：用分号或换行明确列出该函数的输入参数、每个参数的数据类型和业务含义；例如：“price：商品价格（float，单位为元）；tax_rate：税率（float，0.0～0.2之间的小数）”。
第三步：说明函数核心逻辑的关键约束，如“不处理负价，遇到price 第四步：要求注释必须包含三段式结构——功能概述、参数说明（含类型）、返回值说明（含类型），且全部使用中文，不混入英文术语（如“input”“output”）。【若漏写参数类型或错误处理条件，生成的注释将缺失关键防御性说明】
增强可维护性的提示词技巧
方法一：加入典型调用示例。在提示词末尾追加一句：“并在注释末尾用‘Example:’引出一个真实可运行的调用样例，如calculate_tax(100.0, 0.08) → 8.0”。这能迫使模型理解上下文语义，避免注释脱离实际用法。
方法二：限定注释风格。加上“采用Google Python Style Guide格式，用Args:、Returns:、Raises:三级标题分隔”，模型会严格对齐字段，不会把异常说明塞进Returns里。
方法三：禁止模糊动词。在提示词中强调“禁用‘进行’‘实现’‘完成’等空泛动词，改用‘校验’‘截断’‘四舍五入到小数点后两位’等可验证动作”。
规避常见失效场景
直接说“给这段代码加注释”大概率失败——智谱清言无法读取你本地文件或剪贴板内容。必须把完整函数体粘贴进提示词，并用```python```包裹。
不要写“尽量简洁”，它会过度删减必要信息；要写“每项参数说明不少于10字，且必须指出单位或取值范围”。
若函数含全局状态依赖（如修改了模块级变量），必须在提示词中显式指出：“该函数会更新全局计数器global_call_count”，否则注释绝不会提及副作用。
