用智谱 AI 写需求变更说明：从事实卡生成影响分析和待确认项

用智谱 AI 写需求变更说明时，先提供已确认事实，再让模型区分“当前状态、拟变更内容、影响、待确认决策”。这样得到的初稿才便于评审。把“客户希望增加功能”直接扩写成“项目已批准增加功能”，会改变文件含义。

本文演示智谱开放平台的文本对话 API，适合愿意运行一个简短 Python 脚本的项目人员。示例业务和输出均为虚构演示，没有进行付费模型调用，不代表真实项目审批结果。它不涉及智谱清言网页的附件或导出功能。

先准备一张事实卡

不要只输入“帮我写需求变更说明”。把已知事实、建议和未知事项分开，模型才能保留它们的状态。

文档：客户服务系统需求变更说明
原需求：客服可导出当前筛选范围内的工单清单。
当前状态：原功能已开发，尚未完成验收。
客户提出：增加导出字段“处理时长”。
已确认：字段定义尚未确定；没有新的审批记录。
初步影响：可能调整导出接口、字段说明和测试用例。
未知：是否包含暂停时间；历史数据如何计算；新增工期和费用。
读者：业务负责人、研发负责人、测试负责人。
目的：评审变更，不是宣布已经批准变更。

这张卡是演示输入。实际使用时，应把“已确认”对应到工单、需求记录或会议纪要；不要将尚未评估的工期写成确定承诺。

通过官方文本接口生成第一稿

先按官方快速开始注册开放平台账号、创建 API Key，并确认所选模型的调用权限与计费。API Key 与网站登录密码不同，正文生成可能产生调用费用。

1. 准备 Python 3 环境，新建一个工作目录。
2. 把上一节事实卡存成 UTF-8 的 facts.txt。
3. 将下面的脚本保存为 change_note.py，在该目录运行 python change_note.py。
4. 根据终端提示输入自己的 API Key；输入不会回显，不把密钥写进脚本。

GLM-4 官方说明提供文本模型及请求示例；当前对话补全接口的模型字段列出了 glm-4-flash-250414，以下采用该文本模型编码，不是推荐排名。若账号不能调用该模型，应先在平台确认可用模型，并按对应文档修改模型编码。

import getpass
import json
import urllib.request
from pathlib import Path

facts = Path("facts.txt").read_text(encoding="utf-8")
instruction = """依据事实卡写需求变更说明。输出：
1.原需求与当前状态；2.拟变更内容；3.可能影响；4.待确认决策。
逐条标识已确认、初步判断、待确认。
不新增日期、费用、工期、审批或验收结论。不要将提出变更写成批准变更。
事实卡：\n""" + facts
payload = {
    "model": "glm-4-flash-250414",
    "messages": [{"role": "user", "content": instruction}],
    "max_tokens": 1800,
    "stream": False
}
request = urllib.request.Request(
    "https://open.bigmodel.cn/api/paas/v4/chat/completions",
    data=json.dumps(payload, ensure_ascii=False).encode("utf-8"),
    headers={"Authorization": "Bearer " + getpass.getpass("API Key: "),
             "Content-Type": "application/json"},
    method="POST"
)
with urllib.request.urlopen(request, timeout=60) as response:
    result = json.load(response)
choice = result["choices"][0]
print("结束原因：", choice.get("finish_reason"))
Path("change_note.txt").write_text(choice["message"]["content"], encoding="utf-8")
print("已保存 change_note.txt，请对照事实卡复核。")

端点、messages、返回内容和 finish_reason 的含义可查官方对话补全文档。这里只生成文本，没有调用业务系统或提交审批。

一份可评审的输出应当怎样写

以下是人工编写的预期输出示意，不是模型实测结果：

原需求与状态：导出当前筛选范围内工单；原功能已开发、尚未验收。拟变更：客户提出新增“处理时长”字段，变更尚未批准。可能影响：导出接口、字段说明和测试用例可能需要调整。待确认：暂停时间是否计入、历史数据计算规则、研发评估工期与费用、变更审批责任人。

这里把接口和测试调整写为“可能影响”，没有凭空断言必须重构或增加几天开发时间。缺失的审批责任人仍是待确认项。

逐项核对，而不是只看文字是否顺畅

• 检查原状态仍是“未验收”，不能变成“已上线”。
• 检查“客户提出”仍是提议，不能变成“双方已同意”。
• 检查暂停时间、历史计算、工期、费用四个未知事项是否都保留。
• 对每项影响，确认有事实依据或标成初步判断；删除无依据的收益数字。

如果新稿出现确定工期、费用或批准结论，停止流转该稿；把对应句子与事实卡一起重新提交，要求删掉无来源承诺，再由负责人评审。

接口返回 length 时可能已截断，先缩短输入或分节生成，不能把残缺文件当完整说明。认证、余额或模型权限错误应先在开放平台核对；网络超时后先确认调用记录，避免反复发送相同长材料。

评审后的文件怎样更新

审批结果产生后，把批准范围、时间、责任人和证据编号加入新事实卡，再生成更新稿。保留上一版和审批依据，以便看清哪些是原始事实、哪些是后续决策。AI 草稿本身不能作为变更已经批准的依据。