需将脚本说明提示词固化为可复用流程，锁定5项不可替换骨架（3字段+2术语+1禁用表述），构建三层模板（角色/输入/输出），注入风格锚点，并通过快筛、反向验证、模板更新闭环迭代。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让Kimi每次生成的脚本说明都保持结构统一、术语一致、可直接嵌入工程文档，又不用每次重写提示词、反复调整句式、手动对齐开发规范，就得把脚本说明提示词固化为可复用流程。
锁定脚本说明的核心要素
打开你最近三次让Kimi生成脚本说明的对话记录，逐条标出：每份说明里必出现的3个字段（如“输入参数”“异常处理路径”“调用示例”）、你习惯用的2个术语（如不用“报错”而用“抛出异常”、不用“返回值”而用“输出契约”）、以及你从不接受的1种表述（如拒绝出现“建议”“可以”等情态动词）。这五项就是你脚本说明的不可替换骨架。
【不做这一步，Kimi会按通用技术文档逻辑生成，比如写‘建议检查输入格式’，而你要的是‘校验失败时抛出ValueError，message含字段名与非法值’】
构建三层提示词模板
新建一个名为“Kimi脚本说明-主干”的文本文件，写入以下固定结构：
【角色指令】你是一位Python工程文档工程师，专为内部交付脚本编写可直接插入README的技术说明，熟悉PEP 257与Google Python Style Guide，拒绝任何解释性文字或教学口吻。
【输入约束】我将提供：① 脚本功能一句话描述（如“从CSV提取用户邮箱并去重”）、② 原始代码片段（含函数签名与关键逻辑）、③ 你刚锁定的5项核心要素清单（字段/术语/禁用词）。
【输出要求】只返回纯文本说明，严格按顺序包含：功能摘要→输入参数（含类型、是否必填、默认值）→输出契约（含返回类型、成功/异常情形）→调用示例（真实可运行代码，含注释说明每行作用）→异常处理路径（用“→”串联触发条件与动作，如“空文件→抛出FileNotFoundError→中止执行”）。禁用所有列表符号、Markdown格式、空行分隔。
注入风格锚点与否定指令
方法一：提供参考样本
在Kimi对话框中粘贴你过往最满意的一份脚本说明，例如：
“功能：解析JSON日志并提取error_level≥3的记录。输入参数：log_path(str, 必填)，threshold(int, 默认3)。输出契约：返回list[dict]，每项含timestamp、level、msg；无匹配记录时返回空列表；JSON解析失败时抛出json.JSONDecodeError。调用示例：records = parse_logs('app.log', threshold=4) # 指定阈值为4。异常处理路径：文件不存在→抛出FileNotFoundError→中止执行→不尝试创建空文件。”
监控Kimi K2.5 API使用量和配额。通过Kimi控制台实现：(1)查看剩余使用百分比和重置计时器；(2)根据可用配额自主决策任务优先级；(3)密集操作前监控速率限制；(4)记录使用模式以支持资源规划。适用于配额约束下的自主智能体。
然后紧跟一句：“请严格按此粒度、术语和句式生成新说明。”
方法二：追加风格强化指令
若Kimi初稿仍出现“可选参数”“通常返回”等模糊表述，立即补发指令：【删掉所有‘可’‘能’‘一般’‘建议’字眼；把‘可选参数’改为‘非必填参数’；把‘通常返回’改为‘仅当X成立时返回Y’；每句结尾不加句号】
建立校验与迭代闭环
第一步：人工快筛
拿到Kimi输出后，立刻扫视三处：输入参数是否全带类型标注？异常路径是否用“→”明确串联？调用示例是否含真实变量名与注释？任一缺失，整份作废，退回检查输入约束是否漏传了术语清单。
第二步：反向验证
挑出其中一条“异常处理路径”，如“字段缺失→抛出KeyError→打印原始键名”，把它倒喂给Kimi：“根据这句话反推原始脚本中可能缺失的字段名及对应数据结构。”若它还原出“user_data字典缺少email键”，而你实际代码里是“payload中无contact字段”，说明主干模板中“异常处理路径”定义存在歧义，需修改为“字段缺失→抛出KeyError→错误信息含缺失键名与所属容器名”。
第三步：更新主干模板
将校验中暴露出的歧义点，直接改写进“Kimi脚本说明-主干”文件对应段落，覆盖原内容。不新增备注，不保留旧版本，确保该文件永远是最新可执行单点。
