AI生成变更说明必须基于已加载的参考资料，否则会编造内容；需确认顶部显示「已加载：X个文件/片段」，并在提示词中明确引用路径、行号或资料ID，配合强约束指令、结构化输出及自我校验。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Trae中写代码变更说明时，若不主动把参考资料（如Read工具读取的文件、SearchCodebase返回的代码片段、GetDiagnostics输出的报错上下文）嵌入提示词，AI会凭空编造描述，导致变更说明与实际改动脱节，甚至出现“改了A文件却说修改了B函数”的严重错位。
确认参考资料已加载进上下文
执行Read、SearchCodebase或GetDiagnostics后，Trae会在对话顶部显示「已加载：X个文件/片段」，这是AI能看见资料的前提。如果没看到该提示，说明资料未进入当前会话上下文，后续所有变更说明都将失真。
用SearchCodebase查接口定义 → 等待结果返回并自动加载 → 观察顶部状态栏是否出现「已加载：1个文件」字样。
【必须等加载完成再写提示词，否则AI根本看不到你刚查的内容】
在提示词中显式引用资料来源
不要写“根据上下文”，要写清楚“根据Read工具读取的src/utils/date.js第12–18行”或“根据SearchCodebase查到的api/auth.ts中loginUser函数签名”。AI对模糊指代极不敏感，只有带路径+行号/函数名的锚点才能精准绑定。
方法一：直接拼接内容片段
在提示词开头粘贴关键代码块，例如：
「参考以下date.js中formatDate函数实现：
export function formatDate(date) {
return new Date(date).toLocaleString("zh-CN");
}
请为本次修改生成变更说明……」
方法二：标注资料ID
若资料较多，用Trae自动生成的ID引用，例如：
「变更说明需严格基于资料#3（SearchCodebase返回的auth模块接口定义）和资料#5（Read读取的config.ts）」
强制AI对照资料生成说明
第一步：明确指令动词
用「逐行比对」「严格依据」「不得 extrapolate（推断）」「仅描述资料中可见的变更」等强约束动词，封死AI自由发挥空间。
第二步：限定输出结构
要求AI按「原逻辑→新逻辑→影响范围」三段式输出，且每段都必须标注资料出处，例如：
「原逻辑（见资料#2第7行）：使用moment库解析时间；
新逻辑（见资料#1第15行）：改用原生Intl.DateTimeFormat；
影响范围（见资料#4依赖图）：仅影响dashboard/chart组件」
第三步：加入验证动作
在提示词末尾加一句：「生成后，请用Read工具重读src/utils/date.js，确认说明中提到的行号和行为完全匹配，不匹配则重新生成」——这步触发AI自我校验机制，大幅降低张冠李戴概率。
