关键在于用skill封装不可变流程逻辑：1. 创建.trae/skills/your-process-skill文件夹；2. 新建skill.md；3. 用yaml frontmatter声明触发条件；4. 用带序号列表写死步骤；5. 添加禁止自由发挥等硬性约束。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
让AI在Trae中严格按你设定的步骤执行任务，而不是自由发挥或跳步漏步，关键在于用Skill封装不可变的流程逻辑。这一步做错，AI就会凭经验“补全”你没写的环节，导致结果偏离预期。
创建带明确步骤顺序的Skill
第一步：在项目根目录下创建.trae/skills/your-process-skill文件夹（注意路径必须全小写、无空格、无中文）。
第二步：在该文件夹内新建一个名为【SKILL.md】的文件（文件名必须全大写，大小写错误将导致Trae完全无法识别）。
第三步：用YAML frontmatter声明触发条件，例如：
---<br>name: api-doc-gen<br>description: 生成符合公司模板的API文档。当用户说“生成API文档”“导出接口说明”时触发。<br>---
第四步：在frontmatter下方，用带序号的Markdown列表写死每一步动作，AI会严格按数字顺序执行：
1. 先定位当前项目中的openapi.yaml或swagger.json文件；
2. 若文件不存在，立即停止并提示“未找到OpenAPI定义文件，请先提供”；
3. 解析该文件，提取所有paths和components.schemas；
4. 按照./templates/api-doc-template.md填充内容，保留原始缩进与空行；
5. 将结果保存为docs/API_REFERENCE.md，不覆盖已有同名文件，而是追加时间戳后缀。
用自然语言指令强制绑定流程
方法一：在SKILL.md正文里禁用AI自由联想
在步骤描述开头明确写：“【禁止自行补充步骤、禁止跳过任意一条、禁止改写模板结构】”。这句话会被AI作为硬性约束加载，比单纯列步骤更防幻觉。
方法二：用“→”串联强依赖操作链
例如：“读取config.yml→提取base_url字段→拼接/health路径→发起GET请求→校验HTTP状态码是否为200→若失败则终止并返回错误详情”。这种写法让AI感知到前后动作存在不可拆解的因果关系。
验证流程是否被严格执行
在Trae对话框中输入触发词（如“生成API文档”），观察AI响应：
若它先问“你想用哪个OpenAPI文件？”，说明步骤2的“若文件不存在立即停止”未生效——检查SKILL.md中是否漏写了“立即停止并提示……”这句指令；
若它直接开始写文档却跳过了schema解析环节，说明步骤3未被识别为必执行项——回到SKILL.md，把“解析该文件”改为“必须完整解析paths和components.schemas两个区块，缺一不可”；
若生成的文档格式与模板明显不同（比如标题层级错乱），说明步骤4的模板路径写错了——确认./templates/api-doc-template.md真实存在于项目根目录下，且路径大小写完全匹配。
