启用trae全局质量规范需在设置中编辑全局提示词模板,将四条硬性约束置于顶部;支持按项目类型通过资源标签或jira id动态加载质量提示词;生成后可用自检指令识别并修复代码缺陷。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

用Trae生成代码时,不设质量锚点会导致函数命名随意、异常未捕获、日志缺失、边界条件遗漏,最终产出的代码无法直接进CI流水线,必须人工逐行重写。
在Trae中启用全局代码质量规范
打开Trae左下角「设置」→「AI模型与规则」→「全局提示词模板」→点击「编辑」按钮。
将以下四条硬性约束粘贴到文本框顶部,【必须放在所有其他指令之前,且不能换行】:
“你是一名Senior SRE,所有代码输出必须满足:① 函数名用snake_case且含动词前缀(如validate_input、fetch_from_cache);② 每个HTTP请求必须包裹try/except并记录error level日志;③ 所有字符串拼接使用.format()或f-string,禁用+连接;④ 任何数值输入必须做type check和范围校验,超出则raise ValueError。”
保存后,该规则将自动注入每一次代码生成请求——无需每次重复声明。
按项目类型动态加载质量提示词
方法一:通过资源标签调用预置规范
在Trae左侧资源栏点击「+新建资源」→选择「文本片段」→粘贴如下内容并命名为「backend_py_quality_v3」:
“Python后端服务代码需满足:1. 使用pydantic.BaseModel定义DTO,字段带default=None或Field(default_factory=list);2. 路由函数必须标注@router.post('/v1/xxx')且含summary和description;3. 数据库操作统一用asyncpg,禁止同步调用;4. 所有敏感字段(password/token)在log中打码为'***'。”
后续写提示词时,只需写:“调用资源@backend_py_quality_v3,生成用户注册接口实现。”
方法二:用Jira ID绑定质量上下文
在提示词末尾追加:“本需求关联Jira ID PROJ-9102,该任务已通过Arch Review,要求:① 必须兼容OpenTelemetry trace_id注入;② 所有API响应头必须含X-Request-ID;③ 禁用print(),只允许logger.info()/error()。”
【Jira ID必须真实存在且已关联技术评审结论,否则Trae会忽略该约束】
让Trae自检代码质量缺陷
第一步:生成原始代码后,在对话框中输入:
“请基于PEP 8、Bandit安全扫描规则、以及你刚生成的代码上下文,逐条指出3处可立即修复的质量问题,并给出修改后代码片段。”
第二步:拿到反馈后,复制其中一条问题描述(如“第12行硬编码密码,应从os.getenv('DB_PASS')读取”),在新对话中输入:
“修复该问题:把DB_PASS从环境变量读取,若未设置则raise RuntimeError('Missing DB_PASS in env')。”
第三步:Trae会返回修正后的完整函数块,注意检查它是否同步更新了import语句——【若未自动补上import os,则说明质量校验未穿透到依赖层,需手动添加】。











