Trae CN 完整版 Skill 脚手架含全部可选子目录适配Trae CN 国内版 | 包含主技能文件 scripts脚本目录 references参考目录 assets模板目录特性完全官方规范、可直接生效、可自定义扩展、适配懒加载运行机制一、完整标准目录结构最终成品放置位置项目级推荐项目根目录/\.trae/skills/你的技能名/your-skill-name/ ├── SKILL.md # 【核心必选】技能主规则文件 ├── scripts/ # 【可选】可执行脚本目录 │ └── tool_helper.py # 示例Python工具脚本 ├── references/ # 【可选】参考规范、文档、标准 │ └── rule_spec.md # 示例技能依赖规范文档 └── assets/ # 【可选】模板、示例、固定输出模板 └── output_template.md # 示例统一输出结果模板二、核心文件SKILL.md完整版规范模板路径your\-skill\-name/SKILL\.mdTrae CN 唯一识别主文件--- name: your-skill-name description: 在这里写技能核心能力一句话精准概括用于AI语义匹配触发 globs: [**/*.py, **/*.js, **/*.ts, **/*.vue] version: 1.0.0 author: custom --- # 技能中文名称 ## 适用场景 When - 明确列出本技能的触发场景 - 精准、具体、不模糊 - 对应日常开发高频需求场景 ## 禁止场景 Not When - 不属于本技能处理的场景 - 避免技能误触发、错执行 - 一次性临时调试、无规范需求的任务不处理 ## 前置依赖 Precondition - 如需调用 scripts 脚本确保脚本文件存在可执行 - 如需参考规范优先读取 references 目录规范 - 如需固定格式优先套用 assets 模板 ## 执行步骤 Steps严格顺序、祈使句、无跳跃 1. 读取用户需求与当前项目文件上下文 2. 按需加载 references 参考规范约束执行逻辑 3. 按需调用 scripts 工具脚本进行数据处理、解析、校验 4. 按照标准逻辑完成核心任务处理 5. 套用 assets 输出模板格式化最终结果 6. 输出结果、给出优化建议、标注注意事项 ## 输出规范 Output 严格按照固定模板输出结构固定、格式统一 ### 执行结果 - 处理状态成功/待优化/存在问题 - 核心结论一句话总结结果 ### 详细内容 此处填充完整执行内容、代码、说明 ### 优化建议 针对性给出可落地的改进方案 ## 特殊规则 Rule 1. 本技能为懒加载触发仅语义匹配命中后加载全部规则 2. 优先使用目录内脚本与模板保证输出统一 3. 所有操作必须符合当前项目代码规范 4. 禁止输出模糊、无落地性的内容三、scripts/ 脚本目录示例通用工具脚本路径scripts/tool\_helper\.py用于 AI 自动调用、辅助处理逻辑、解析数据#!/usr/bin/env python3# Trae CN Skill 辅助工具脚本# 存放位置scripts/ 目录AI 可按需自动调用importsysimportjsondefskill_data_handler(input_data:str)-dict: 通用数据处理工具 可根据技能场景自定义解析、校验、格式化、统计数据 result{success:True,input_len:len(input_data),process_msg:脚本处理完成,data:input_data.strip()}returnresultif__name____main__:# 接收AI传入的参数输出结构化结果stdin_datasys.stdin.read()resskill_data_handler(stdin_data)print(json.dumps(res,ensure_asciiFalse,indent2))四、references/ 参考规范目录路径references/rule\_spec\.md存放技能执行依赖的规范、标准、约束、行业规则# 技能执行参考规范 ## 概述 本文档为当前 Skill 的执行约束标准AI 执行时必须严格遵守。 ## 代码规范约束 1. 代码必须具备可读性、可维护性 2. 必须补充必要注释复杂逻辑增加说明 3. 优先使用项目已有工具类、公共方法 ## 输出约束 1. 输出结构固定不可随意删减模块 2. 问题必须精准定位给出具体行号、原因、方案 3. 修复代码可直接复制运行无报错 ## 执行约束 1. 禁止过度修改原有业务逻辑 2. 优先兼容原有代码风格 3. 所有优化必须正向提升代码质量五、assets/ 模板资源目录路径assets/output\_template\.md固定输出模板保证每次 AI 输出格式统一、不乱飘# 技能执行结果模板 ## 执行状态 【成功/待优化/异常】 ## 核心总结 此处填写本次任务的核心结论、关键问题、核心成果 ## 详细处理内容 ### 问题/内容说明 ### 解决方案/成果展示 code ## 后续建议 1. 2. 3六、Trae CN 专属运行逻辑说明适配本结构1. 懒加载机制启动只加载 SKILL.md 头部元数据name/desc/globs触发命中后 → 加载完整 SKILL.md 规则需要脚本/规范/模板时 → 才加载 scripts / references / assets 内容极致省 Token2. 目录优先级规则优先读 SKILL.md工具优先读 scripts 脚本约束优先读 references 规范输出优先套用 assets 模板七、使用须知硬性规则所有目录按需启用不用可以直接删除文件夹不影响技能运行文件夹名固定scripts / references / assets 不可改名技能主文件必须是SKILL.md大小写严格技能名必须小写 中划线无中文、无大写注文档部分内容可能由 AI 生成
