Trae生成组件文档时必须严格基于用户上传的参考资料,禁止调用外部知识;需按固定顺序输出组件名称、Props表、Events表、Slots表及完整示例代码;所有内容须逐字解析、不增不减,并通过页码或章节号标注注意事项来源。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要让Trae在生成组件文档时精准引用你提供的参考资料,而不是凭空编造API说明或示例——这要求提示词必须明确约束AI的输入源、提取范围和输出格式,否则它会默认调用内置知识库,导致文档与你的实际代码脱节。
把参考资料作为唯一信息源
打开Trae Solo模式 → 新建一个空白对话窗口 → 输入以下提示词(注意保留换行和标点):
你是一名前端文档工程师,正在为一个Vue3组件库编写官方文档。所有内容必须严格基于我提供的参考资料,【禁止使用任何外部知识或假设】。参考资料已全部上传至当前对话上下文,请逐字解析PDF/MD文件中的接口定义、参数表格、示例代码块及注意事项段落,不增不减、不改类型、不补默认值。
这一步操作起来很简单,直接把参考文献PDF拖进对话框就行,但必须在输入提示词前完成上传,否则Trae无法感知文件存在。
强制结构化提取字段
在上一步提示词末尾追加以下指令:
请按固定顺序输出:① 组件名称(取自参考资料首行标题);② Props表(列名:参数名|类型|必填|默认值|说明,仅保留参考资料中明确写出的内容,缺失项写“未说明”);③ Events表(同Props格式);④ Slots表(同Props格式);⑤ 完整示例代码(直接复制参考资料中@example区块的原始代码,不加注释、不改缩进、不补缺失标签)。
如果不加这条结构化指令,Trae大概率会把Props揉进一段描述性文字里,导致开发者无法快速扫描关键参数。你给的参考资料里明明有现成的Markdown表格,它却偏要重写成段落,这就是缺乏字段级约束的结果。
屏蔽干扰信息的三种写法
方法一:用否定式封堵常见幻觉
在提示词中插入:“若参考资料未提及‘兼容性’‘性能指标’‘历史版本差异’等内容,则跳过该章节,不自行补充。”
方法二:用引用锚点绑定原文位置
写明:“所有‘注意事项’内容必须标注来源页码或章节号,例如‘(见P12第3.2节)’,未标注出处的句子视为无效输出。”
方法三:用校验指令反向控制
结尾追加:“输出完成后,检查每一行是否能在参考资料中找到对应原文片段。如有任意一行无法匹配,请重新生成并高亮标出可疑内容。”
这三种写法选其一即可,其中方法二对PDF类资料最有效——因为Trae能识别PDF中的章节标记,但无法自动关联页码,必须靠你明示“见P12”才能触发精准定位。


















